Manual:Installing MediaWiki/pt-br

O MediaWiki instala-se usando um script interativo, baseado na rede. Antes de rodar este script, você precisa fazer algumas coisas: consulte os pré-requisitos ou o guia de instalação resumido para experts.

Pode ser difícil instalar o MediaWiki para um usuário médio, sem experiência com Apache, PHP e MySQL/MariaDB. A maioria dos usuários que desejam usar o software wiki pode se beneficiar com a utilização de free MediaWiki host ou através de um software bundles.

Baixar o software MediaWiki
Baixe o arquivo tar do MediaWiki da página oficial de baixar. Geralmente, se estiver usando um ambiente de produção, você deseja executar a versão estável mais recente, que é MediaWiki.

Extract the MediaWiki software
Os arquivos baixados estarão no formato, então deverão ser descomprimidos antes de serem usados. You need to uncompress this archive file before use. Isto pode ser feito localmente (e então subido via FTP) ou diretamente em seu servidor. No Windows, a descompactação pode ser feita com programas como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis). No Linux e Mac OS X, você pode descompactar o arquivo usando este comando:

tar -xf mediawiki-*.tar.gz

Fazer upload de arquivos para seu sevidor
Se você ainda não carregou os arquivos para seu servidor web, carregue agora.

É possível fazer o upload dos arquivos para o diretório de seu servidor web:


 * 1) copiando diretamente a pasta descompactada ou
 * 2) usando um cliente FTP como FileZilla (Software de código aberto, com versões para Windows, OSX e Linux) ou Cyberduck (OSX).
 * 3) by using cPanel File Manager (see below)

Se sua ferramenta de carregamento tiver uma opção "alterar nomes de arquivo para minúsculas", então você deve desabilitar isso.

Se você instalou o Apache, o diretório correto é especificado em seu  file (é o diretiva, tipicamente   ou ). Nota: Isso mudou em Ubuntu 14.04 com Apache 2.4.7 onde o arquivo de configuração primário para configurações e diretórios do servidor Apache é.

Se você estiver usando um servidor Linux ou Unix você poderá copiar os arquivos para qualquer diretório em seu servidor e então fazer um link simbólico para esta pasta no diretório web do seu servidor.

Renomeie a pasta que subiu como você quiser que seja na URL. Se seu servidor web estiver rodando como  por exemplo, ao renomear o diretório para   significará que você acessará seu wiki em. Não use  se desejar usá-la como uma Short URL. (e não configure short URLs antes de executar o script de instalação).

Esta pasta (renomeada) será agora referenciada como.

Gerenciador de arquivos cPanel
cPanel é uma interface popular usada por muitos hosts da web.


 * Navegue até o diretório onde deseja sua pasta da wiki.
 * Carregue o arquivo mediawiki-1.xx.x.tar.gz. Você pode precisar clicar em "Recarregar" para vê-lo.
 * Extraia o arquivo mediawiki-1.xx.x.tar.gz. Recarregue novamente.
 * Confirme se a pasta mediawiki-1.xx.x está presente.
 * Exclua o arquivo mediawiki-1.xx.x.tar.gz.
 * Renomeie a pasta mediawiki-1.xx.x para w.

Criar uma base de dados
Se você já tem um servidor de base de dados e sabe a senha do root para ele, o instalador do MediaWiki poderá criar uma nova base de dados pra você. Se for esse o caso, pode pular para a seção abaixo Executar o script de instalação. Se você não sabe a senha de root, por exemplo, se está em um servidor do provedor, você terá de criar uma nova base de dados agora. Atualmente, você deve usar SQLite, MariaDB/MySQL ou PostgreSQL para armazenar o conteúdo de sua wiki.

Se você não tiver certeza sobre qual banco de dados escolher, use o MariaDB, pois é o melhor suportado pelo MediaWiki.

SQLite
O SQLite é uma biblioteca de base de dados stand-alone que armazena o conteúdo da base de dados em um único arquivo. Se o PHP tiver o módulo, não será necessário efetuar mais configurações.

Na página de instalação, você deverá escolher o nome da base de dados (que pode ser qualquer um) e o diretório da base de dados SQLite. Para o diretório da base de dados, o instalador tentará usar um subdiretório fora do document root, e irá criá-lo se necessário. Se este diretório não for seguro (por exemplo, puder ser lido via web), mude-o manualmente para evitar que fique acessível a todos na web.

MariaDB/MySQL
O MediaWiki solicitará a base de dados e nome de usuário, e tentará criá-los, se não existirem ainda. Se fazer isto via MediaWiki não for possível, você pode fazer usando diversos painéis de controle, como o PhpMyAdmin, que geralmente está disponível em hospedagens compartilhadas, ou poderá usar ssh para efetuar login em seu host e digitar os comandos no prompt do MySQL. Consulte a documentação correspondente. Opcionalmente, entre em contato com seu provedor para que eles criem esta conta para você.

Se sua base de dados não estiver rodando no mesmo servidor de ser servidor web, você precisará fornecer o hostname de seu servidor web -- mediawiki.example.com no meu exemplo -- como se segue:

PostgreSQL
Se você estiver usando o PostgreSQL, precisará, ou ter uma base de dados e usuário já criados para você, ou simplesmente fornecer o nome de um usuário do PostgreSQL com privilégios de "superusuário" para efetuar a configuração. Geralmente, este usuário tem o nome postgres.

Aqui está uma forma de fazer a maior parte da configuração. Isto é para um sistema compatível com Unix. Neste exemplo, criaremos uma base de dados chamada wikidb, de propriedade (owned by) um usuário chamado wikiuser. A partir da linha de comando, como usuário postgres, efetue os passos a seguir.

createuser -S -D -R -P -E wikiuser (então insira a senha) createdb -O wikiuser wikidb

ou como superusuário (que por padrão é postgres) execute os seguintes comandos no prompt da base de dados:

Atenção para a lista de problemas conhecidos ao rodar o MediaWiki com PostgreSQL.

Executar o script de instalação
Uma vez completados os passos acima, você poderá completar a instalação através do navegador de internet, acessando a URI index.php em seu navegador -- verifique as instruções mencionadas em.

A ferramenta de instalação solicitará que você baixe o arquivo e salve isso como.

Em alternativa, pode executar o programa de instalação de linha de comandos:  acrescentando os parâmetros de configuração apropriados.

Próximas etapas
Eles são opcionais, mas deixam seu site muito melhor.



Mantenha atualizado!
Assine nosso mailing list de avisos de lançamentos.

Uma vez instalado, tenha certeza de manter atualizado, e manter seu servidor seguro!

Ajuda para instalação

 * Leia o FAQ sobre instalação e configuração
 * MediaWiki installation errors
 * Ask questions and receive help about installing MediaWiki

Ver também

 * - lista as páginas do wiki às quais as mensagens do MediaWiki se ligam, você precisa criar essas páginas ou editar as mensagens.
 * - para links para configuração mais avançada.
 * - por ter URL mais fácil de usar para páginas de artigos.
 * - para configurar várias instâncias do MediaWiki com um conjunto único de arquivos MediaWiki.