Manual:Installing MediaWiki/pt

O MediaWiki instala-se a si mesmo, utilizando um script (comandos) de instalação interativo baseado na Web. Antes de executar este ficheiro de comandos, precisa de realizar algumas coisas: consulte os pré-requisitos ou o guia de instalação resumido para os técnicos.

O MediaWiki pode ser difícil de instalar para o utilizador médio, que não tenha experiência com o Apache, PHP e MySQL/MariaDB. Using a software bundle or a hosting service might be easier. (See the .)

Transferir o software 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.

Extract the MediaWiki software
Os ficheiros transferidos estão no formato, por isso terão de ser descomprimidos antes de serem utilizados. You need to uncompress this archive file before use. Isto pode ser efetuado localmente (e depois enviados via FTP) 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:

tar -xf mediawiki-*.tar.gz

Enviar ficheiros para o seu servidor
Se ainda não enviou os ficheiros para o seu servidor da Web, faça-o agora.

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


 * 1) diretamente, copiando a pasta descomprimida
 * 1) utilizando um cliente FTP, tal como o FileZilla (Software de Código Aberto, Windows, OSX e Linux) ou Cyberduck (OSX).
 * 1) 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 instalou o Apache, a diretoria correta é especificada no seu ficheiro  (é a diretiva DocumentRoot, tipicamente   ou  ).

The exact location of the Apache server settings and directories file  depends on your operating system. Nota: isto mudou no Ubuntu 14.04 com Apache 2.4.7, em que o ficheiro de configuração primário para as configurações e diretórios do servidor Apache é. In Red Hat and Fedora, the file is.

Altere o nome da pasta que carregou, para aquilo que pretende ter no URL. Se o seu servidor da Internet está a ser executado como, por exemplo, alterar o nome para   significa que pretende aceder à sua wiki em.

Criar uma base de dados
O MediaWiki irá pedir-lhe o nome da base de dados e do utilizador, e tentará criá-los se estes ainda não existirem.

Se já tem um servidor de base de dados e sabe a palavra-passe do utilizador root da mesma, o ficheiro de comandos da instalação do MediaWiki pode criar uma nova base de dados nova por si.

Se não sabe a palavra-passe do utilizador root, como será o caso se estiver a usar um servidor alojado, por exemplo, terá de criar uma base de dados nova agora.

Neste momento, tem de usar SQLite, MariaDB/MySQL ou PostgreSQL para armazenar o conteúdo da sua wiki. Se não tiver a certeza sobre qual a base de dados escolher, utilize MariaDB, pois é a melhor suportada pelo MediaWiki.

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, terá de escolher um nome para a base de dados (que pode ser um qualquer) e para o diretório 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. Em alternativa, entre em contacto com o seu fornecedor de alojamento e peça-lhes 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.

Se a sua base de dados não estiver a ser executada no mesmo servidor físico onde está o seu servidor da Internet, terá de fornecer o nome do servidor físico do seu servidor da Internet &mdash; mediawiki.example.com no exemplo abaixo &mdash; como se segue:

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.

Passos adicionais
See.

Mantenha a instalação atualizada!
Subscreva a nossa lista de divulgação de novas versões.

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

Ajuda de instalação

 * Leia as perguntas frequentes de instalação e configuração
 * MediaWiki installation errors
 * Ask questions and receive help about installing MediaWiki