Manual:Requisitos para instalação
Além do próprio software, uma instalação padrão do MediaWiki tem os seguintes pré-requisitos:
- Um servidor web é exigido para enviar as páginas geradas ao seu navegador web.
- PHP é exigido para executar o software.
- Um servidor de banco de dados é necessário para armazenar as páginas e os dados do site.
Além disso, há várias dependências opcionais que são exigidas se você quiser utilizar certos recursos avançados (veja abaixo).
Se seu website é hospedado por terceiros (isto é, se você não tem controle direto sobre ele), entre em contato com os administradores do servidor ou da empresa de hospedagem para certificar-se de que esses componentes estão instalados.
Instalação simples com um único download
Se você estiver usando o Linux, é melhor instalar apache, php e MariaDB usando seu gerenciador de pacotes. Debian e Ubuntu, do seguinte:
sudo apt-get install php php-apcu php-intl php-mbstring php-xml php-mysql mariadb-server apache2
Em outros sistemas operacionais, use XAMPP de https://www.apachefriends.org para instalar e configurar todos os pacotes importantes – Apache web server, PHP, e MariaDB – com apenas um download. Ele está disponível para Linux, Windows, Mac e Solaris. Em janeiro de 2021, a última versão do XAMPP incluía o PHP 8.0 (o MediaWiki requer pelo menos o 7.3.19).
Alternativamente, se você tem um computador Apple, você pode usar MAMP, que é o equivalente a XAMPP. O MAMP atualmente inclui a capacidade de executar o servidor web Apache e um banco de dados MySQL. Ele está disponível para Windows e Mac, mas é geralmente usado no Mac em vez do Windows. Ele está atualmente executa as últimas versões do PHP e MySQL.
Servidor web
Para gerar as páginas que serão mostradas no seu navegador, o MediaWiki exige algum software de servidor web. Às vezes você não terá escolha de qual software usar – ele será aquele fornecido pelo seu provedor de hospedagem.
A maioria das instalações usa o servidor web Apache, disponível para download no seu site oficial. Entretanto, o MediaWiki já foi testado no IIS 7.0, Cherokee, Hiawatha, LiteSpeed, nginx (exemplo de configuração do nginx) , lighttpd, e Caddy.
PHP
PHP é a linguagem de programação na qual o MediaWiki foi escrito, e o componente PHP é exigido para o software funcionar.
Note que, embora o MediaWiki venha com um script de instalação, que fornece uma maneira de configurar seus módulos mais importantes pela web, é necessário conhecimento em PHP para personalizações mais detalhadas.
- Para a última versão estável do MediaWiki ou posterior, o ultimo PHP 7.3.19 é necessário. Consulte a página em Compatibilidade para mais informações.
- As seguintes extensões são necessárias:
Note que todas elas já estarão ativadas no PHP por padrão.
- O instalador do MediaWiki, avisará quando você não tiver a extensão do PHP intl opcional "para lidar com a normalização Unicode".
- Na maioria das distros baseadas no Debian/Ubuntu, ela estará no pacote php-intl.
- PHP OpenSSL extension também é recomendado. Ver Manual:$wgSessionInsecureSecrets.
- Na maioria das distros baseadas no Debian/Ubuntu, o pacote php-mysql é necessário se você quiser que o MediaWiki use o MySQL.
- Algumas funcionalidade do MediaWiki podem exigir funções PHP que executam processos externos, como a miniaturização de imagens, que alguns provedores de hospedagem baratos normalmente desativam. Isso veio à tona especialmente no MediaWiki 1.23 em uploads de arquivos (tarefa T68467). Por favor, leve isso em consideração se você pretende instalar o MediaWiki em um servidor compartilhado.
- Extensões MediaWiki podem exigir recursos adicionais PHP, por exemplo, o VisualEditor requer suporte libcurl (php-curl em distros baseadas no Debian/Ubuntu).
Se você precisar compilar o PHP do código-fonte, então veja a seção Configuração do PHP para opções de compilação que afetam o MediaWiki.
- Alguns servidores podem também exigir que o módulo de banco de dados equivalente e módulo de gestão de sessão estejam instalados. Veja as instruções individuais para cada sistema operacional para obter mais informações.
- Ao instalar no Windows usando o instalador da Microsoft, adicione a extensão para seu banco de dados escolhido (MySQL/MariaDB ou Postgres) para que os recursos sejam instalados.
Servidor de banco de dados
 Atenção: | O suporte ao Oracle e Servidor da Microsoft SQL não é mantido e foi descartado no MediaWiki 1.34. Você é fortemente desaconselhado a utilizá-los. |
O MediaWiki guarda todos os textos e dados (artigos, informações sobre o usuário, mensagens do sistema, etc.) num banco de dados, que pode ser compartilhado com outras aplicações web (phpBB, etc.). Você precisará de um dos servidores de banco de dados para rodar a versão mais atual do MediaWiki:
- MySQL 5.5.8+* ou MariaDB 5.1+
- PostgreSQL 9.2+ (suportado desde o MediaWiki 1.8) Consulet Manual:Instalando o MediaWiki#PostgreSQL para maiores detalhes.
- SQLite 3
Suportados no passado, atualmente não suportado:
- Oracle (não suportado nas últimas versões do MediaWiki devido a bugs de bloqueio aberto)
- O Microsoft SQL Server 2008 R2 ou posterior é suportado para edições Special:MyLanguage/Version lifecycle#Release policy e não há garantia que funcione para edições non-LTS (Requer o Microsoft Windows como sistema operacional porque ele usa o driver SQLSRV)
Certifique-se de que o módulo Full-Text esteja instalado.
Alguns usuários acham interessante instalar pacotes adicionais de software, como o phpMyAdmin (MySQL) ou o phpPgAdmin (Postgres) para ajudar a administrar o servidor de banco de dados.
Requisitos de hardware
Os requisitos mínimos recomendados são 256MB de RAM para um site hospedado em um único computador e 85MB de armazenamento, embora isso não seja suficiente para um site com um grande público ou que permita upload de arquivos. Alguns usuários informaram ter executado o MediaWiki em computadores com uma quantidade tão pequena quanto 48MB de RAM.
O tamanho instalação pode ser reduzido para cerca de 50MB para uma instalação de desenvolvimento, e cerca de 26MB para uma instalação não para desenvolvimento mas para o usuário final. Ver Manual:Reduce size of the installation.
Dependências opcionais
Outros softwares
- ImageMagick ou GD são exigidos para Image thumbnailing.
- TeX é exigido para mostrar fórmulas matemáticas. Na maioria das distros baseadas no Debian/Ubuntu, ele é o pacote
texlive. - Sendmail é exigido para permitir que o sistema envie e-mails.
- Shell access 'é necessário para executar Scripts de manutenção; O upgrade do MediaWiki pode ser mais difícil sem ele.
- GNU diff3 pode ser fornecido para resolver conflitos automaticamente.
Para mais informações sobre os itens acima, consulte Manual:Installing third-party tools.
VisualEditor
No MediaWiki versão 1.34 e anterior, a extensão VisualEditor (e também a extensão StructuredDiscussions (fluxo antigo)) exigia o serviço da web Parsoid, que foi implementado usando Node.js. O Node.js não está disponível para a maioria das empresas de hospedagem de sites(HostGator, Bluehost, Dreamhost, etc.). Por questões de desempenho e segurança, é melhor usar uma solução de hospedagem dedicada como um Virtual private server ("VPS").
Scribunto
Se você desejar chamar módulos Lua (veja eles neste wiki) de páginas e templates wiki, seu wiki necessitará também de Scribunto.
Ver também
- Compatibilidade, para obter informações sobre como os requisitos de instalação da Mediawiki provavelmente mudarão no futuro
- Pacotes de software