Manual:Installing MediaWiki/pt

O MediaWiki instala-se a si mesmo usando um ficheiro de comandos de instalação interativo, com uma interface para uso pela Internet. Antes de executar este ficheiro de comandos, precisa de fazer algumas coisas: consulte os pré-requisitos ou o guia de instalação breve para peritos.

O MediaWiki pode ser difícil de instalar para o utilizador médio, sem experiência de Apache, PHP e MySQL/MariaDB. A maioria dos utilizadores que desejam criar uma wiki têm a tarefa facilitada se usarem um serviço grátis de alojamento do MediaWiki ou um pacote de programas.

Descarregar o programa MediaWiki
Pode descarregar uma versão estável do MediaWiki na página oficial de download: em geral, em ambientes de produção/exploração deve executar uma versão estável.

Para descarregar o MediaWiki, que é a última versão estável, para uma máquina *nix pode usar o seguinte comando: wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz Como alternativa, usando cURL:

curl -O https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz

Os ficheiros descarregados estarão no formato, por isso terão de ser descompactados antes de serem usados. Isto pode ser feito localmente (e depois carregado no seu servidor via FTP) ou diretamente no servidor. No Windows, a descompactação pode ser feita com programas como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis). Em Linux e no Mac OS X, pode descompactar o arquivo usando este comando:

tar xvzf mediawiki-*.tar.gz

Para programadores
Quem é programador, por outro lado, provavelmente quererá descarregar do Git o código de desenvolvimento mais recente e configurar um repositório local. Também terá de instalar as dependências manualmente através do Composer.

Carregar ficheiros no seu servidor
Se ainda não carregou os ficheiros no seu servidor da Internet, carregue-os agora.

Pode carregar os ficheiros na pasta da Internet do seu servidor:


 * 1) diretamente, copiando a pasta descompactada
 * 2) usando um cliente FTP como o FileZilla (Open Source Software, Windows, OSX e Linux) ou Cyberduck (OSX).

Se a sua ferramenta de carregamento tem uma opção «alterar os nomes dos ficheiros para minúsculas», tem de desmarcar esta opção.

Se instalou o Apache, o diretório correto é especificado no seu ficheiro  (é a diretiva DocumentRoot, tipicamente   ou  ). 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 é.

Se está a usar um servidor Linux ou Unix, pode copiar os ficheiros para qualquer diretório do seu servidor e depois criar uma ligação simbólica para este diretório a partir do diretório da Internet do seu servidor.

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. Não lhe chame  se pretende usá-lo como um URL curto (e não crie URL curtos antes de ter executado o ficheiro de comandos de instalação).

Esta pasta (após a alteração do nome) passará a ser referida como.

Criar uma base de dados
Se já tem um servidor de base de dados e sabe a palavra-passe do utilizador root da mesma, o ficheiro de comandos de instalação do MediaWiki pode criar uma base de dados nova por si. Neste caso, pode saltar para a secção Executar o ficheiro de instalação abaixo. Se não sabe a palavra-passe do utilizador root, como é 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.

SQLite
SQLite is a stand-alone database library that stores the database contents in a single file. If PHP has the  module, no further setup is required.

On the installation page, you will need to choose a database name (which can be anything) and the SQLite database directory. For the database directory, the installer will attempt to use a subdirectory outside of the document root and create it if needed. If this directory is not safe (for example, web-readable), change it manually to avoid making it accessible to everyone on the web.

MariaDB/MySQL
MediaWiki will ask you for database and user name and will attempt to create them if they don't already exist. If doing so from MediaWiki is impossible, you can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you.

If your database is not running on the same server as your web server, you need to give the appropriate web server hostname -- mediawiki.example.com in my example -- as follows:

PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or simply supply the name of a PostgreSQL user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

Here's one way to do most of the setup. This is for a Unix-like system. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

createuser -S -D -R -P -E wikiuser (then enter the password) createdb -O wikiuser wikidb

or as superuser (default postgres) execute the following commands at the database prompt:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password'; CREATE DATABASE wikidb WITH OWNER wikiuser;

Beware of the list of known issues when running MediaWiki with PostgreSQL.

Executar o ficheiro de instalação
Once all of the above steps are complete, you can complete the installation through a web browser by going to the index.php URL in your browser — check the instructions mentioned in.

The installation tool will prompt you to download the file, and to save this as.

Alternatively, you can run the command-line installer or CLI:  adding the appropriate configuration parameters.

Keep up to date!
Subscribe to our release announcements mailing list.

Once installed, make sure you stay up to date with releases, and keep your server secure!

Installation assistance

 * Read the FAQ about installation and configuration
 * Chat with MediaWiki developers, system administrators, and users:
 * The mediawiki-l mailing List is the high-traffic list on which to ask for support