J’utilise donc MacPort, un excellent gestionnaire de packages pour Mac OS X, qui permet de compiler et d’installer toutes sortes de logiciels open-source bien utiles.

La sortie récente de Mac OS X Lion, la nouvelle version du système d’exploitation d’Apple pour ordinateur, a été l’occasion de ré-installer complétement mon environnement LAMP…

Je vous propose ici un guide sur l’installation et la configuration d’Apache, MySQL et PHP avec MacPort…

Installation de votre environnement LAMP

Nous allons dans une premier temps procéder à l’installation d’Apache 2, MySQL 5 et PHP 5.3 et ses extensions. Pour cela, nous devons installer MacPorts 2.0…

Installation MacPorts 2.0

MacPorts 2.0 nécessite au préalable que les outils développeur Mac OS X Lion soient installés. Vous les obtiendrez en installant Xcode 4, disponible sur le Mac App Store d’Apple.

1. Téléchargez MacPorts 2.0 sur le site officiel
2. Ouvrez le fichier .dmg que vous venez de télécharger
3. Lancez le fichier .pkg et suivez les instructions

A noter que dans la suite de l’article, les commandes données sont à exécuter dans le terminal et en mode « super-admin », d’où le sudo au début des commandes.

Installation Apache 2

1. Téléchargez et installez Apache2 et ces dépendances :

   sudo port install apache2

2. Une fois l’installation terminée, vous pouvez activer lancement automatique de Apache au démarrage de l’ordinateur :

   sudo port load apache2

Installation MySQL 5

1. Téléchargez et installez MySQL 5 et ces dépendances :

   sudo port install mysql5

2. Installez/Activez le serveur MySQL 5 :

   sudo port install mysql5-server

3. Une fois l’installation terminée, vous pouvez activer le lancement automatique de MySQL au démarrage de l’ordinateur :

   sudo port load mysql5-server

4. Terminez l’installation de MySQL :

   sudo -u _mysql mysql_install_db5

5. Une fois l’installation terminée, vous pouvez lancer MySQL au démarrage de l’ordinateur :

   sudo port load mysql5

Installation PHP 5.3

1. Téléchargez et installez PHP 5.3 et ces dépendances. A noter ici que je choisi également d’activer le PEAR, d’où le +pear.

   sudo port install php5 +pear

2. Ajoutez le module PHP pour Apache 2 :

   sudo /opt/local/apache2/bin/apxs -a -e -n "php5" /opt/local/apache2/modules/libphp5.so

3. Créez le fichier de configuration php.inide PHP :

   sudo cp /opt/local/etc/php5/php.ini-development /opt/local/etc/php5/php.ini

4. Installez et activez MySQL pour PHP :

   sudo port install php5-mysql

5. Étape optionnelle : Installez quelques extensions utiles pour PHP (apc, curl, gd, iconv, mbstring, …).

   sudo port install php5-apc php5-curl php5-gd php5-iconv php5-intl php5-mbstring php5-mcrypt php5-posix php5-sqlite php5-xdebug php5-zip

Configuration de votre environnement LAMP

Les logiciels sont maintenant installés, reste à les configurer correctement…

Configuration Apache 2

Les étapes ci-dessous permettent de configurer le support de PHP dans Apache et d’activer le module UserDir (facultatif).

• Activer PHP dans Apache
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Ajoutez à la fin du fichier

     # Include PHP configuration
     Include conf/extra/mod_php.conf

• Ajouter index.php dans les pages d’index reconnues par Apache
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Recherchez la ligne ci-dessous :

     DirectoryIndex index.html

  3. Ajoutez sur la même ligne, à la fin :

      index.php

• Étape optionnelle : Activer l’extension UserDir pour Apache. Cette extension permet d’avoir des urls dédiées pour chaque utilisateur de l’ordinateur du type http://localhost/~utilisateur/
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Recherchez et décommentez la ligne ci-dessous :

     #Include conf/extra/httpd-userdir.conf

  3. Étape optionnelle : Autoriser l’ajout/suppression d’options via un .htaccess (exemple Options +FollowSymLinks)
     1. Éditez le fichier /opt/local/apache2/conf/extra/httpd-userdir.conf
     2. Recherchez la ligne ci-dessous :

        AllowOverride FileInfo AuthConfig Limit Indexes

     3. Ajoutez sur la même ligne, à la fin :

         Options

• Une fois les modifications effectuées, vous pouvez (re)démarrer Apache :

  sudo /opt/local/apache2/bin/apachectl restart

Configuration MySQL 5

Les étapes ci-dessous ont pour objectif de configurer et sécuriser votre serveur MySQL.

• Démarrez le serveur MySQL

  sudo /opt/local/lib/mysql5/bin/mysqld_safe &

• Sécurisez votre serveur MySQL. Je vous recommande de configurer le mot de passe root et de répondre « Yes » à toutes les questions.

  sudo /opt/local/lib/mysql5/bin/mysql_secure_installation

Configuration PHP 5

• Configurer MySQL pour PHP
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez les paramètres pdo_mysql.default_socket, mysql.default_socket, mysqli.default_socketet mettez comme valeur ceci :

     /opt/local/var/run/mysql5/mysqld.sock

• Configurer le fuseau horaire par défaut
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez la ligne suivante :

     ;date.timezone =

  3. Remplacez par :

     date.timezone = "Europe/Paris"

• Étape optionnelle : Activer les archives Phar
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez et décommentez la ligne ci-dessous

     ;phar.readonly = On

• Une fois les modifications terminées, redémarrez votre serveur Apache 2.

Bonus

Bonus #1 : Installation et configuration de PhpMyAdmin

Si vous souhaitez installer l’outil PhpMyAdmin afin d’administrer vos bases de données MySQL depuis une interface web, voici les étapes à suivre.

1. Installez PhpMyAdmin

   sudo port install phpmyadmin

2. Activez PhpMyAdmin dans Apache
   1. Créez le fichier /opt/local/apache2/conf/extra/mod_phpmyadmin.conf avec comme contenu ceci :

      AliasMatch ^/phpmyadmin(?:/)?(/.*)?$ "/opt/local/www/phpmyadmin$1"
      
      <Directory "/opt/local/www/phpmyadmin">
        Options -Indexes
        AllowOverride None
        Order allow,deny
        Allow from all
      
        LanguagePriority en de es fr ja ko pt-br ru
        ForceLanguagePriority Prefer Fallback
      </Directory>

   2. Éditez le fichier /opt/local/apache2/conf/extra/mod_php.conf
   3. Recherchez la ligne ci-dessous :

      </IfModule>

   4. Ajoutez au-dessus les lignes suivantes :

      # PhpMyAdmin configuration
      Include conf/extra/mod_phpmyadmin.conf

   5. Redémarrez Apache 2
3. Étape optionnelle : Utiliser l’authentification HTTP plutôt que par cookies
   1. Éditez le fichier /opt/local/www/phpmyadmin/config.inc.php
   2. Recherchez la ligne ci-dessous et remplacez cookie par http

      $cfg['Servers'][$i]['auth_type'] = 'cookie';

Bonus #2 : Restauration de base de données MySQL volumineuses

Si vous essayez d’importer une base de données assez volumineuses (plusieurs Mo), vous obtiendrez une message d’erreur de MySQL :

Got a packet bigger than ‘max_allowed_packet’

Pour éviter ce problème vous devez personnaliser le fichier de configuration de MySQL. Voici les étapes à suivre.

1. Créez le fichier de configuration

   sudo cp /opt/local/share/mysql5/mysql/my-medium.cnf /opt/local/etc/mysql5/my.cnf

2. Éditez le fichier /opt/local/etc/mysql5/my.cnf
3. Recherchez la ligne ci-dessous :

   max_allowed_packet = 1M

4. Remplacez par :

   max_allowed_packet = 16M

5. Redémarrez le serveur MySQL
6. Si vous obtenez toujours cette erreur, éditez à nouveau le fichier de configuration et augmentez la valeur de max_allowed_packet

Conclusion

Votre environnement LAMP est maintenant prêt et vous pouvez commencer ou prendre vos développements PHP/MySQL avec Mac OS X Lion en plaçant vos fichiers PHP dans votre dossier Sites…

J’en ai déjà parlé, la version de PHP fournie avec Mac OS X Leopard est assez… épurée : pas de GD ou de PEAR par exemple et la compilation d’extensions ne marchent pas (cf. mon billet sur Runkit). Pour une utilisation (très?) basique de PHP cela suffira mais si vous voulez, par exemple, manipuler des images il faudra utiliser une autre solution…

Parmi les autres solutions possibles, j’ai choisi d’utiliser MacPorts et de compiler « moi-même » PHP. Certains auraient peut-être choisi MAMP qui est une solution plus simple et plus « rapide » mais peut-on compiler des extensions avec ? A priori oui mais je n’en suis pas sûr. L’objectif est aussi de pouvoir installer d’autres packages que le trio Apache-MySQL-PHP et de mettre à jour ces packages très simplement (une ligne de commande).

Pour ceux que cela intéresse, voici la procédure pour installer et configurer Apache-MySQL-PHP avec MacPorts sur Leopard. A noter que je suppose que vous avez déjà installé les “Developper Tools” d’Apple.

Installation de MacPorts

1. Téléchargez MacPorts sur le site officiel : http://www.macports.org/
2. Ouvrez l’image disque (.dmg)
3. Lancez le .pkg et suivez les instructions.
4. Une fois l’installation terminée, allez dans le terminal et lancez la commande :

   sudo port selfupdate

Installation d’Apache 2.2

1. Installez Apache 2.2 en exécutant la commande qui suit dans le terminal :

   sudo port install apache2

2. Une fois l’installation terminée, lancez Apache :

   sudo /opt/local/apache2/bin/apachectl start

3. Si vous allez à l’adresse http://localhost vous devriez voir « It works! » à l’écran.
4. Si vous souhaitez qu’Apache soit lancé au démarrage de votre ordinateur, lancez la commande ci-dessous :

   sudo launchctl load -w /Library/LaunchDaemons/org.macports.apache2.plist

Configuration d’Apache 2

Maintenant qu’Apache 2 est installé, nous allons le configurer pour qu’il fonctionne comme la version d’Apache fournie avec Mac OS X Leopard.

1. Ouvrez le fichier /opt/local/apache2/conf/httpd.conf avec votre éditeur préféré.
2. Recherchez la ligne

   #Include conf/extra/httpd-userdir.conf

   et enlevez le caractère # au début.

3. Editez le fichier /opt/local/apache2/conf/extra/httpd-userdir.conf et ajoutez à la fin les lignes ci-dessous :

   #
   # Include user configurations
   #
   Include /etc/apache2/users/*.conf

4. Si vous souhaitez accéder au manuel d’Apache à l’adresse http://localhost/manual/ :
   1. Editez le fichier /opt/local/apache2/conf/httpd.conf
   2. Recherchez la ligne ci-dessous et enlevez le # au début.

      #Include conf/extra/httpd-manual.conf

5. Si vous souhaitez afficher la liste des éléments d’un dossier lorsqu’il n’y a pas de fichier index dedans :
   1. Editez le fichier /opt/local/apache2/conf/httpd.conf
   2. Recherchez la ligne la ligne ci-dessous et enlevez le # au début.

      #Include conf/extra/httpd-autoindex.conf

6. Relancez Apache :

   /opt/local/apache2/bin/apachectl restart

Installation et configuration de Mysql 5

1. Dans le terminal, lancez la commande suivante :

   sudo port install mysql5 +server

2. Une fois l’installation terminée, exécutez la commande :

   sudo -u mysql mysql_install_db5

3. Démarrez le serveur MySQL :

   sudo /opt/local/bin/mysqld_safe5 &

4. Sécurisez votre installation de MySQL :

   sudo /opt/local/bin/mysql_secure_installation5

5. Si vous voulez que MySQL soit automatiquement lancé au démarrage, lancez la commande suivante :

   sudo launchctl load -w /Library/LaunchDaemons/org.macports.mysql5.plist

Installation de PHP 5

1. Lancez l’installation de php5 :

   sudo port install php5 +apache2 +mysql5 +sqlite +pear

2. Une fois l’installation terminée, créez un fichier de configuration pour php (le php.ini) :

   sudo cp /opt/local/etc/php.ini-dist /opt/local/etc/php.ini

3. Installez le module php pour Apache :

   cd /opt/local/apache2/modules
   sudo /opt/local/apache2/bin/apxs -a -e -n "php5" libphp5.so

4. Editez le fichier /opt/local/apache2/conf/httpd.conf, recherchez

   DirectoryIndex index.html

   et remplacez par

   DirectoryIndex index.html index.php

5. Editez le fichier /opt/local/apache2/conf/httpd.conf et ajoutez à la fin les lignes suivantes :

   # Load the PHP module
   LoadModule php5_module modules/libphp5.so
   
   #
   # Include PHP configurations
   #
   Include conf/extras-conf/mod_php.conf

6. Relancez Apache :

   /opt/local/apache2/bin/apachectl -k restart

7. Vous pouvez maintenant créer dans votre dossier Sites (/Users/votrePseudo/Sites/) un fichier phpinfo.php

Voilà, votre environnement de développement AMP est installé et prêt à acceuillir vos scripts et applications ! Pour aller un peu plus loin, vous pouvez installer phpmyadmin et xdebug, avec MacPorts bien sûr.

Concernant MacPorts, je l’utilise depuis maintenant plusieurs mois et j’en suis très content. J’ai pu installer tous les packages dont j’avais besoin très simplement et sans problème. Je regrette juste de ne pas l’avoir découvert plus tôt…