Manual: Instalação do MediaWiki
Esta página descreve todos os passos necessários para instalar manualmente o MediaWiki. Depois da instalação, os detalhes de configuração adicionais podem ser encontrados em Manual: Administração do Sistema#Configuração.
Para instalar MediaWiki, é necessário um conhecimento básico do alojamento da Web. Experiência com Apache, PHP e MySQL/MariaDB facilitará o processo. Para quaisquer questões relacionadas com a instalação de MediaWiki, pergunte ao Project: Support desk ou consulte outros lugares listados em Comunicação.
Em baixo, a secção Apêndices oferece alternativas para a instalação manual, em conjunto com notas de instalação especificas para diferentes configurações do sistema.
Para uma configuração de servidor local mais rápida da MediaWiki, consulte Início rápido de desenvolvimento local.
Requisitos da instalação
Verifique se o seu sistema corresponde aos requisitos da instalação.
Certifique-se que também verifica o Notas de Lançamento da versão do MediaWiki que planeia instalar.
Transferir o programa MediaWiki
Transfira o ficheiro tar do MediaWiki da página oficial de transferências.
Se estiver a utilizar o MediaWiki num ambiente de produção, o gestor de versões emitiu uma recomendação forte de que apenas as versões listadas em Ciclo de vida da versão e o seu fim de vida útil, como a atual "versão estável", "versão legada" ou "versão de suporte de longo prazo" deveriam ser utilizadas num ambiente de produção. As versões mais antigas podem conter vulnerabilidades críticas de segurança e outros erros importantes, incluindo a ameaça de possível perda e/ou corrupção de dados. A versão estável atual é MediaWiki 1.45.1.
Extrair o programa MediaWiki
O ficheiro transferido está em .zip ou no formato de ficheiro .tar.gz. Precisa de descompactar este ficheiro de arquivo antes de o utilizar. Pode descomprimir o ficheiro localmente (e depois enviar via FTP para o servidor) ou diretamente no seu servidor.
No Windows, a descompressão é normalmente efetuada com programas, tais como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis).
No Linux e no Mac OS X, pode descomprimir o ficheiro utilizando este comando: tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Para mais informação sobre as permissões de ficheiro e segurança, consulte Manual: Segurança#Permissões de ficheiro
Enviar ficheiros para o seu servidor da Web
Se ainda não enviou os ficheiros para o seu servidor da Web (ou copiou, se o seu programa do servidor da Web é executado localmente no seu localhost), faça-o agora.
Os ficheiros pertencem à raiz do documento do servidor da Web (ou seja, a diretoria onde index.html seria encontrado se esse ficheiro fosse acessível num URL, como https://www.example.com/index.html).
Esta diretoria chamar-se-á algo assim: html, public_html, http, htdocs, www, web. Pode ser encontrado na diretoria do servidor, por exemplo: /var, /srv, /usr/share. Num servidor partilhado, estará na sua diretoria de início.
Se utiliza o servidor da Web Apache, a diretoria correta é especificada no seu ficheiro httpd.conf na diretiva DocumentRoot Por predefinição, é /var/www/ ou <pasta apache>/htdocs.
A localização exata das definições do servidor Apache e do ficheiro de diretorias httpd.conf depende do seu sistema operativo. No Debian e Ubuntu, o ficheiro para as definições de servidor do Apache e as diretorias é /etc/apache2/apache2.conf. No Red Hat e Fedora, o ficheiro é /etc/httpd/conf/httpd.conf.
Envie os ficheiros para a diretoria da Web do seu servidor da Web:
- diretamente, copiando a pasta descomprimida
- utilizando um cliente FTP, tal como o FileZilla (Windows, OSX e Linux) ou Cyberduck (Windows e OSX).
- utilizando o programa já fornecido pelo seu serviço de hospedagem, tal como o cPanel File Manager
Se a sua ferramenta de envio tem uma opção "alterar os nomes dos ficheiros para minúsculas", então deve desativar isto para evitar quaisquer modificações aos nomes de ficheiro durante o processo de envio.
Renomeie a pasta enviada para o nome pretendido, porque isto irá determinar como esta aparece no URL. Por exemplo, se renomeia a pasta para wiki, o URL refletirá isto como example.com/wiki. Se o seu servidor da Web é executado como http://localhost, por exemplo, renomear a diretoria para /w/ significaria que iria aceder à sua wiki em http://localhost/w/index.php.
/wiki/ se quer configurar os URLs Curtos depois de executar o comando de configuração inicial.
Configurar a base de dados
O comando de configuração inicial do MediaWiki requer um nome da base de dados e o nome do utilizador da base de dados para guardar o conteúdo da wiki.
Se já tem um servidor da base de dados e sabe a palavra-passe para o utilizador "raiz" (administrador), pode ir diretamente para a secção #Executar o comando de instalação.
Se não sabe a palavra-passe para o utilizador raiz, por exemplo, se estiver num servidor alojado, terá de criar uma nova base de dados nova antes de executar o comando de instalação do MediaWiki na secção seguinte.
MariaDB/MySQL são as bases de dados recomendadas. Embora PostgreSQL e SQLite sejam suportados, eles oferecem compatibilidade limitada e só devem ser utilizados se necessário. Se não tiver a certeza sobre qual a base de dados a escolher, utilize MariaDB.
Assim que a base dados estiver configurada, prossiga para Executar o comando de instalação em baixo.
SQLite
Não é necessária nenhuma configuração adicional para SQLite se o módulo pdo-sqlite para PHP está instalado no sistema.
Na página de instalação de SQLite, selecione um nome da base de dados (qualquer nome aceitável) e a diretoria da base de dados SQLite. O instalador irá tentar utilizar uma diretoria fora da raiz do documento e criá-lo se necessário. Se esta diretoria é legível da Web ou insegura, esta deverá ser alterada manualmente para evitar o acesso não autorizado.
MariaDB/MySQL
Para criar a base de dados e o utilizador para MariaDB/MySQL, pode utilizar um dos métodos seguintes:
- Um painel de controlo fornecido pelo seu serviço de alojamento, como PhpMyAdmin.
- Acesso SSH para o seu anfitrião, onde pode inserir os comandos em baixo na janela de MySQL. Consulte a documentação do seu provedor de alojamento. Como alternativa, pode solicitar ao seu provedor de alojamento que lhe crie a base de dados e o utilizador para si.
Os comandos seguintes irão criar uma base de dados chamada de my_wiki, um utilizador chamado de wikiuser, e atribuir as permissões para o utilizador nessa base de dados.
CREATE DATABASE my_wiki; CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password'; GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION; Apenas se a sua base de dados não estiver a ser executada no mesmo servidor onde está o seu servidor da Web, tem de fornecer o nome do hospedeiro do servidor da Web apropriado (mediawiki.example.com no exemplo em baixo):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';  Aviso: | MySQL/MariaDB regista todas as consultas num ficheiro de histórico. Este irá incluir a palavra-passe da base de dados para a conta do utilizador. Se isto o preocupa, elimine e desative o ficheiro .mysql_history depois de executar estas consultas, seguindo a documentação de MySQL. |
PostgreSQL
Se está a utilizar PostgreSQL, irá precisar que lhe criem uma base de dados e um utilizador para si, ou fornecer o nome de utilizador com privilégios de "super utilizador" no formulário de configuração. Normalmente, é o utilizador da base de dados nomeada postgres.
Os comandos seguintes numa linha de comandos Linux, como o utilizador postgres, cria um utilizador da base de dados chamada de wikiuser, e uma base de dados nomeada de my_wiki, pertencente ao utilizador chamado de wikiuser.
createuser -S -D -R -P -E wikiuser (depois insira a palavra-passe da base de dados) createdb -O wikiuser my_wiki
ou como super utilizador (postgres predefinido) execute os seguintes comandos na janela da base de dados:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password'; CREATE DATABASE my_wiki WITH OWNER wikiuser; Tenha em atenção a lista de problemas conhecidos ao executar o MediaWiki com o PostgreSQL.
Executar o comando de instalação
A seguir, conclua a instalação do MediaWiki, indo para o URL da sua instalação do programa no seu navegador da Web: siga as instruções em Manual: Comando de Configuração (Script).
Configuração adicional
- Manual: Administração do Sistema - Configuração adicional
- Manual: Administradores - Administração da Wiki
Mantenha-se atualizado!
Terminada a instalação, certifique-se que se mantém atualizado com os lançamentos, e mantenha o seu servidor seguro!
Apêndices
Alternativas à instalação manual
A instalação manual é muitas vezes o método preferido porque dá ao utilizador mais controle e visão sobre como a sua wiki é instalada, facilitando a resolução de problemas e a manutenção. Os processos, pacotes, conjuntos, e serviços automatizados vêm com as suas próprias idiossincrasias.
Em vez de instalar o MediaWiki manualmente, as opções alternativas podem ser mais fáceis:
- Dispositivos de programas pré-integrados
- Serviços de alojamento com instalação '1-Clique', ou farms de wiki
- software bundles
- Os serviços de alojamento que proporcionam a instalação automática de aplicações, como o MediaWiki, podem oferecer versões desatualizadas ou ter outros problemas. Se encontrar problemas, "não" significa que não pode instalar o MediaWiki. Significa que deve instalar o MediaWiki manualmente.
Consulte também comparison of distribution options.
Instruções específicas do sistema
As páginas listadas em Manual: Ajuda Especifica do SO têm mais instruções detalhadas de instalação destinadas para sistemas específicos.
Contudo, em geral, estes documentos por sistema são menos mantidos e nem sempre estão atualizados. Primeiro consulte Instalação do MediaWiki (esta página) antes de ver a documentação de instalação por sistema.
Executar várias wikis
Leia Manual:Perguntas Mais Frequentes (FAQ)
Importação de uma base de dados da wiki existente
Leia o Manual: Perguntas Mais Frequentes (FAQ).