Manual: Requisitos de Instalação
Além do próprio programa MediaWiki, precisa de:
- Um programa de servidor da Web para lidar com as páginas do MediaWiki para o navegador da Web.
- PHP para executar o MediaWiki.
- Um servidor de base de dados para guardar as páginas e os dados do MediaWiki.
Em adição, existem várias dependências opcionais que são necessárias se quiser utilizar algumas das funcionalidades mais avançadas (veja em baixo).
Se o seu site da Web está hospedado (por exemplo, não tem controlo direto sobre o mesmo), então contacte os administradores do servidor ou a empresa de hospedagem para se certificar que estes pacotes de programas estão instalados e disponíveis.
Para executar comandos (scripts) de manutenção do MediaWiki, irá precisar de acesso à linha de comandos.
Instalação de uma transferência
Se está a utilizar o Linux, é melhor instalar o servidor da Web "Apache", "PHP", e o servidor de base de dados "MariaDB" utilizando o seu gestor de pacotes. No Debian e [$2 Ubuntu], faça o seguinte:
sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-apcu php-curl php-mysql php-xml
- Pacotes de programas
Nos outros sistemas operativos, utilize um pacote de programa como XAMPP de https://www.apachefriends.org para instalar e configurar todos os pacotes importantes e o servidor da Web Apache, PHP, e MariaDB com uma única transferência Está disponível para Linux, Mac e Windows. Desde maio de 2025, a versão mais recente do XAMPP inclui PHP 8.2 (MediaWiki requer pelo menos 8.2.0).
Alternativamente, se utiliza o macOS, pode utilizar MAMP, que é o equivalente a XAMPP. MAMP inclui a capacidade de executar o servidor da Web Apache e a base de dados MySQL. Está disponível para o Windows e para o Mac, mas geralmente utiliza-se no Mac em vez do Windows.
Servidor da Web
Para lidar com as páginas da wiki nos navegadores, o MediaWiki requer alguns programas de servidor da Web. Muitas das vezes não terá a escolha de qual o programa a utilizar – este será o que é disponibilizado pelo seu fornecedor de hospedagem.
O MediaWiki é amplamente compatível com a maioria dos principais servidores da Web que podem invocar uma versão compatível do PHP. A maioria das instalações utilizam o servidor da Web Apache. Nginx (exemplo de configuração) é também uma boa escolha.[dead link]
PHP
PHP é a linguagem de programação na qual o MediaWiki foi escrito, e é necessário para executar o programa.
- Para a versão estável mais recente do MediaWiki, é necessário pelo menos PHP 8.2.0. Consulte a página Compatibilidade para mais informação.
- São necessárias as seguintes extensões núcleo de PHP (estas são, normalmente compiladas como parte do próprio PHP): calendar, ctype, dom, fileinfo, iconv, json, openssl, sodium, xml, xmlreader. Verifique a saída de
php -mpara saber quais as extensões que estão ativadas atualmente no seu caso em particular. - As seguintes extensões núcleo de PHP também são necessárias:
- As seguintes extensões são recomendadas além das requeridas:
- MediaWiki requer apenas as extensões que estão ativadas por predefinição no PHP. Se o seu fornecedor de alojamento proporciona um ambiente LAMP básico sem estes, é possível que precise de instalar ou ativar estes manualmente.
- Em Debian/Ubuntu, o seguinte comando instala todas as extensões recomendadas de PHP listadas em cima:
sudo apt-get install php php-intl php-mbstring php-apcu php-curl
- Em Debian/Ubuntu, o seguinte comando instala todas as extensões recomendadas de PHP listadas em cima:
- Nos fornecedores de alojamento com um painel de controlo como cPanel, com frequência pode utilizar "Selecionar versão de PHP" (Seletor de PHP) para ativar estas extensões. (Por exemplo, depois de ver "Falta-lhe uma extensão requerida para PHP que o MediaWiki precisa para funcionar. Por favor, instale: intl")
- Na maioria das distribuições baseadas em Debian/Ubuntu, o pacote
php-mysqlé necessário se quiser que o MediaWiki utilize MySQL. - Algumas funcionalidades do MediaWiki podem exigir funções de PHP que executam processos externos, tal como miniaturas de imagens, que alguns anfitriões baratos geralmente desativam. Por favor, leve isto em consideração se planeia instalar o MediaWiki num hospedeiro partilhado.
- As extensões do MediaWiki podem exigir funcionalidades de PHP adicionais, por exemplo, VisualEditor requer suporte de libcurl (
php-curlnas distribuições baseadas em Debian/Ubuntu).
Se precisar de compilar o PHP a partir do código fonte, então consulte Configuração do PHP para saber as opções de compilação que afetam o MediaWiki.
Servidor da base de dados
O MediaWiki guarda todo o texto e dados (páginas de conteúdo, detalhes do utilizador, mensagens de sistema, etc.) numa base de dados, que pode ser partilhada com outras aplicações baseadas na Web (phpBB, etc.) Para executar a versão mais recente do MediaWiki precisará de "um" dos seguintes servidores de base de dados:
A utilização de MariaDB ou MySQL é recomendado, porque a Wikimédia utiliza MariaDB. Quaisquer outros servidores de base de dados são menos testados e provavelmente irá encontrar alguns erros.
Requisitos de Hardware
Os requisitos mínimos recomendados são 256 MB de RAM para um único site da Web alojado num computador e 85 MB de armazenamento, embora isto seja insuficiente para um site público com grande afluência ou um site que permita o envio (upload) de ficheiros. Alguns utilizadores conseguem executar o MediaWiki em computadores com 48 MB de RAM.
Dependências opcionais
- ImageMagick ou GD são necessários para as miniaturas de imagem.
- Acesso à linha de comandos (Shell) é requerido para executar Comandos (''scripts'') de manutenção; e atualizar o MediaWiki poderá ser mais difícil sem este.
- Enviar notificações por correio eletrónico através do próprio servidor requer um agente de transferência de mensagens (MTA).
- GNU diff3 pode ser utilizado para resolver conflitos automaticamente.
- memcached pode ser utilizado para a colocação de objetos na cache.
Consultar também =
- Compatibilidade, para informação sobre como os requisitos de instalação do Mediawiki podem mudar no futuro
- Manual: Ajuda Especifica do SO