Manuale:Installazione MediaWiki

This page is a translated version of the page Manual:Installing MediaWiki and the translation is 33% complete.

MediaWiki si installa con uno script di installazione interattivo web-based. Prima di poter eseguire questo script, è necessario fare un paio di cose: vedere i prerequisiti oppure la breve guida all'installatione per esperti.

Per l'utente medio che non ha esperienza con Apache, PHP e MySQL l'installazione di MediaWiki può presentare delle difficoltà. La maggior parte degli utenti che desiderano utilizzare un software wiki possono trarre beneficio dall'utilizzo di un host MediaWiki gratuit oppure attraverso un software bundle.

Per informazioni sui messaggi di errore, vedi Manual:Errors and Symptoms#Installation Errors.

Download del software MediaWiki

Web browser

Scaricare il file tar MediaWiki dalla pagina ufficiale di download. Generalmente, se si utilizza un ambiente di produzione, si vuole eseguire l'ultima versione stabile, che è mediawiki-1.38.2.tar.gz.

Linea di comando (macchina con SO simil-Unix)

Per scaricare Mediawiki 1.38.2, che è la versione stabile più recente, su una macchina con sistema operativo simil-Unix è possibile utilizzare il seguente comando:

wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz

Come alternativa, utilizzare cURL:

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

I file scaricati sono nel formato .tar.gz, quindi è necessario decomprimerli prima dell'uso. Questo può essere fatto localmente (e poi caricato via FTP) oppure direttamente sul server in uso. In Windows puoi farlo con programmi come 7-Zip (libero), WinZip, WinRAR o IZArc (libero). Su Linux e Mac OS X, puoi decomprimere il file utilizzando questo comando:

tar -xf mediawiki-*.tar.gz
Se si decomprime l'archivio come root, probabilmente si dovrà cambiare successivamente l'utente proprietario delle archiviazioni con il comando chown, altrimenti i file finiranno per rimanere con l'utente proprietario # 1000, che probabilmente non è il risultato desiderato.


Git (per sviluppatori)

Gli sviluppatori d'altro canto dovrebbero scaricare da Git per creare un repository locale con il codice più recente in sviluppo.

Dovranno anche installare manualmente le dipendenze tramite Composer .

Caricare i file sul server

Se non ancora sono stati caricati i file sul web server, procedere ora.

Caricare i file nella directory web del server web tramite:

  1. Copiando direttamente la cartella decompressa oppure
  2. Mediante un client FTP come FileZilla (Software open Source, Windows, OSX e Linux) o Cyberduck (OSX).
  3. utilizzando cPanel File Manager (vedere sotto)

Se il tuo strumento per il caricamento ha un'opzione "modifica i nomi file in minuscolo", lo devi disabilitare.

Se hai installato Apache, la directory corretta è specificata nel file httpd.conf (è la direttiva DocumentRoot, che è normalmente $1 o <directory-apache>/htdocs). Nota: Questo è cambiato in Ubuntu 14.04 con Apache 2.4.7 dove il file di configurazione principale per le impostazioni del server Apache e delle directory è /etc/apache2/apache2.conf.

Se stai utilizzando un server Linux o Unix, puoi anche copiare i file su qualsiasi directory del server e dopo creare un link simbolico alla cartella dalla directory del server web.

Rename the uploaded folder to whatever you would like to have in the URL. If your web server is running as http://localhost for example, renaming to /w/ directory would mean you would access your wiki at http://localhost/w/index.php. Do not use /wiki/ if you want to use it as a Short URL. (And don't set up short URLs until you have run the installation script.)

Note that in certain cases, like when a local repository is set-up using Git, on browsing to index.php the Linux server might show the "500 Internal server Error". This is possibly a permissions error which can be resolved on changing the file and directory permissions by running the following command in SSH after changing directory to "w":
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

This (renamed) folder will now be referred as <MediaWiki-folder>.

cPanel File Manager

cPanel is a popular interface used by many web hosts. This method is efficient because the files are uncompressed on the server itself.

  • Navigate to the directory where you want your wiki folder.
  • Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
  • Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
  • Confirm that the mediawiki-1.xx.x folder is present.
  • Delete the tar.gz file.
  • Rename the mediawiki-1.xx.x folder to w.

Creare un database

If you already have a database server and know the root password for it, the MediaWiki installation script can create a new database for you. If this is the case, you can skip to the Run the installation script section below. If you don't know the root password, for example if you are on a hosted server, you will have to create a new database now. Currently, you must use SQLite, MariaDB/MySQL or PostgreSQL to store the actual contents of your wiki. If you're unsure which database to choose, use MariaDB as it is the one best supported by MediaWiki.

SQLite

SQLite is a stand-alone database library that stores the database contents in a single file. If PHP has the pdo-sqlite 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.

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

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 the example below — as follows:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
  Attenzione: MySQL/MariaDB on UNIX/Linux logs all queries sent to it to a file, which will include the password you used for the user account. If this concerns you, delete your .mysql_history file after running these queries. This file may be found in your home directory (~/.mysql_history).

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;

Run the installation script

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 Manual:Config script .

The installation tool will prompt you to download the LocalSettings.php file, and to save this as <MediaWiki-folder>/LocalSettings.php.

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

Further steps

These are optional but make your site look so much better.

Keep up to date!

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

Installation assistance

Vedi anche