 Atenção: | Não edite o arquivoLocalSettings.php com editores de documentos como o Bloco de Notas (no Windows 10, versão 1809 ou anterior), TextEdit, ou qualquer outro editor de texto que adicionemarcas de ordem debytes aos arquivos. Eles interrompem o tempo de execução do PHP de sua wiki. Em vez disso, utilize editores de código como oVim ou oNotepad++. Eles lidam com codificações de arquivo corretamente. Esses editores podem também ser utilizados para reparar arquivos previamente danificados por editores de documentos. |
| Arquivo do MediaWiki: LocalSettings.php | |
|---|---|
| Localização: | / |
| Código-fonte: | não está no Git (criado durante a instalação) |
| Classes: | |
O arquivoLocalSettings.php fornece asdefinições de configuração básicas de uma instalação doMediaWiki.Reserve um tempo para inteirar-se nas definições deste arquivo.O arquivo geralmente é gerado pelo instalador do MediaWiki baseado naweb, mas é possível ajustar seus parâmetros em conjunto com as configurações do Apache.Para instalações do MediaWiki configuradas comowiki farm, um arquivo chamadoCommonSettings.php pode ser usado.
O arquivoLocalSettings.php não é uma página wiki, e não é possível acessá-lo pelo seu navegadorweb.Em vez disso, é um arquivo no sistema de arquivos do servidor.Seu conteúdo é gerado durante a configuração inicial da wiki, e o arquivo resultante deve ser copiado ao servidor manualmente.O arquivo deve estar localizado na pasta dentro da qual o MediaWiki foi instalado, no mesmo nível hierárquico de pastas comoincludes/ eskins/ e arquivos comoapi.php.Se este arquivonão estiver lá, a wiki não funcionará — se a wikifunciona, significa que o arquivoestá lá.Se não souber onde ele está, insira um comando comofind / -iname LocalSettings.php -print em uma janela do terminal para localizá-lo.
(Utilizando o Vagrant? Veja tambémMediaWiki-Vagrant#MediaWiki_settings.)
O arquivoLocalSettings.php geralmente contém dados confidenciais, como credenciais do bancos de dados.Esses dadosnunca devem ser revelados ao público!Devido a uma falha de segurança em algum lugar do servidor, pode acontecer que outros usuários consigam visualizar o conteúdo dos arquivos.Para melhorar a segurança de seus dados, defina as permissões UNIX para este arquivo de acordo: O usuário do servidorweb deve ter acesso a este arquivo.Se esta for a mesma conta proprietária do arquivo, defina as permissões para600.Às vezes, o usuário do servidorwebnão é o proprietário do arquivo, mas está no grupo de usuários UNIX proprietários (owners).Neste caso, as permissões como640 devem funcionar bem. Para aumentar a segurança, restrinja as permissões o máximo possível.
Além disso, crie um usuário MySQL restrito a apenas o banco de dados usado pela wiki, e forneça as credenciais desse usuário noLocalSettings.php. Ainda é possível configurar o servidor do banco de dados para aceitar apenas conexões a partir do localhost — isso deve impedir o acesso a partir do exterior no caso das credenciais terem vazado.
See alsoManual:Securing database passwords for a method to move the sensitive parts ofLocalSettings.php to a different file in a different directory.
Ao editar oLocalSettings.php, certifique-se de salvá-lo na codificação correta novamente. Busque utilizar a codificação “ANSI como UTF-8” — ou seja, a codificação UTF-8 sem marcas de ordem debyte (BOM).
OLocalSettings.php contémcódigo PHP; principalmente na definição de variáveis e seus valores. Alterar uma configuração normalmente significa alterar o valor de uma variável PHP. As alterações entrarão em vigor imediatamente após salvar o arquivo novamente no servidor: não há necessidade de reiniciar nada manualmente. De qualquer forma, em alguns casos, pode ser necessário limpar ocache do seu navegador para poder ver as alterações feitas.
Os valorespadrão das definições de configuração estão definidos emincludes/MainConfigSchema.php,o qual não deve ser editado; se a variável desejada não estiver mencionada no seuLocalSettings.php, adicione uma linha ao arquivo e modifique-a de forma adequada.WithinLocalSettings.php you can add new lines at the end.
Dentro do arquivo também pode haver várias linhas, tais comorequire_once"$IP/extensions/ExtensionName.php"; orwfLoadExtension('ExtensionName' ), que fazem ligação a outrasextensões habilitadas na wiki.These lines enable the corresponding extension in the wiki.Estas extensões podem requerer a definição dos valores de mais variáveis noLocalSettings.php; verifique a documentação da extensão para obter mais instruções.
A sua versão doLocalSettings.php pode não terminar com uma tag de fechamento PHP?>. Isso é feito de propósito, uma vez que impede as pessoas de acidentalmente adicionar novas informaçõesapós esta tag. PHP funcionará muito bem sem a tag de fechamento.
Se você tem uma wiki em umserviço de hospedagem MediaWiki, você pode não ter acesso de gravação (talvez nem mesmo de acesso de leitura) para o arquivoLocalSettings.php (veja p.ex.[1]). A empresa de hospedagem wiki pode ou não estar disposta a fazer as mudanças que você deseja. Talvez ela queira manter a maioria das configurações do mesmo em todas as wikis da hospedagem wiki.
Consulte oíndice de configurações e os comentários incluídos nos arquivos de configurações para ajuda sobre o que todas as variáveis fazem. Uma breve listagem das variáveis mais importantes, bem como as características mais solicitadas, está colocada abaixo.
A variável$IP (install path) detém o caminho do arquivo local para a instalação base da sua wiki.Desde MediaWiki 1.18, o sistema configura $IP automaticamente.Definir$IP manualmente emLocalSettings.php não é mais necessário.$IP será o padrão para o diretório de trabalho atual e pode ser usado sem a necessidade de defini-la manualmente.Attempting to set$IP (orMW_INSTALL_PATH) inLocalSettings.php may produce unexpected results.
$wgSitename contém o nome da configuração da sua wiki. Este nome é incluído muitas vezes ao longo do sistema, como via MediaWiki: PageTitle. Por exemplo, o slogan da Wikipédia "Wikipédia, a enciclopédia livre." faz uso dessa configuração.
Algumas traduções da interface estão prontas para inflexão do nome do site.Você pode definir formas adequadas de palavras nas variáveis$wgGrammarForms (por exemplo, consulte a página de documentação$wgSitename).
$wgScriptPath é o prefixo do URL para acessar o script principal do MediaWiki que é a peça central da atuação do código do MediaWiki.Essa configuração deve corresponder àsconfigurações do Apache, especialmente se você estiver usando as regras dereescrita do Apache.
$wgServer contém a URL base do servidor, incluindo o protocolo, mas sem a barra final e sem o subdiretório, se houver. Quando o wiki é acessado a partir do host local em que é executado, de uma intranet ou da Internet, notificações por e-mail e algumas outras mensagens computadas geralmente são entregues com os diferentes URLs.
No MediaWiki 1,34,$wgServer deve ser definido em LocalSettings.php.Antes disso, o MediaWiki tentou detectar automaticamente o nome do servidor e$wgServer era opcional, para substituir a detecção automática.
Sewww.example.com é o endereço do servidor do seu wiki, como visto a partir da Internet, adicione uma linha da seguinte maneira:
$wgServer='http://www.example.com';
Apalavra mágica{{SERVER}} pode ser usada em páginas wiki; é igual ao valor de$wgServer; no entanto, em uma wiki, como as da família Wikimedia, onde são usadas URLs relativas, não vai expandir totalmente, por exemplo, aqui ele exibe //www.mediawiki.org, que pode nem ser clicado nem copiado e colado na barra de endereços como ele está.
You can also use a protocol relative URL as shown below.When using a protocol relative URL, be sure to set$wgCanonicalServer.$wgCanonicalServer is needed for some places in the code where an origin with a protocol and hostname is needed.
$wgServer='//www.example.com';$wgCanonicalServer='https://www.example.com';
$wgScript é o nome do script PHP principal (índice) do MediaWiki, chamadoindex.php por padrão. Alterar o nome do script provavelmente não é uma boa idéia. No entanto, se você sentir vontade de fazê-lo, este é o lugar para fazer as alterações. Certifique-se de que você sabe o que está fazendo.
$wgArticlePath é o caminho a ser usado ao acessar uma página no MediaWiki.O caminho deve conter o caminho para o script principal (geralmente fazendo uso do$wgScript) e utilizar o espaço reservado$1 para o nome do artigo.
Se você estiver usando regras de reescrita do Apache para criar bonitas e curtas URLs, você provavelmente precisará ajustar$wgArticlePath para abordar o caminho certo.Observe que o wgArticlePath é usado para construir URLs a partir do MediaWiki.Se você cometer um erro aqui, links internos aparecerão de forma incorreta, enquanto você ainda puder acessar a página principal, especificando a URL correta manualmente.VejaManual:URL curto para mais informações sobre configuração de URL.
Os valores típicos são:
"$wgScript/$1" | passa o nome do artigo com o separador "/" |
"$wgScript?title=$1" | passa o nome do artigo como um parâmetro (estilo antigo) |
"/mypath/$1" | caminho personalizado. Use as regras de reescrita do Apache para converter "mypath" para o caminho correto acessando o script principal |
Use$wgStylePath para definir o caminho da URL para o local onde as folhas de estilo (CSS) para a instalação do MediaWiki estão localizadas.$wgStyleDirectory deve apontar para o mesmo lugar, mas observe que este é um caminho do sistema de arquivos local para uso em scripts internos que acessam o sistema de arquivos.
O diretório de upload é o local onde os arquivos enviados pelos usuários são armazenados. A variável[[$wgUploadPath|$wgUploadPath]] especifica a URL, enquanto a variável[[$wgUploadDirectory|$wgUploadDirectory]] aponta para o caminho do sistema de arquivos local.
A variável$wgLogos especifica qual o logotipo gráfico é exibido no canto superior esquerdo de todas as páginas do MediaWiki. Estes passos substituirão o logotipo padrão no diretório /wiki/skins/common/images/, substituindo /wiki com o caminho para o diretório onde você instalou o software MediaWiki.
SeeManual:Perguntas frequentes for how to change the logo.
A variável$wgEmergencyContact é o endereço de e-mail do usuário para entrar em contato quando as coisas acontecem. Este endereço de e-mail é usado para enviar relatórios de erros internos. Como administrador, você pode incluir o seu endereço de e-mail aqui.
A variável$wgPasswordSender é o endereço de e-mail a partir de onde o e-mail é enviado, quando as senhas são enviadas para usuários que esqueceram suas senhas. Escolha um endereço de pessoas para responder em caso de problemas ou confusão.
O MediaWiki precisa ter acesso ao banco de dados (atualmente, sejaMySQL ouPostgreSQL) para armazenar páginas, modificações, informações sobre o usuário, e muito mais coisas.
A variável$wgDBserver contém o nome da máquina onde o banco de dados está hospedado. Na maioria dos casos, ele será apenas "localhost" quando o banco de dados é executado no mesmo sistema, mas para instalações distribuídas, você precisa preencher o domínio completo do computador que está executando o banco de dados.
$wgDBname é onome da base de dados a ser utilizada pelo MediaWiki. Uma única instalação MySQL ou PostgreSQL pode armazenar mais de um banco de dados e você pode até mesmo executar muitas instalações MediaWiki em um único servidor. Certifique-se de ter declarado o nome do banco de dados correto aqui e usar nomes de bancos de dados diferentes para diferentes instalações wiki no mesmo servidor de banco de dados.
As variáveis$wgDBuser e$wgDBpassword contêm o nome de login e senha a ser usados pelo MediaWiki para acessar o banco de dados. Verifique se o usuário especificado tem os direitos de acesso apropriados para poder manipular a tabela wiki no servidor de banco de dados.
Also seeManual:Securing database passwords for a method to move the sensitive parts ofLocalSettings.php to a different file in a different directory.
A variável$wgGroupPermissions é um array associativo, que controla as permissões para criação e edição de páginas para seus grupos de usuários diferentes. Neste array, níveis de permissão personalizados podem ser criados, e os níveis de permissão para os diferentes grupos de usuários podem ser configurados. VejaHelp:User rights para mais informações sobre as diferentes permissões e grupos de usuários disponíveis.
Por padrão, nenhum nome da página pode começar com umaletra romana minúscula: na tentativa de fazê-lo a primeira letra é convertida em maiúsculas, se um destino do link, incluído página, imagem ou categoria é especificado com um nome que começa com uma letra minúscula, o alvo real etc é a página começando com a capitalização correspondente.
Alternativamente, nomes de página podem começar com uma letra minúscula, além de a possibilidade de iniciar com um capital, um dígito, etc. Para isso você deve ajustar a variável$wgCapitalLinks parafalse, que permite caracteres minúsculos, outrue, que escolhe o comportamento padrão.
NoLocalSettings.php,subpáginas são habilitadas em uma base por espaço nominal usando a variável$wgNamespacesWithSubpages. Por exemplo, para permitir subpáginas no espaço nominal principal:
$wgNamespacesWithSubpages[NS_MAIN]=1;
Antes que os usuários tenham permissão para fazer upload de arquivos para o sistema MediaWiki, você tem que habilitar esse recurso. Verifique se o diretório de upload está devidamente configurado e gravável pelo processo do servidor web Apache. Em seguida, defina a variável$wgEnableUploads paratrue a fim de permitir upload na interface de usuário web.
P.ex., aqui está um exemplo de código deincludes/DefaultSettings.php para inserir noLocalSettings.php:
$wgUploadPath="$wgScriptPath/uploads";## Wiki 1.5 defaults to /images, but allows more than just images$wgUploadDirectory="$IP/uploads";## Wiki 1.5 defaults to /images, but allows more than just images## To enable image uploads, make sure the above '$wgUploadPath' directory is writable by Apache User or group.## ''(i.e. chmod og+w uploads images)'' then the following should be true:$wgEnableUploads=true;$wgUseImageMagick=true;$wgImageMagickConvertCommand="/usr/bin/convert";## If you want to use image uploads under safe mode, create the directories## images/archive, images/thumb and images/temp, then configure them all writable. Afterwards, uncomment this, if it's not already done:$wgHashedUploadDirectory=false;
Se você quer poder redimensionar imagens em tempo real para apoiar as miniaturas, o MediaWiki precisa de uma instalação doImageMagick funcionando.Defina$wgUseImageMagick comotrue depois de instalar e testar o ImageMagick em seu sistema.Certifique-se de que$wgImageMagickConvertCommand aponta para a localização correta do comandoconvert de sua instalação, que o comando é executável pelo processo do servidor da web e$wgMaxShellMemory é grande o suficiente.VejaManual:Administração de imagens#Miniatura de imagem para informações detalhadas e solução de problemas.
Além disso, você pode querer modificar a lista de extensões aceitas, que são armazenados dentro do array$wgFileExtensions:
$wgFileExtensions=['png','jpg','jpeg','ogg','doc','xls','ppt','mp3','sxc','pdf'];
No caso do ImageMagick produzir uma mensagem erro semelhante a seguinte:
Fatal error: mime_magic could not be initialised, magic file is not available in includes/MimeMagic.php on line 506
experimente então adicionar a seguinte linha aoLocalSettings.php:
$wgMimeDetectorCommand ="file -bi";
O suporte aoInterWiki está embutido no MediaWiki, mas você precisa configurar o prefixo a ser usado para suas ligações internas.Este prefixo é geralmente igual a$wgSitename, mas caso você precise alterá-lo, defina a variável$wgLocalInterwikis como o nome preferido.
O MediaWiki permite uma variedade de idiomas de interfaces de usuário localizados em vez do padrão Inglês. Se você deseja executar o seu wiki em um idioma não-inglês, defina a variável$wgLanguageCode aocódigo de idioma adequado (p. ex. "de" para alemão, "es" para espanhol, etc.)
Você pode usar qualquer um dos idiomas encontrados no diretóriolanguages/i18n. Assim, se encontrarpt-br.json, você pode usarpt-br para português do Brasil. Não usePt-br, com letra maiúscula. Embora pareça funcionar, nem todos os textos são traduzidos.
manutenção e digitephprebuildMessages.php--rebuild.No Windows, a pasta PHP pode não estar em seu variável de ambientePATH e você terá que prefixarphp com o caminho para o programa.Nem todos os idiomas são suportados. Vejaaqui para ver uma lista das estatísticas de localização de 1.46.0-wmf.4 (29eae73). Consultetranslatewiki.net para as estatísticas por versão lançada.See thetranslation statistics on TranslateWiki for an up-to-date list of which languages are supported and to what extent.That list reflects the current state of MediaWiki core, so depending on what version you are using there may be a discrepancy.
http://www.gnu.org/licenses/fdl.html.)$wgRightsPage.$wgRightsPage não estiver vazio, o link no aviso de copyright/licença levará a essa página em seu site. E se$wgRightsPage estiver vazio, então o aviso de copyright/licença terá um link para$wgRightsUrl.Para modificar as declarações de direitos autorais do site, adicionar algo como isso noLocalSettings.php:
$wgRightsPage="YourWiki:Copyright";$wgRightsText="copyright YourWiki";
Posteriormente, editeMediaWiki:Copyright para proporcionar uma mensagem apropriada, usando" para indicar a posição onde o link para sua página de direitos autorais estará."$1""
Exemplo: criação de uma licençaCreative Commons
Para definir uma licença Creative Commons faça o seguinte:
<arel="license"href="http://creativecommons.org/licenses/by-nc-sa/3.0/"><imgalt="Creative Commons License"border="0"src="http://creativecommons.org/images/public/somerights30.png"/></a>This work is licensed under a<arel="license"href="http://creativecommons.org/licenses/by-nc-sa/3.0/">Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License</a>.
$wgRightsURL inserir a informação do href da primeira âncora:$wgRightsUrl="http://creativecommons.org/licenses/by-nc-sa/3.0/";
Para$wgRightsText digite o texto onde a segunda âncora é vinculada (adicione o "a" à variável Wiki para uma versão mais gramaticalmente correta)
$wgRightsText="a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License";
$wgRightsIcon inserir as informações da origem (src) da ligação image (img) na primeira âncora. Você quer copiar o emblema de seu próprio site, em vez de usar o do site da Creative Commons.$wgRightsIcon="http://creativecommons.org/images/public/somerights30.png";
Ao declarar$wgExtraNamespaces e modificar$wgNamespacesWithSubpages e$wgNamespacesToBeSearchedDefault, espaços nominais extras podem ser adicionados a uma instalação do MediaWiki; e declarando os apelidos de espaço nominal de array$wgNamespaceAliases podem ser adicionados.Tome cuidado para não ter nenhuma página já intitulada nesse espaço nominal, por exemplo, se você tivesse uma página chamada "Técnico:Suporte" e criou o espaço nominal Técnico:, então essa página não apenas seria perdida, mas você não pode removê-lo de Special:Allpages.Para corrigir isso, exclua o espaço nominal, mova "Técnico:Suporte" para "Suporte" no espaço principal, exclua o redirecionamento, reinsira o espaço nominal e mova-o de volta para "Técnico:Suporte".Vejaespaços nominais personalizados para obter mais informações sobre como fazer isso.
A skin padrão do site pode ser modificada através da$wgDefaultSkin.
LocalSettings.php durante a instalação.LocalSettings.php.