Manual:Installing MediaWiki/pt

Esta página abrange todas as etapas para instalar e configurar manualmente o MediaWiki.

MediaWiki pode ser difícil de instalar se não tiver qualquer experiência de Apache (programa de servidor da Web), PHP e MySQL/MariaDB (base de dados). A secção Apêndices em baixo oferece alternativas mais fáceis para a instalação manual.

A secção Apêndices em baixo também fornece notas de instalação para as configurações específicas do sistema.



Verifique os requisitos de instalação
Check that your system meets the installation requirements.

Make sure to also check the of the MediaWiki version that you plan to install.



Transferir o programa MediaWiki
Download the MediaWiki tar file from the official download page.

Generally, if you're using a production environment, you want to be running the latest stable release, which is MediaWiki.



Extrair o programa MediaWiki
O ficheiro transferido está em  ou no formato de ficheiro. You need to uncompress this archive file before use. Pode descomprimir o ficheiro localmente (e depois enviar via FTP para o servidor) ou diretamente no seu servidor.

Isto é normalmente efetuado com software, tais como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis) no Windows.

No Linux e no Mac OS X, pode descomprimir o ficheiro utilizando este comando:



Enviar ficheiros para o seu servidor
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 ), faça-o agora.

Envie os ficheiros para a diretoria da Web do seu servidor da Web:


 * 1) diretamente, copiando a pasta descomprimida
 * 2) utilizando um cliente FTP, tal como o FileZilla (Windows, OSX e Linux) ou Cyberduck (Windows e OSX).
 * 3) by using software already provided by your hosting service, such as the cPanel File Manager

Se a sua ferramenta de envio tem uma opção "alterar os nomes dos ficheiros para minúsculas", tem de desativar isto.

Se utiliza o servidor da Web Apache, a diretoria correta é especificada no seu ficheiro  na diretiva Por predefinição, é  ou.

The exact location of the Apache server settings and directories file  depends on your operating system. No Debian e Ubuntu, o ficheiro para as definições de servidor do Apache e as diretorias é. No Red Hat e Fedora, o ficheiro é.

Altere o nome da pasta que carregou, para aquilo que pretende ter no URL. Se o seu servidor da Web é executado como #1, por exemplo, renomear para  significaria que iria aceder à sua wiki em.



Configurar a base de dados
O comando de instalação do MediaWiki irá pedir-lhe o nome da base de dados e do utilizador, e assim o MediaWiki pode guardar o conteúdo da wiki.

Se já tem um servidor de base de dados e sabe a palavra-passe para utilizador "raiz" (admin.), vá para a secção em baixo #Executar um 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.

SQLite, MariaDB/MySQL, e PostgreSQL são bases de dados suportadas. Se não tiver a certeza sobre qual a base de dados a escolher, utilize MariaDB.

After finishing the database setup, continue with below.

SQLite
No further setup is required for SQLite if the  module for PHP is installed on the system.

Na página de instalação de SQLite, escolha um nome para a base de dados (que pode ser um qualquer) e a diretoria da base de dados SQLite. Para o diretório da base de dados, o ficheiro de instalação tentará usar um subdiretório fora da raiz do documento e criá-lo se necessário. Se este diretório não for seguro (por exemplo, se puder ser lido através da Internet), mude-o manualmente para evitar que seja acessível por qualquer pessoa na Internet.

MariaDB/MySQL
Create the MariaDB/MySQL database and database user. There are several ways:


 * Use a control panel software offered by your Hosting service (example: PhpMyAdmin)
 * Use ssh to log into your host and type the commands below into a MySQL prompt. Consulte a respetiva documentação do seu provedor de hospedagem. Como alternativa, contacte o seu provedor de alojamento para que criem uma conta para si.

The following commands create a database named, a user named  , and set permissions for the user on that database.

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 ( no exemplo em baixo):

PostgreSQL
Se está a usar o PostgreSQL, ou alguém terá de criar uma base de dados e um utilizador para si, ou então forneça simplesmente o nome de um utilizador do PostgreSQL com privilégios de «superutilizador» no formulário de configuração. Normalmente, este utilizador da base de dados tem o nome postgres. The following commands on a Linux command-line, as the postgres user, create a database user named, and a database named   owned by the user named.

createuser -S -D -R -P -E wikiuser (depois insira a palavra-passe) createdb -O wikiuser my_wiki

ou como superutilizador (que, por omissão, é postgres) execute os seguintes comandos na linha de comandos da base de dados:

Tenha em atenção a lista de problemas conhecidos ao executar o MediaWiki com o PostgreSQL.



Executar o ficheiro de instalação
Depois de completar todos os passos acima, pode finalizar a instalação através de um navegador da Internet, acedendo ao URL index.php no seu navegador — verifique as instruções mencionadas em.



Configuração adicional

 * - Additional configuration
 * - Wiki administration

Mantenha a instalação atualizada!
Terminada a instalação, mantenha-a atualizada e mantenha o seu servidor seguro!

Alternatives to manual installation
Instead of manually installing MediaWiki, alternative options might be easier:
 * pre-integrated software appliances
 * hosting services with 1-click installation, or wiki farms

See also the.

System-specific instructions
The pages listed on give more detailed installation instructions aimed at specific systems.

However, by and large these per-system docs are less maintained and might not always be up to date. First consult (this page) before looking at per-system installation documentation.

Running multiple wikis
Refer to Manual:FAQ#Installation and configuration.

Importing an existing wiki database
Refer to Manual:FAQ#Installation and configuration.

