Manuale: Requisiti d'installazione
Oltre al software MediaWiki stesso, è necessario:
- Un software web server per inviare le pagine MediaWiki al web browser.
- PHP per eseguire MediaWiki.
- Un server database per archiviare dati e pagine MediaWiki.
Inoltre, vi sono varie dipendenze opzionali che sono necessarie se desidera utilizzare certe funzioni avanzate (veda giù).
Se il vostro sito web è ospitato (cioè non ne avete il controllo diretto), contattate l'amministratore del server o la società di hosting per assicurarvi che questi pacchetti software siano installati e disponibili.
Per eseguire MediaWiki maintenance scripts, è necessario accedere alla riga di comando.
Installazione in un unico download
Se stai utilizzando Linux, è consigliabile installare il server web "Apache", "PHP" e il server di database "MariaDB" tramite il tuo gestore di pacchetti. Su Debian e Ubuntu, esegui il seguente comando:
sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-apcu php-curl php-mysql php-xml
- Pacchetti software
Su altri sistemi operativi, utilizza un pacchetto software come XAMPP di https://www.apachefriends.org per installare e configurare tutti i pacchetti principali – il server web Apache, PHP e MariaDB – con un unico download. È disponibile per Linux, Windows e Mac. A partire da maggio 2025, l'ultima versione di XAMPP include PHP 8.2 (MediaWiki richiede almeno 8.3.0).
In alternativa, se utilizzi macOS, puoi usare MAMP, che è l'equivalente di XAMPP. MAMP include la possibilità di eseguire il server web Apache e un database MySQL. È disponibile sia per Windows che per Mac, ma viene generalmente utilizzato su Mac invece che su Windows.
Server Web
Per passare le pagine al browser, MediaWiki necessita di un web server. Spesso non si ha la possibilità di scegliere quale software utilizzare; sarà quello fornito dal proprio fornitore del servizio di hosting.
MediaWiki è ampiamente compatibile con tutti i principali server web in grado di eseguire una versione compatibile di PHP. La maggior parte delle installazioni utilizza Apache HTTPD web server. Anche Nginx (configuration example) è una buona scelta.
PHP
PHP è il linguaggio di programmazione in cui è scritto MediaWiki ed è richiesto per far girare il software.
- Per l'ultima versione di MediaWiki, è richiesto almeno PHP 8.3.0 Consulta la pagina su Compatibilità per ulteriori informazioni.
- Le seguenti estensioni core di PHP sono richieste (solitamente sono compilate come parte di PHP stesso): calendar, ctype, dom, fileinfo, iconv, json, openssl, sodium, xml, xmlreader. Verifica l'output di
php -mper determinare quali estensioni sono attualmente attive nella tua particolare configurazione. - Sono inoltre required le seguenti estensioni core di PHP:
- In aggiunta a quelle obbligatorie, le seguenti estensioni sono raccomandate:
MediaWiki richiede solo le estensioni PHP che sono abilitate in PHP per impostazione predefinita. Se il tuo provider di hosting offre un ambiente LAMP di base senza queste estensioni, potrebbe essere necessario installarle o abilitarle manualmente.
- Su Debian/Ubuntu, esegui il seguente comando per installare tutte le estensioni PHP consigliate sopra:
sudo apt-get install php php-intl php-mbstring php-apcu php-curl
- Su Debian/Ubuntu, esegui il seguente comando per installare tutte le estensioni PHP consigliate sopra:
- Presso i provider di hosting con un pannello di controllo come cPanel, puoi spesso utilizzare "Select PHP Version" (PHP Selector) per abilitare queste estensioni. (Ad esempio, dopo aver visualizzato il messaggio "Manca un'estensione richiesta da PHP necessaria per l'esecuzione di MediaWiki. Installa: intl")
- Sulla maggior parte delle distribuzioni basate su Debian/Ubuntu, il pacchetto
php-mysqlè necessario se vuoi che MediaWiki utilizzi MySQL. - Alcune funzionalità di MediaWiki possono richiedere l'uso di funzioni PHP che eseguono processi esterni, ad esempio per la generazione delle miniature delle immagini; tali funzioni vengono spesso disabilitate dai provider di hosting a basso costo. Tieni presente questo aspetto se prevedi di installare MediaWiki su un server condiviso.
- Le estensioni di MediaWiki potrebbero richiedere funzionalità PHP aggiuntive; ad esempio, VisualEditor richiede il supporto per libcurl (
php-curlnelle distribuzioni basate su Debian/Ubuntu).
Se devi compilare PHP dal codice sorgente, consulta Configurazione di PHP per conoscere le opzioni di compilazione rilevanti per MediaWiki.
Server di database
MediaWiki archivia tutto il testo ed i dati in un database, che sia capace di condividere i dati con altre applicazioni web come PHPBB. Ti serve uno dei seguenti database per poter far girare MediaWiki:
È consigliato l'uso di MariaDB o MySQL, poiché Wikimedia utilizza MariaDB. Qualsiasi altro server di database è stato testato meno approfonditamente e potrebbe quindi presentare alcuni bug.
Hardware richiesto
L'hardware minimo richiesto è di 256MB di RAM per il sito su un computer singolo con 40MB di storage, sebbene questo non sia possibile per un sito pubblico trafficato con l'upload abilitato. Alcuni utenti sono riusciti a far partire MediaWiki su computer con 48MB di RAM.
Dipendenze opzionali
ImageMagick o GD sono necessari per la miniaturizzazione delle immagini.
- L'accesso alla shell è necessario per eseguire Maintenance scripts; senza di esso, l'aggiornamento di MediaWiki potrebbe risultare più difficile.
- L'invio di notifiche e-mail tramite il server stesso richiede un agente di trasferimento della posta (MTA).
- GNU diff3 può essere usato per la risoluzione automatica dei conflitti.
- memcached può essere utilizzato per la cache degli oggetti.
Vedere anche
- Compatibilità, per informazioni sulle probabili evoluzioni future dei requisiti di installazione di MediaWiki.
- Manual:OS specific help