Manual:Running MediaWiki on macOS/fr

L'environnement principal de MediaWiki est Linux et les systèmes Unix, Mac OS X en est assez proche, il n'est donc pas très difficile de l'installer sur cette plate-forme.

Apache
Le serveur apache est inclus avec Mac OS X. Il peut être trouvé dans les préférences système -> partage -> services. Apache est identifié sous le nom de partage web personnel. Cochez la case pour l'activer.

Noe de sécurité:

Par défaut, apache va autoriser tout le monde ayant qui ouvre une connexion à votre ordinateur. Si vous avez activé le pare-feu, il va obliger le port 80 a être ouvert pour pouvoir être accessible. Pour éviter des brèches, vous devez modifier la configuration d'apache.

MySQL

 * MySQL est préinstallé sous Mac OS X Server.

Pour que MediaWiki puisse fonctionner, vous aurez besoin de créer et de donner l'accès à une nouvelle base de données en exécutant les commandes suivantes (pour MySQL 5.0 et plus récentes) dans un terminal : mysqladmin -u root -p create wikidb mysql -u root -p -e "GRANT ALL PRIVILEGES ON wikidb.* TO wikiuser IDENTIFIED BY 'wiki_password'" mysql -u root -p -e "SET PASSWORD FOR wikiuser = OLD_PASSWORD('wiki_password')" mysql -u root -p -e "FLUSH PRIVILEGES" Remplacez 'wiki_password' par une chaine de votre choix, vous en aurez besoin lors de la configuration de MediaWiki. Des autres informations peuvent être trouvées ici.
 * Si vous utilisez la version client de Mac OS 10.4 ou antérieur, vous devez installer MySQL en faisant attention à l'architecture de votre ordinateur sur lequel vous voulez installer MediaWiki.
 * Mac avec processeur PowerPC (pas recommandé)
 * Téléchargez le paquet Complete MySQL. Il permet de configurer MySQL avec un panneau dans les préférences système. C'est un logiciel gratuit comme celui ci-dessous.
 * Si vous utilisez un ordinateur qui peut être accessible depuis n'importe où, alors déconnectez vous du réseau jusqu'à la fin de l'installation et de la configuration.
 * Il y a un programme d'installation dans l'image disquetéléchargée, lancez l'installation.
 * Le panneau doit être installé dans les préférences système, double-cliquez sur MySQL.prefPane dans l'image disque pour l'installer.
 * Cliquez sur "Initialize" (votre mot de passe peut vous être demand). Il est important de ne pas cliquer sur "Start" car il n'est pas encore totalement installé
 * Après avoir initialisé MySQL, vous pouvez cliquer sur "Start" (s'il y a une erreur, vérifiez les permissions du dossier /tmp, en tapant par exemple "sudo chmod 1777 /tmp" dans le terminal).
 * Fianlement, cliquez sur "Set Root Password". Le mot de passe actuel est vide, donc laissez le premier champ vide et entrez quelque chose dans les deux autres champ.
 * Information:
 * Vous aurez besoin de ce mot de passe pour le script d'installation de MediaWiki, rappelez-vous en.
 * Mac avec processeur PowerPC ou Intel (recommandé)
 * Le paquet d'installation 5.0 de mysql.com est préférable pour les versions 10.3 and 10.4, tandis que paquet d'installation 4.0 ne marche qu'avec 10.3. Ce sont les paquets "standard" de MySQL. La version .0 dispose d'un panneau de configuration tandis que la version 4.0 n'en a pas. La version 5.0 est recommandée.
 * De nouveau, si vous utilisez un ordinateur qui peut être accessible depuis n'importe où, alors déconnectez vous du réseau jusqu'à la fin de l'installation et de la configuration.
 * Dans la version 50 il y a deux paquets, un pour le serveur MySQL et un pour "StartupItem" (démarrage automatique avec l'ordinateur). Vous aurez besoin d'installer ces deux éléments. Avec la version 5.0, il y a également un pour le panneau de configuration, c'est également bien de l'installer.
 * Après l'installation vous aurez besoin de sécuriser les comptes par défaut sinon n'importe qui peut accéder à la base de données et la modifier comme il veut.
 * Créer la base de données


 * Dépannage
 * Si vous recontez des problèmes, essayez de déselectionner la case "Automatically Start MySQL on Startup", redémarrez votre ordinateur, et lancez MySQL manuellement.
 * Mettre MySQL à jour peut aussi poser problème, vérifiez s'il n'y a qu'un seul processus qui marche.

Mac OS 10.2 (jaguar)
PHP n'est pas installé par défaut. Cependant il n'existe plus de version pour jaguar déjà compilée, vous devrez la compiler vous-même.

Mac OS 10.3 (panther)
Notez que ces instruction n'expliquent pas comment installer PHP 5 qui est requis depuis la version 1.7 de MediaWiki. Vous devrez soit utiliser PHP 4 (et MediaWiki 1.6) ou compiler PHP 5.

Sur Mac OS X 10.3, PHP est installé par défaut mais pas activé. Si vous voulez utiliser GD library (voir plus bas), mais vous devrez réinstaller PHP mais GD library n'est pas recommandé, vous pouvez simplement activer PHP de la manière suivante :

Vous devez simplement modifier le fichier suivant :

Utilisez le terminal (qui se trouve dan Applications/Utilities), ouvrez un nouveau shell (command-N), et tapez :

ensuite :

ceci va ouvrir un simple éditeur de texte avec les commandes (^ veut dire la touche ctrl) au bas.

Décommentez (enlevez le #) au lignes qui contiennent

et

Quand vous tapez Control-X, le programme va vous demander si vous voulez sauver vous modification, tapez Y pour Oui. Vous pouvez quitter le programme et vos modifications sont sauvées. Si vous ne pouvez pas enregistrer le fichier tapez :

Ensuite, allez dans les préférences systèmes, arretez puis démarrez le partage web personnel (pour que le modifications soient prises en compte par apache).

Mac OS 10.4 Client (Tiger)
Sur Mac OS 10.4 Client (Tiger), PHP 4 est préinstallé mais n'est pas activé pour apache. PHP 5 n'est pas préinstallé. PHP 5.2 pour les macs PowerPC et Intel peut être trouvé à : http://www.entropy.ch/software/macosx/php/. Apache ne devrait pas avoir le module PHP 4 activé. S'il a été activé, il doit être désactivé. PHP 5.2 de entropy active automatiquement PHP 5.2. Le fichier se trouve à. Un lien est créé dans  qui pointe à.

Mac OS 10.4 Server (Tiger)
Sur Mac OS 10.4 Server (Tiger), PHP est préinstallé mais n'est pas activé. Pour l'activer utiliser l'interface Server Admin.

Dans Server Admin, aller à Web > Settings > Modules, déselectionnez php4_module, et cliquez sur Sauver.

Bibliothèques graphiques
Les vignettes d'imges créés par MediaWiki requierent soit ImageMagick ou GD library mais ne sont pas installées par défaut. Elles ne sont pasrequises (MediaWiki fonctionne aussi sans), mais elles permettent seulement la création de ces vignettes

Si vous n'êtes pas sur si elles sont installées, vous pouvez le voir lors de la configuration de MediaWiki.

GD library produit de moins bonnes vignettes que ImageMagick, la deuxième est donc recommandée. Notez que MediaWiki utilise GD library si les deux sont installées (il ne vaut donc mieux ne pas l'installer).

Si vous voulez utiliser ImageMagick bien que GD soit installé, modifiez LocalSettings.php après l'installation et changez les lignes suivantes : pour ceci : Vous n'avez pas besoin de le faire si GD n'a pas été activé lors de la configuration.

GD library
GD est inclus avec la version de PHP fournie par Entropy.

Si vous n'avez pas utiliser ce programme, vous pouvez essayer de l'installer par http://www.boutell.com/gd/.

ImageMagick
La meilleure manière d'installer ImageMagick est d'utiliser le programme de Entropy (le même site que pour PHP). Vous pouvez aussi l'installer par Fink ou DarwinPorts.

Configuration via le web

 * 1) Téléchargez les sources depuis Manual:Downloading MediaWiki/fr.
 * 2) Décompressez le dossier dans un endroit spécifique (C'est également bien de lire le fichier INSTALL.)
 * 3) Cliquez sur le dossier config de MediaWiki et tapez Pomme-i (voir les informations); puis faites en sorte que tout le monde puisse y écrire (ce dossier sera supprimé après l'installation).
 * 4) Mettez MediaWiki dans le dossier "Sites" de votre dossier de base.
 * 5) Aller à http://localhost/~nom_d'utilisateur_abregé/mediawiki/ (où nom_d'utilisateur_abregé est votre nom d'utilisateur abregé) Vous aller voir une page vous demandant de configurer MediaWiki (sinon vérifier que le partage web fonctionne).
 * 6) MediaWiki peut vous dire qu'il ne trouve pas GD ou ImageMagic, dans ce cas, vous plus haut.
 * 7) Suivez les instructions, voyez Manual:Config script/fr pour l'aide.
 * 8) Unless the version of your database is compatible with the version assumed in the mediawiki setup,  the above steps will produce an error about connecting to the database.  This results from an incompatibility in the password format stored in the mysql database.  You need to fix this problem by the following steps.
 * 9) run 'mysql' as the root mysql user (ie 'mysql -su root -p').
 * 10) type 'SELECT Host, User FROM mysql.user;'. You should get a list of hosts and users. Look for lines with wikiuser in them.
 * 11) type (for each host wikiuser has) 'SET PASSWORD FOR 'wikiuser'@'localhost' = OLD_PASSWORD('password');'.
 * 12) Connection errors may also occur if your mysql socket file mysql.sock is in an unexpected place. You will see Connecton failed next to SQL server host</tt> and error Can't connect to local MySQL server through socket '/var/mysql/mysql.sock'</tt>.  To fix this, you can modify your /etc/php.ini</tt> file (if you don't have one, you can create it from /etc/php.ini.default</tt>) so that mysql.default_socket</tt> points to the correct location.
 * 13) The configuration may also fail because no database for MediaWiki to read and write has been created. Please refer to the 'MySQL' section above.
 * 14) As prompted by the webpage, copy the LocalSettings.php</tt> file from the config</tt> folder up one level, to the mediawiki</tt> folder.
 * 15) Eventually, you should be led to http://localhost/~short_username/mediawiki and you should see a nice new wiki waiting to be populated.
 * 16) Once this is working, or if you give up and have to leave it for more than a few minutes, change the permissions of the config folder to prevent reading by anyone.  If the wiki is working, you may as well just delete this folder.

Mac OS X 10.4 Server (Tiger)
On Mac OS X 10.4 Server (Tiger), Apple provides an application to enable MySQL, set the root MySQL password, and start the MySQL service. You can find this app in /Applications/Server/MySQL Manager.app. See this article at Apple Support for more details.

If you're having trouble getting PHP to talk to MySQL, see article 301457 at Apple Support.

In the MediaWiki install web page, the MySQL server name must specify the fully qualified domain name of your server (change it from 'localhost' to your server's name, foo.bar.com).

<p style=color:#FF0000>Note: With MySQL 4.1 and above, you might run into the "Couldn't connect to database" error. This is due to the new authentication protocol in MySQL. The remedy is to reset the users which connect to the MySQL server (DB root, and after creation the DB user, wikiuser is the default name, as well) to use an old-protocol password, as described in the MySQL manual (Appendix A, chapter "Client does not support authentication protocol error"). In the longer term, MediaWiki should probably update its client library... MySQL manual page


 * <p style=color:#FF4444>I wonder if someone could write the requisite mysql commands here? I fear that the mysql steps are daunting (and uninteresting) enough to discourage folks who might otherwise to share interesting information using mediawiki.  Ideally, the mediawiki system itself should explain this, probably on that first setup webpage, but until that happens, perhaps we can help each other on this site ... --DK 23:01, 2005 July 29 (UTC)


 * <p style=color:#FF0000>In 10.4.4 (and following, I suppose) the following Terminal commands successful reestablish the link between MySQL and PHP:

$ sudo mkdir /var/mysql $ sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock
 * <p style=color:#FF0000>In 10.4.10 the directory /var/mysql and file /var/mysql/mysql.sock already exists and the link parameters had to be reversed for the link to be successful:

$ sudo ln -s /var/mysql/mysql.sock /tmp/mysql.sock


 * -Edonovan (from Wikipedia) 2006 March 30


 * In OS X 10.4.X Tiger, the preinstalled MySQL may also fail to recognize "localhost" as a valid host. In the web-based installer, try "servername.local" instead of "localhost", where servername=the computer name.  If you are using Server Admin, this is the same as the Local Hostname setting.  The web based installer for 1.5X and 1.6X through 1.6.7 will then fail at Initialising the Mediawiki namespace.  This is because it is trying to connect as the wikiuser defined by the installer, but it is attempting to use localhost.  Go into MySQL and change the host for the wikiuser and it will all work. MediaWiki should probably adjust the installer to create the wikiuser with the correct local hostname. -  JimHu 18:46, 23 June 2006 (UTC)

Securing/configuring Apache
Create a text file named " " in  (to see this folder you have to have hidden files made visible using the Terminal command - defaults write com.apple.Finder AppleShowAllFiles YES).

The file should contain the following lines (modify them as applicable!):

Alias /wiki "/Users/YOUR-HOME-FOLDER/Sites/mediawiki"

<Directory "/Users/YOUR-HOME-FOLDER/Sites/mediawiki"> Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny Allow from all </Directory>

<Directory "/Users/YOUR-HOME-FOLDER/Sites/mediawiki/upload"> AllowOverride None AddType text/plain .html .htm .shtml # php_admin_flag engine off # This doesn't seem to work. </Directory>

RewriteEngine on  RewriteRule ^/wiki/en/(.*)$ /mediawiki/wiki.phtml?title=$1

(You may have to create the above .../upload folder for file uploads to work.)


 * On 10.3, you can simply create.
 * On 10.2, you may need to add this line to the bottom of :

Include /etc/httpd/users/wiki.conf

That done, restart Apache. Restart it manually to make sure it reports any errors to you:

sudo apachectl restart

(If you restart it from the Sharing panel and there's a config error, it'll just sit there mute. Very annoying.)

Make sure that the .phtml extension is assigned to PHP as well as .php; there should be a line like this in the  file:

AddType application/x-httpd-php .php .phtml

Security note: Unless you've disabled uploads, do not forget to disable PHP in the upload directory.
 * '' Presumably the above  line is supposed to do this?

''
 * '' I think so. I made it work by removing the comment "#This doesn't seem to work".

''

Enabling uploads
Uploads are disabled by default for security reasons.

Before you do this, please make sure that your upload directory is configured in a safe manner so it's not possible to upload and execute arbitrary PHP code. Otherwise, someone could upload a PHP file, and might be able to do all sorts of horrible things like delete your entire website.

To enable uploads, uncomment the following line in LocalSettings.php</tt> and make sure it is set to true: You will also need to enable uploads from PHP; set the following in php.ini</tt> found in OS X 10.4 at /usr/local/php5/lib</tt> once PHP 5 has been installed: file_uploads = On

Earlier versions of MediaWiki included a bug that potentially allows logged- in users to delete arbitrary files in directories writable by the web server user by manually feeding false form data; this is now fixed.

To disable uploads, comment out or set the following option to false in LocalSettings.php</tt>: Notes: Some httpd.conf</tt> config files have this line by default: Alias /images/ /usr/share/images/ It will break the access to images/</tt> folder in MediaWiki. To prevent this, either change the default upload directory or remove this line.

Be sure that you can write to the directory- check ownership, permissions, and any other restrictions which could prevent you from writing to the directory in question (including PHP security settings such as open_basedir).

Enabling email
To send outgoing mail (inter-user messages and password reminders) a mail server needs to be running.

The mail server on 10.2 is sendmail, but is misconfigured in OS X client and won't run by default. 

On 10.3 postfix is the default mail server; this post on macosxhints.com tells how to enable it.

An alternative on OS X 10.3 is to use Postfix Enabler (shareware), which has a user-friendly Mac GUI.

Caveats

 * The HFS+ filesystem is not case-sensitive, but MediaWiki is in various places. There conceivably may be problems relating to this. However, with Mac OS X Server you can format a disk as Case-sensitive HFS+.
 * As with all other OS X software, it's probably a good idea to repair the permissions using Disk Utility once you're finished installing.
 * If your wiki is configured as Latin-1, you cannot upload images with non-ASCII characters in their file names (362).

Additional info
The following sections are advanced information and describe an alternative (not necessarily better) choice of a MediaWiki install tree. They are included here so that advanced users may obtain additional information about which files are relevant for what.

Alternative directory layout
On my machine I've installed them under /Library/MediaWiki like so:

/Library/MediaWiki/wiki.conf A bit of Apache configuration, see below

/Library/MediaWiki/php the *.php files from include/ and languages/ /Library/MediaWiki/cache /Library/MediaWiki/tmp <- temp files for TeX (?) For file cache and TeX temp files (if using). If using, must be writable by the www group.

/Library/MediaWiki/web Here's where the web-exposed stuff will go: wiki.phtml redirect.phtml LocalSettings.php style/ upload/ math/

Alternative Apache configuration
The 'wiki.conf' might look something like this:

Alias /wiki "/Library/MediaWiki/web"

<Directory "/Library/MediaWiki/web"> Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny Allow from all </Directory>

<Directory "/Library/MediaWiki/web/upload"> AllowOverride None AddType text/plain .html .htm .shtml php_admin_flag engine off </Directory>

RewriteEngine on  RewriteRule ^/wiki/en/(.*)$ /wiki/wiki.phtml?title=$1

MAMP
Pour une utilisation personnelle, il existe également MAMP, si vous utilisez Mac OS 10.4 ou plus récent (ou une ancienne version pour 10.3). Il permet d'avoir sa propre vesrion d'Apache, MySQL et PHP (avec eAccelerator (une version à jour de MMCache) et Zend Optimizer) et une interface graphique pour la configuration. Il fonctionne avec votre compte (en d'autres termes, il n'est pas fait pour un site public). Si vous n'utilisez pas le serveur apache inclus avec Mac OS X, vous pouvez l'utiliser sur le port 80.

Vous aurez besoin d'installer ImageMagic mais les autres choses sont avec. Le dossier web de MAMP est par défaut dans /Applications/MAMP/htdocs au lieu de l'habituel /Users/votrenom/Sites. Si vous voulez le modifier cliquez sur préférences puis sur le dernier onglet et choisissez l'emplacement voulu. En cliquant "Aller à la page d'accueil", votre navigateur va s'ouvrir à l'adresse http://localhost:8888/MAMP/ dans votre navigateur web.

L'installation de MediaWiki est simple.
 * 1) décompresser le fichier de MediaWiki
 * 2) Changer le nom pour mediawiki (par exemple)
 * 3) Changer les permissions du dossier config pour qu'il puisse être écrit par tout le monde
 * 4) Ouvrir http://localhost:8888/mediawiki/config/index.php
 * 5) Suivez les instructions et remplissez les champs
 * 6) Cliquez sur installer et patienter
 * 7) Déplacez le fichier LocalSettings.php du dossier config dans le dossier parent
 * 8) Supprimez le dossier config

C'est tout. Ouvrez http://localhost:8888/mediawiki/index.php. MediaWiki devrait fonctionner.

Sur Mac OS X 10.4 Tiger, vous pouvez faire en sorte qu'Apache et MySQL démarrent automatiquement au démarrage, voir ces instructions sur le forum de MAMP.

Support de TeX
Voir le fichier  fourni avec MediaWiki ou ici pour d'autres informations.

Quand vous l'avez ajouté, vous pouvez voir TeX pour les instructions pour utiliser un fond d'image transparent (mieux avec un arrière plan gris) et d'autres choses.

Dépannage
Voir la discussion.

Autres resources

 * Web Apps avec Tiger: MediaWiki
 * PHPmac - Compiler Turck MMCache avec PHP