Je profite de petits tests effectués avec cinq installations de PHP différentes (mod_PHP, FastCGI, FCGI, PHP-FPM avec Apache2 et enfin PHP-FPM avec Nginx) pour compléter mes propos. Ces tests, non exhaustifs montrent aussi l’influence du cache d’Opcode sur les performances du serveur Web.

1. Les tests

La procédure

Les tests ont été effectués sur une même machine virtuelle sous Debian 5 (+ Dotdeb pour PHP 5.3.3). La VM est dotée de 2Go de RAM, de 2 coeurs de processeur Intel Xeon E5430 @2.66 GHz et stockée sur des disques dur SAS 15K tr/min en RAID 10. Pour chaque installation de PHP, j’ai effectué les tests avec le cache d’opcode APC désactivé, puis activé (avec une configuration par défaut) et enfin activé avec la directive « stat » à 0.

Le test consiste à requêter 1000 fois (avec 10 connexions concurrentes) les « ressources » suivantes :

• une page statique (contenant le html d’une page phpinfo)
• une page PHP, un simple phpinfo()
• un « hello Sf2″ sous Symfony2 (Sandbox)

et sur une des installations seulement :

• la page d’acceil d’un WordPress 3 (installation de base)

Chaque test est répété 3 fois de suite.

PHP-CGI avec Apache2, mpm-worker, suEXEC, FCGID

Apache2 est installé avec le MPM Worker, avec suEXEC pour gérer les utilisateurs Web par hôte virtuel. Notre configuration de FCGID limite le nombre de processus parents à 10 et 0 processus enfant.

=> Avec FCGID, le cache d’opcode est dans ce cas multiplié par le nombre de processus parents quelque soit l’utilisateur web propriétaire du processus.

PHP-CGI avec Apache2, mpm-worker, suEXEC, FastCGI

Apache2 est installé avec le MPM Worker, avec suEXEC pour gérer les utilisateurs Web par hôte virtuel. Notre configuration de FastCGI limite le nombre de processus parents à 1, PHP gère les processus enfant dans une limite de 10.

=> Avec FastCGI, en limitant le processus parent à 1, le cache d’opcode est unique par utilisateur web et partagé entre processus enfants.

PHP-FPM avec Apache2, FastCGI

Apache2 est installé avec le MPM Worker, PHP-FPM gère totalement les processus PHP.

=> Avec PHP-FPM, le cache d’opcode est unique et partagé entre tous les utilisateurs « web » gérés par PHP-FPM.

PHP en module d’Apache, avec Apache2, mpm-prefork

Apache2 est installé avec le MPM Prefork et PHP en module.

=> Avec PHP en module d’Apache, le cache d’opcode est unique, il n’y a de toute façon qu’un seul utilisateur, celui du serveur Web.

PHP-FPM, Nginx

Par curiosité, parce que j’entends très souvent parlé de Nginx pour ces performances, j’ai voulu comparer non pas le comportement de l’Opcode puisque celui-ci est identique à une installation PHP-FPM sous Apache2, mais plutôt voir comment Nginx s’en sortait par rapport à Apache2.

2. Conclusion

Les différents tests m’ont permis de montrer l’importance du cache d’Opcode sur des solutions faisant appel à de nombreux fichiers comme les frameworks (ici Symfony2). Dans ce cas, on notera aussi une influence sur le paramétrage du cache d’opcode. En effet, en désactivant la surveillance de mise à jour des fichiers sources (APC stat à 0), les performances grimpent encore. Passer stat à 0 peut aussi conduire à de drôles de comportement si vous le faite sans en comprendre réellement la portée. Dans le cas de la page d’accueil de WordPress 3, cette fonctionnalité n’a plus aucun effet, le système semble complètement étranglé par l’accès aux données. En dehors de l’influence du cache d’opcode sur les performances, on notera aussi la manière dont celui-ci est partagé entre utilisateur « web ».

Malgré une duplication certaine du cache d’opcode, l’installation FCGID offre des performances légèrement meilleures que celles de l’installation FastCGI. Cependant, cette situation de multiplication du cache peut entrainer des fonctionnements assez aléatoires, la consommation de RAM peut aussi s’envoler. L’installation en FCGID est à mon avis déconseillée, du moins pour utiliser le cache d’Opcode. En léger retrait, l’installation avec FastCGI est efficace si l’on veut mutualiser plusieurs comptes sur un serveur de manière sécurisée. PHP-FPM est une très bonne solution si l’on garde bien en tête que le cache d’Opcode est partagé entre les utilisateurs « web ». C’est PHP en module d’Apache qui offre les meilleurs performances, mais par rapport aux autres installations, elle n’offre pas le même niveau de sécurité (cela se paye aussi en terme de performance), les processus PHP sont contenus dans les processus Apache qui deviennent lourds.

Pour finir et sans rapport réel avec le comportement de l’Opcode, le test de PHP-FPM avec Nginx montre que s’il n’y a pas photo sur le statique, côté PHP, c’est équivalent à Apache2. Bon, ce n’est qu’un simple constat, sur la base de mes tests. Je ne connais pas Nginx, et je m’attendais à quelque chose de différent pour PHP… Allez, encore un sujet à explorer.

N’hésiter pas à me faire part de vos expériences, de vos remarques.

Les billets suivant peuvent vous intéresser :

• En savoir plus sur le cache d’Opcode APC
• Installer PHP-FPM sous Apache2

La dernière version de PHP, la 5.3.3 inclus nativement FPM. Autrefois appliqué comme patch à PHP, le gestionnaire de processus Fastcgi « FPM » apporte aussi quelques améliorations à PHP Cgi. Pour le tutoriel, l’installation va se dérouler sur une Debian 5 (lenny) ou 6 (squeeze). Le paquet PHP5-FPM nous est fourni par le dépôt de sources Dotdeb.

Note de révision du 4 septembre 2010 : l’utilisation de wrapper suEXEC pour attribuer un « utilisateur / groupe » par hôte virtuel n’est pas justifiée. PHP-FPM joue ce rôle.
Note de révision du 6 octobre 2010 : correctifs de quelques typos. Contenus remaniés.
Note de révision du 10 février 2011 : correctifs de la configuration de fast-cgi et du vhost, directives inutiles supprimées.
Note de révision du 20 mars 2011 : installation fonctionnelle sous Debian 6 (Squeeze)
Note de révision du 18 avril 2011 : correctifs pour compatibilité avec la dernière version du package Dotdeb de PHP-FPM (5.3.6).
Note de révision du 03 juillet 2011 : ajout du réglage du timeout FastCGI.
Note de révision du 03 mars 2012 : installation compatible avec PHP 5.4

1. Apache 2 Multi-threadé

Nous choisissons d’installer Apache en MPM Worker. Pour une installation de PHP en module d’Apache, il est clairement déconseillé d’utiliser ce MPM. D’autres MPM (multi-processing module) existent, si vous voulez en savoir plus, vous pouvez consulter une série de billets portant sur l’installation sécurisée de PHP dans laquelle Stuart Herbert en teste quelques-uns.

Installer Apache2 sur Debian en invoquant simplement la commande :

aptitude install apache2 apache2-mpm-worker

2. sécuriser avec suEXEC

Contrairement à ce que je disais dans la première version du billet, nous n’avons pas besoin du wrapper suEXEC pour attribuer un « utilisateur / groupe » par hôte virtuel, PHP-FPM s’en charge. L’installation de suEXEC n’est pas nécessaire, les directives de configurations s’en trouvent simplifiées.

3. le module FastCGI

Nous avons maintenant besoin d’installer le module « FastCGI » d’Apache. En effet, contrairement à « FCGID » (gestionnaire de processus plus moderne et souvent associé à l’installation de PHP en CGI), « FastCGI » fourni la directive permettant de préciser un gestionnaire externe de processus CGI, dans notre cas PHP5-FPM. « libapache2-mod-fastcgi » est un paquet de la section « non-free » (paquets qui ne respectent pas les DFSG). Vos sources de paquets doivent comprendre cette section pour pouvoir installer le module FastCGI. En fonction de votre distribution, remplacer lenny par squeeze au besoin.

deb ftp://mir1.ovh.net/debian/ lenny main contrib non-free
deb-src ftp://mir1.ovh.net/debian/ lenny main contrib non-free

deb http://security.debian.org/ lenny/updates main contrib non-free
deb-src http://security.debian.org/ lenny/updates main contrib non-free

Installez le module,

aptitude install libapache2-mod-fastcgi

Modifions le fichier de configuration du module « fastgci » d’Apache

nano /etc/apache2/mods-available/fastcgi.conf

<IfModule mod_fastcgi.c>
  AddHandler php5-fcgi .php
  Action php5-fcgi /cgi-bin/php5.external
  <Location "/cgi-bin/php5.external">
    Order Deny,Allow
    Deny from All
    Allow from env=REDIRECT_STATUS
  </Location>
</IfModule>

Activons les modules « fastcgi » et « actions » (utilisé dans le fichier de configuration de FastCGI).

a2enmod fastcgi actions

4. Installation PHP5-FPM

Comme précisé en début de billet, PHP5-FPM est fourni par le dépôt Dotdeb. PHP5-FPM, c’est à la fois PHP5 et un gestionnaire de processus FastCGI. Une fois Dotdeb ajouté à vos sources, l’installation s’effectue simplement :

aptitude install php5-fpm

Vous pouvez compléter l’installation de PHP5 en ajoutant diverses librairies dont le gestionnaire de cache d’Opcode APC :

aptitude install php5-mysql php5-mcrypt php5-curl php5-gd php5-xsl php5-xmlrpc php5-apc

Les fichiers de configuration sont situés dans :

/etc/php5/fpm/

Depuis la version 5.3.6 du package Dotdeb, vous n’avez plus à modifier le fichier de configuration de PHP5-FPM afin de pouvoir définir la configuration des pools de processus PHP en dehors de ce fichier (la directive d’inclusion des définitions de « pool » est faite en fin de fichier) :

nano /etc/php5/fpm/php-fpm.conf

;;;;;;;;;;;;;;;;;;;;;
; FPM Configuration ;
;;;;;;;;;;;;;;;;;;;;;

; All relative paths in this configuration file are relative to PHP's install
; prefix (/usr). This prefix can be dynamicaly changed by using the
; '-p' argument from the command line.

; Include one or more files. If glob(3) exists, it is used to include a bunch of
; files from a glob(3) pattern. This directive can be used everywhere in the
; file.
; Relative path can also be used. They will be prefixed by:
;  - the global prefix if it's been set (-p arguement)
;  - /usr otherwise
;include=/etc/php5/fpm/*.conf

;;;;;;;;;;;;;;;;;;
; Global Options ;
;;;;;;;;;;;;;;;;;;

[global]
; Pid file
; Note: the default prefix is /var
; Default Value: none
pid = /var/run/php5-fpm.pid

; Error log file
; Note: the default prefix is /var
; Default Value: log/php-fpm.log
error_log = /var/log/php5-fpm.log

; Log level
; Possible Values: alert, error, warning, notice, debug
; Default Value: notice
;log_level = notice

; If this number of child processes exit with SIGSEGV or SIGBUS within the time
; interval set by emergency_restart_interval then FPM will restart. A value
; of '0' means 'Off'.
; Default Value: 0
;emergency_restart_threshold = 0

; Interval of time used by emergency_restart_interval to determine when
; a graceful restart will be initiated.  This can be useful to work around
; accidental corruptions in an accelerator's shared memory.
; Available Units: s(econds), m(inutes), h(ours), or d(ays)
; Default Unit: seconds
; Default Value: 0
;emergency_restart_interval = 0

; Time limit for child processes to wait for a reaction on signals from master.
; Available units: s(econds), m(inutes), h(ours), or d(ays)
; Default Unit: seconds
; Default Value: 0
;process_control_timeout = 0

; Send FPM to background. Set to 'no' to keep FPM in foreground for debugging.
; Default Value: yes
;daemonize = yes

;;;;;;;;;;;;;;;;;;;;
; Pool Definitions ;
;;;;;;;;;;;;;;;;;;;;

; Multiple pools of child processes may be started with different listening
; ports and different management options.  The name of the pool will be
; used in logs and stats. There is no limitation on the number of pools which
; FPM can handle. Your system will tell you anyway :)

; To configure the pools it is recommended to have one .conf file per
; pool in the following directory:
include=/etc/php5/fpm/pool.d/*.conf

Le répertoire des définitions des pools de processus PHP est automatiquement créé :

cd /etc/php5/fpm/pool.d/

Par défaut, un exemple de pool est fourni, vous pouvez le renommer et le garder comme exemple.

mv www.conf www.conf.dist

Créez un fichier de définition de pool de processus PHP :

nano /etc/php5/fpm/pool.d/first.conf

; Nom du pool
[firstweb]
; On utilisera une socket
listen = /home/www/.socks/firstweb.sock

; Permission pour la socket
listen.owner = firstweb
listen.group = webgroup
listen.mode = 0666

; Utilsateur/Groupe des processus
user = firstweb
group = webgroup

; On choisira une gestion dynamique des processus
pm = dynamic

pm.max_children = 20
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 10

slowlog = /var/log/php5-fpm.firstweb.log.slow

; Quelques directives de configuration de PHP
php_admin_value[open_basedir]=/home/www/firstweb/public_html
php_admin_value[session.save_path]=/home/www/firstweb/tmp
php_admin_value[upload_tmp_dir]=/home/www/firstweb/tmp

Créez le répertoire des sockets :

mkdir -p /home/www/.socks

5. Définition de l’hôte virtuel

nano /etc/apache2/sites-available/firstweb

<VirtualHost *:80>
        ServerName firstweb.example.com
        ServerAdmin     firstweb@example.com
        DocumentRoot /home/www/firstweb/public_html
        Options None

        # Fast CGI + FPM
        FastCgiExternalServer /home/www/firstweb/cgi-bin/php5.external -socket /home/www/.socks/firstweb.sock
        Alias /cgi-bin/ /home/www/firstweb/cgi-bin/

        <Directory /home/www/firstweb/public_html>
                Options SymLinksIfOwnerMatch
                AllowOverride All
                Order allow,deny
                Allow from all
        </Directory>

        # Log
        ErrorLog /var/log/apache2/error-firstweb.log
        LogLevel warn
        CustomLog /var/log/apache2/access-firstweb.log combined
</VirtualHost>

Par défaut, le timeout FastCGI est de 30 secondes, si vous souhaitez modifier cette valeur, il suffit de modifier la ligne suivante du vhost et ajouter l’argument -idle-timeout suivi de la valeur du timeout en secondes. Vous pouvez donc préciser cette valeur indépendamment pour chaque vhost.

FastCgiExternalServer /home/www/firstweb/cgi-bin/php5.external -socket /home/www/.socks/firstweb.sock -idle-timeout 60

Le fichier « /home/www/first/cgi-bin/php5.external » précisé par la directive « FastCgiExternalServer » n’a pas besoin d’exister.
Activez cet hôte virtuel :

a2ensite firstweb

Créez le groupe et l’utilisateur web :

groupadd webgroup
useradd -b /home/www -g webgroup  -s /bin/false firstweb

Passez à la création de l’espace « Web » correspondant à la définition de l’hôte virtuel. Pour l’exemple, sa structure est la suivante :

mkdir -p /home/www/firstweb/public_html
mkdir -p /home/www/firstweb/cgi-bin
mkdir -p /home/www/firstweb/tmp

Le répertoire parent « firstweb » appartient à « root:root », les répertoires enfants à « firstweb:webgroup ».

Rechargez Apache, démarrez PHP5-FPM

/etc/init.d/apache2 reload
/etc/init.d/php5-fpm start

Un phpinfo() au niveau de cet hôte virtuel devrait vous donner les informations similaires à :

Sur une Debian Squeeze fraîchement installée :

Avec PHP 5.4 :

6. Côté cache d’opcode

Avec ce type d’installation, la gestion du cache d’Opcode fonctionne correctement mais il faut garder à l’esprit que le cache est partagé entre tous les hôtes virtuels. La totalité du cache peut donc être effacée à partir de n’importe quel hôte. C’est exactement la même chose avec une installation en module d’Apache (mod_php).

Une autre solution permet d’avoir du cache par utilisateur, en utilisant FastCGI + PHP CGI. Cependant, il faut jouer avec le nombre de processus parent / enfants, car les processus parents ne partagent pas leur cache. Avec FCGID, le problème est similaire sauf qu’on ne peut pas limiter le nombre de processus parent à 1, les performances deviennent alors désastreuses. FCGID et FastCGI ne traitent pas les requêtes PHP de la même manière, voir les remarques sur Fcgid avec PHP CGI :

Special PHP considerations
[...]
The popular APC opcode cache for PHP cannot share a cache between PHP FastCGI processes unless PHP manages the child processes. Thus, the effectiveness of the cache is limited with mod_fcgid; concurrent PHP requests will use different opcode caches.

Le temps me manque pour effectuer des tests de ces différentes configurations avec la problèmatique de cache d’Opcode. En tout cas, n’hésitez pas à me faire part de vos remarques.

Depuis peu, le projet phpMyAdmin est passé sous Git et les branches SVN ne sont plus mises à jour. Contrairement à l’utilisation d’archives, l’utilisation d’un système de gestion de sources va nous permettre de maintenir simplement notre phpMyAdmin.

Copie du dépôt phpMyAdmin

Récupérez le dépôt Git de phpMyAdmin en lançant la commande suivante dans un répertoire vide :

git clone -n git://github.com/phpmyadmin/phpmyadmin.git .

Installation d’une version particulière

Pour l’exemple, nous allons installer sur la version 3.3.4, il suffit de lancer la commande :

git checkout RELEASE_3_3_4

Mettre à jour le dépôt

Pour récupérer les dernières mises à jour, exécutez la commande :

git fetch

Installer une autre version

La version 3.3.5 est sortie, installons la :

git checkout RELEASE_3_3_5

Pour connaître les différents « tags » :

git tag

Les différentes branches (remote) :

git branch -r

Si vous ne voulez pas spécifier à chaque fois la version à utiliser, choisissez directement la branche « STABLE », une simple mise à jour du dépôt suffira à mettre à jour votre phpMyAdmin.

git checkout STABLE (une première fois)
git pull (à chaque mise à jour)

Restez informés au sujet de la sécurité de phpMyAdmin et des nouvelles releases.

1. Installation d’Eclipse Classic

La première chose à faire est donc de télécharger Eclipse Classic 3.5.0 (Mac Cocoa 64bit).
Une fois l’archive d’Eclipse décompressée, lancer Eclipse.

2. Installation du plugin PDT

Pour installer PDT, utilisez le menu « Help > Install New Software… ».

Allez dans « Available Software Sites », tapez « pdt » au niveau du filtre puis rendez « active » (Enabled) l’adresse suivante http://download.eclipse.org/tools/pdt/updates/2.0/ puis cliquez sur « ok ».

Dans la section PDT SDK 2.1.2, sélectionnez « PHP Development Tools (PDT) Runtime Feature » puis valider l’installation en cliquant sur « finish ».

Une fois le plugin installé, redémarrez Eclipse quand il vous le suggérera.

Voilà, vous disposez d’une version Cocoa-64bit d’Eclipse avec PDT.

3. Compléments d’installation

3.1. Subclipse, client SVN

Comme pour installez PDT, utilisez le menu d’Eclipse « Help > Intall New Software…  » :

Tapez l’url suivante "http://subclipse.tigris.org/update_1.6.x"

Selectionnez les différents composants à installer (tous ici, mais ce n’est pas obligatoire) :

Redemarrez Eclipse après l’installation du plugin.

3.2. Mylyn, gestion de tâches

Pour allez plus loin, nous pouvons compléter l’installation par le plugin Mylyn, qui nous permettra d’intégrer une gestion de tâches (Bugzilla, Trac, JIRA, Redmine) au sein de l’IDE.

Utilisez le menu « Help > Install New Software… ».

Tapez « mylyn » au niveau du champ « work with », selectionnez l’adresse "http://download.eclipse.org/tools/mylyn/update/e3.4", et cochez les composants comme ci-dessous.

Comme pour toute installation de plugin, redémarrez Eclipse.

Vous disposez maintenant d’une version comparable à celle fournie par Eclipse PDT All In Ones, mais en utilisant Cocoa-64bit.

La configuration du client SSH d’un utilisateur est décrite dans le fichier situé dans le répertoire de l’utilisateur et plus exactement dans le répertoire caché « .ssh ».

nano ~/.ssh/config

Voici un exemple de configuration :

# user1@server1
Host server1
 HostName server1.exemple.com
 User user1
 IdentityFile ~/.ssh/server1.user1.id_rsa

 # user1@server2
Host server2
 HostName server2.exemple.com
 User user1
 IdentityFile ~/.ssh/server2.user1.id_rsa

# user2@server3
Host server3
 HostName server3.exemple.com
 User user2
 IdentityFile ~/.ssh/server3.user2.id_rsa

J’ai choisi de préfixer le nom des clés privées par le nom du serveur suivi du nom de l’utilisateur afin de m’y retrouver facilement. Appliquez un chmod 600 sur les clés privées. Il est ensuite bien plus simple de se connecter en SSH aux différents serveurs :

// Avant la configuration du client SSH :
ssh -i ~/.ssh/server1.user1.id_rsa user1@server1.exemple.com
// Après la configuration :
ssh server1

Note du 22/10/2010 :

Avec trop de clés privées, il y a un risque d’avoir un échec d’authentification (problème constaté pour ma part). L’ensemble des clés chargées par l’agent sont testées lors de l’authentification. Pour éviter cela, il suffit d’ajouter cela à votre fichier de config :

Host *
  IdentitiesOnly yes

En by-passant l’agent, le mot de passe vous sera redemandé à chaque fois.

Dans ce billet, nous partons d’une installation d’Apache 2.2 réalisée sur Mac en utilisant MacPorts. En dehors de certains chemins propres à l’exemple, ce billet pourra être utile quelque soit l’origine de l’installation et la plateforme sur laquelle Apache est installé.

Modules chargés par Apache

Par défaut, Apache va charger une longue liste de modules. Sur l’ensemble de ces modules, seuls certains nous intéressent, nous allons désactiver le chargement des autres :

Éditez le fichier de configuration d’Apache :

# Le fichier de configuration d'Apache (installé via MacPorts)
sudo nano /opt/local/apache2/conf/httpd.conf
# Recherchez le bloc de ligne commençant par "LoadModule"
# La liste est longue !!!
LoadModule authn_file_module modules/mod_authn_file.so
LoadModule authn_dbm_module modules/mod_authn_dbm.so
LoadModule authn_anon_module modules/mod_authn_anon.so
LoadModule authn_dbd_module modules/mod_authn_dbd.so
LoadModule authn_default_module modules/mod_authn_default.so
LoadModule authz_host_module modules/mod_authz_host.so
LoadModule authz_user_module modules/mod_authz_user.so
LoadModule authz_dbm_module modules/mod_authz_dbm.so
LoadModule authz_owner_module modules/mod_authz_owner.so
LoadModule authz_default_module modules/mod_authz_default.so
LoadModule auth_basic_module modules/mod_auth_basic.so
LoadModule auth_digest_module modules/mod_auth_digest.so
LoadModule file_cache_module modules/mod_file_cache.so
LoadModule cache_module modules/mod_cache.so
LoadModule disk_cache_module modules/mod_disk_cache.so
LoadModule mem_cache_module modules/mod_mem_cache.so
LoadModule dbd_module modules/mod_dbd.so
LoadModule dumpio_module modules/mod_dumpio.so
LoadModule ext_filter_module modules/mod_ext_filter.so
LoadModule include_module modules/mod_include.so
LoadModule filter_module modules/mod_filter.so
LoadModule substitute_module modules/mod_substitute.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule log_config_module modules/mod_log_config.so
LoadModule log_forensic_module modules/mod_log_forensic.so
LoadModule logio_module modules/mod_logio.so
LoadModule env_module modules/mod_env.so
LoadModule mime_magic_module modules/mod_mime_magic.so
LoadModule cern_meta_module modules/mod_cern_meta.so
LoadModule expires_module modules/mod_expires.so
LoadModule headers_module modules/mod_headers.so
LoadModule ident_module modules/mod_ident.so
LoadModule usertrack_module modules/mod_usertrack.so
LoadModule unique_id_module modules/mod_unique_id.so
LoadModule setenvif_module modules/mod_setenvif.so
LoadModule version_module modules/mod_version.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule mime_module modules/mod_mime.so
LoadModule dav_module modules/mod_dav.so
LoadModule status_module modules/mod_status.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule asis_module modules/mod_asis.so
LoadModule info_module modules/mod_info.so
LoadModule cgi_module modules/mod_cgi.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule dir_module modules/mod_dir.so
LoadModule imagemap_module modules/mod_imagemap.so
LoadModule actions_module modules/mod_actions.so
LoadModule speling_module modules/mod_speling.so
LoadModule userdir_module modules/mod_userdir.so
LoadModule alias_module modules/mod_alias.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule php5_module modules/libphp5.so

Voici la version où seuls les modules « de base » ne sont pas commentés (pour en savoir plus):

LoadModule authn_file_module modules/mod_authn_file.so
#LoadModule authn_dbm_module modules/mod_authn_dbm.so
#LoadModule authn_anon_module modules/mod_authn_anon.so
#LoadModule authn_dbd_module modules/mod_authn_dbd.so
LoadModule authn_default_module modules/mod_authn_default.so
LoadModule authz_host_module modules/mod_authz_host.so
#LoadModule authz_user_module modules/mod_authz_user.so
#LoadModule authz_dbm_module modules/mod_authz_dbm.so
#LoadModule authz_owner_module modules/mod_authz_owner.so
LoadModule authz_default_module modules/mod_authz_default.so
LoadModule auth_basic_module modules/mod_auth_basic.so
LoadModule auth_digest_module modules/mod_auth_digest.so
#LoadModule file_cache_module modules/mod_file_cache.so
#LoadModule cache_module modules/mod_cache.so
#LoadModule disk_cache_module modules/mod_disk_cache.so
#LoadModule mem_cache_module modules/mod_mem_cache.so
#LoadModule dbd_module modules/mod_dbd.so
#LoadModule dumpio_module modules/mod_dumpio.so
LoadModule ext_filter_module modules/mod_ext_filter.so
#LoadModule include_module modules/mod_include.so
LoadModule filter_module modules/mod_filter.so
#LoadModule substitute_module modules/mod_substitute.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule log_config_module modules/mod_log_config.so
#LoadModule log_forensic_module modules/mod_log_forensic.so
#LoadModule logio_module modules/mod_logio.so
LoadModule env_module modules/mod_env.so
LoadModule mime_magic_module modules/mod_mime_magic.so
#LoadModule cern_meta_module modules/mod_cern_meta.so
LoadModule expires_module modules/mod_expires.so
LoadModule headers_module modules/mod_headers.so
#LoadModule ident_module modules/mod_ident.so
#LoadModule usertrack_module modules/mod_usertrack.so
#LoadModule unique_id_module modules/mod_unique_id.so
LoadModule setenvif_module modules/mod_setenvif.so
#LoadModule version_module modules/mod_version.so
#LoadModule proxy_module modules/mod_proxy.so
#LoadModule proxy_connect_module modules/mod_proxy_connect.so
#LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
#LoadModule proxy_http_module modules/mod_proxy_http.so
#LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
#LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule mime_module modules/mod_mime.so
#LoadModule dav_module modules/mod_dav.so
LoadModule status_module modules/mod_status.so
LoadModule autoindex_module modules/mod_autoindex.so
#LoadModule asis_module modules/mod_asis.so
LoadModule info_module modules/mod_info.so
LoadModule cgi_module modules/mod_cgi.so
#LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule dir_module modules/mod_dir.so
#LoadModule imagemap_module modules/mod_imagemap.so
LoadModule actions_module modules/mod_actions.so
LoadModule speling_module modules/mod_speling.so
#LoadModule userdir_module modules/mod_userdir.so
LoadModule alias_module modules/mod_alias.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule php5_module        modules/libphp5.so

Les modules « Status et Info » sont chargés, décommentez la ligne « Include » en fin de fichier de configuration d’Apache :

# Real-time info on requests and configuration
Include conf/extra/httpd-info.conf

# Editez le fichier "httpd-info.conf"
sudo nano /opt/local/apache2/conf/extra/httpd-info.conf

# Remplacez les 2 lignes "Allow from .example.com" par "Allow from localhost"

Redemarrez Apache, puis tapez http://localhost/server-status ou http://localhost/server-info

Utilisation des « Virtual Hosts »

Lorsque l’on travaille sur plusieurs projets, il est quasi nécessaire d’attribuer à chaque projet un nom de domaine plutôt que de travailler dans un répertoire (ou alias) sur « localhost ».

Imaginons travailler sur quatre projets :

• http://localhost/blog/
• http://localhost/dev-blog/
• http://localhost/projet-zend/
• http://localhost/projet-symfony/

En utilisant les hôtes virtuels, chacun de ces projets disposera de sa propre racine « Web », de son nom de domaine local et/ou réel et pourra avoir une configuration Apache et PHP particulière :

• http://blog.local
• http://dev-blog.local
• http://projet-zf.local
• http://projet-sf.local

Modifiez le fichier le fichier de configuration d’Apache :

sudo nano /opt/local/apache2/conf/httpd.conf
# Ajoutez les lignes suivante vers la fin du fichier
# Configuration des Vhosts
Include conf/vhost.d/*.conf

Créez le répertoire de configuration des « vhosts »

sudo mkdir /opt/local/apache2/conf/vhosts.d

Créez le fichier de configuration du « Virtual Host » par défaut :

sudo nano /opt/local/apache2/conf/vhosts.d/default_vhost.conf
# Copiez les lignes suivantes
NameVirtualHost *:80



  ServerName localhost
  ServerAdmin root@localhost
  DocumentRoot "/opt/local/apache2/htdocs"

  
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
  

Ce premier « vhost » est là pour poser certaines directives, ici « NameVirtualHost » que l’on aura pas à redéfinir dans les « vhosts » suivant. Ce premier « vhost » répond simplement à l’adresse « localhost » et pointe sur le répertoire « htdocs » créé à l’installation d’Apache. Vous pouvez désactiver l’accès à cet hôte si vous le souhaitez (Remplacer « Allow from all » par « Deny from all »).

Ajoutez un second fichier « vhost », par exemple pour installer votre blog WordPress en local :

sudo nano /opt/local/apache2/conf/vhosts.d/blog.local.conf
# Copier les lignes suivantes

  ServerName blog.local
  DocumentRoot "/Users/fabien/workspaces/sites/blog.myprod.net/public_html"
  
        Options Indexes FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
  
  ErrorLog /opt/local/apache2/logs/blog.error.log
  CustomLog /opt/local/apache2/logs/blog.access.log common

Finalisez l’environnement

Dans l’exemple du blog, la racine « Web » est placée dans l’espace de l’utilisateur « fabien ». Le serveur Web tourne par défaut avec les droits « User : www, Group : www ». Dans certains cas, vous serez obligés d’affiner les droits pour qu’Apache puisse manipuler (CRUD) des fichiers ou répertoires. Une autre solution consiste à modifier le fichier de configuration d’Apache pour qu’il utilise votre compte Utilisateur (exemple « fabien / staff »). Pour un espace local de développement, avec un php installé en module d’Apache, c’est une bonne solution si on ne souhaite pas jongler avec les droits. Cependant, attention aux commandes que pourrait effectuer vos scripts.

sudo nano /opt/local/apache2/conf/httpd.conf
# Faire tourner Apache avec vos droits utilisateur (ici les miens)
# Remplace l'utilisateur "www" et le groupe "www"
User fabien
Group staff

Modifiez la liste des fichiers d’index d’Apache :

sudo nano /opt/local/apache2/conf/httpd.conf
# Cherchez la ligne commençant par DirectoryIndex
# Apache utilise les fichiers d'index dans l'ordre
# Ajoutez index.php en premier

    DirectoryIndex index.php index.html

Pour la partie DNS, si vous ne disposez pas d’un serveur DNS local, modifiez le fichier « hosts » de votre machine (votre machine ne doit pas utilisez de serveur DHCP pour l’exemple suivant).

sudo nano /etc/hosts
# Ajouter pour chaque domaine local une ligne de la manière suivante
# Nous aurions pu ajouter des alias à localhost, mais je préfère utiliser l'interface externe.
# exemple :
192.168.100.5   blog.local

# Pour plusieurs domaines locaux, vous pouvez ajouter de nouvelles lignes :

192.168.100.5   blog.local
192.168.100.5   blog-dev.local

# Normalement, il ne devrait y avoir qu'une seule ligne :
# "Internet address" "Official host name" ["Aliases"]
192.168.100.5   blog.local blog-dev.local

Votre environnement local de développement Web (Apache, PHP) est à présent bien plus souple et fonctionnel.

Nous considérons que MacPorts est installé et configuré. Si ce n’est pas le cas, consulter ce billet.

Recherchez le nom du paquet correspondant à PHP5.

port search php

Le paquet que nous cherchons est « php5″. Voyons quelles sont les options d’installation :

port variants php5

Nous allons utiliser quelques options d’installation :

• « apache2″ pour l’installation de PHP en tant que module d’Apache 2
• « mysql5″ pour le support de MySQL 5
• « postgresql83″ pour le support de PostgreSQL 8.3
• mais aussi « sockets » et « pear »

Tapez la commande suivante pour installer PHP 5 :

sudo port install php5 +apache2 +mysql5 +postgresql83 +sockets +pear

nb : la première tentative d’installation a généré une erreur, MacPorts tentait d’installer Perl deux fois. Après avoir effectuer un petit nettoyage « sudo port clean –all php5″, l’installation s’est déroulée sans erreur.

La compilation et l’installation de l’ensemble des librairies prennent de longues minutes (Mac Mini). Une fois PHP 5 installé, il reste quelques configurations à effectuer manuellement.

Activez le module PHP 5 pour Apache.

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

Modifiez le fichier de configuration d’Apache pour que les fichiers « php » soient bien pris en compte et exécutés.

sudo nano /opt/local/apache2/conf/httpd.conf

// Ajouter les lignes suivantes à la fin du fichier de configuration :
# Extras conf
Include conf/extras-conf/*.conf

Créez le fichier de configuration de php, le « php.ini » :

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

Créez un fichier « info.php » dans « /opt/local/apache2/htdocs/ »

phpinfo();

Tapez l’adresse suivante dans votre navigateur : http://localhost/info.php

Vous allez constater que PHP 5 est compilé avec le support de :

bcmath, bz2, calendar, ctype, curl, date, dba, dom, exif, filter, ftp, gd, gettext, hash, iconv, json, ldap, libxml, mbstring, mcrypt, mhash, mime_magic, mysql, mysqli, odbc, openssl, pcre, PDO, pdo_mysql, pdo_pgsql, pgsql, posix, Reflection, session, SimpleXML, soap, sockets, SPL, standard, tokenizer, wddx, xml, xmlreader, xmlrpc, xmlwriter, xsl, zip, zlib

Vous disposez maintenant d’une installation de PHP 5 bien plus riche en termes de support que celle fournie par Mac OS X.

Nous considérons que MacPorts est installé et configuré. Si ce n’est pas le cas, consulter ce billet.

Nous commençons par rechercher le nom du paquet correspondant à la version 5 de MySQL.

port search mysql

Le paquet correspondant à MySQL 5 est « mysql5″.

Vérifiez la liste des options d’installation du paquet « mysql5″ :

port variants mysql5

Nous allons utiliser l’option « server ». Cette option permet de générer le fichier « plist » du système de gestion de démarrage des programmes.

Passez à l’installation de MySQL 5 :

sudo port install mysql5 +server

MacPorts n’initialise pas MySQL. Pour l’initialiser, tapez la commande suivante :

sudo -u mysql mysql_install_db5

Le fichier « plist » du système de gestion du démarrage des programmes est installé par MacPorts (nous avons utiliser l’option +server pour cela). Ce fichier contient :

Labelorg.macports.mysql5
ProgramArguments

        /opt/local/bin/daemondo
        --label=mysql5
        --start-cmd
        /opt/local/etc/LaunchDaemons/org.macports.mysql5/mysql5.wrapper
        start
        ;
        --stop-cmd
        /opt/local/etc/LaunchDaemons/org.macports.mysql5/mysql5.wrapper
        stop
        ;
        --restart-cmd
        /opt/local/etc/LaunchDaemons/org.macports.mysql5/mysql5.wrapper
        restart
        ;
        --pid=none

Debug
Disabled

OnDemand
RunAtLoad

MySQL ne sera pas lancé au démarrage.

- Si vous souhaitez voir MySQL lancé au démarrage, tapez la commande suivante :

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

- Si vous souhaitez gérer manuellement le démarrage et l’arrêt de MySQL, il faudra utiliser les commandes suivantes :

// Démarrer MySQL
sudo launchctl load -F /Library/LaunchDaemons/org.macports.mysql5.plist
// Arrêter MySQL
sudo launchctl unload /Library/LaunchDaemons/org.macports.mysql5.plist

Pour une utilisation manuelle plus simple, nous pouvons créer des alias dans notre fichier de configuration de Shell.

cd ~
nano .profile
// Une première solution, on utilise directement les binaires mysql
alias mysql5start='sudo /opt/local/bin/mysqld_safe5 &'
alias mysql5stop='/opt/local/bin/mysqladmin5 -u root -p shutdown'

// Une autre façon consiste à piloter "launchd" à partir des alias
alias mysql5start='sudo launchctl load -F /Library/LaunchDaemons/org.macports.mysql5.plist'
alias mysql5stop='sudo launchctl unload /Library/LaunchDaemons/org.macports.mysql5.plist'

Vérifiez le fonctionnement de MySQL :

// Démarrer MySQL
mysql5start

// Tester MySQL
mysqladmin5 -u root -p ping
// On vous demande le mot de passe de mysql
// Si MySQL fonctionne, vous devez voir :
mysqld is alive

// Vous pouvez aussi utiliser la commande "mysql5" :
mysql5 -u root -p

// Affiche
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 3
Server version: 5.0.67 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

// Pour quitter, taper "quit" 

// Stopper MySQL
mysql5stop

Nous considérons que MacPorts est installé et configuré (voir ici dans le cas contraire).

Recherchez le nom du paquet qui correspond à la version 8.3 de PostgreSQL.

port search postgresql

Deux noms de paquets correspondent à la version 8.3 de PostgreSQL :

• « postgresql83″ qui est le client
• « postgresql83-server » qui est le serveur

Le client est installé automatiquement lorsqu’on installe le serveur.

Pour connaitre toutes les options d’installation, tapez la commande suivante :

port variants postgresql83-server

Nous allons installer PostgreSQL 8.3 avec les options d’installation par défaut :

sudo port install postgresql83-server

MacPorts crée automatiquement l’utilisateur « postgres », pour connaître les détails sur cet utilisateur, utilisez la commande ci-dessous :

dscl . -read /Users/postgres
// Affiche :
ppleMetaNodeLocation: /Local/Default
GeneratedUID: A20245E7-....
NFSHomeDirectory: /opt/local/var/db/postgresql83
Password: *
PrimaryGroupID: 500
RealName:
 PostgreSQL-83\ Server
RecordName: postgres
RecordType: dsRecTypeStandard:Users
UniqueID: 500
UserShell: /bin/sh

MacPorts n’initialise pas PostgreSQL, il est nécessaire d’effectuer l’initialisation manuellement :

 sudo mkdir -p /opt/local/var/db/postgresql83/defaultdb
 sudo chown postgres:postgres /opt/local/var/db/postgresql83/defaultdb
 sudo su postgres -c '/opt/local/lib/postgresql83/bin/initdb -D /opt/local/var/db/postgresql83/defaultdb'

MacPorts crée automatiquement le fichier « plist » du système de gestion du démarrage des programme, voici son contenu :

Labelorg.macports.postgresql83-server
ProgramArguments

        /opt/local/bin/daemondo
        --label=postgresql83-server
        --start-cmd
        /opt/local/etc/LaunchDaemons/org.macports.postgresql83-server/postgresql83-server.wrapper
        start
        ;
        --stop-cmd
        /opt/local/etc/LaunchDaemons/org.macports.postgresql83-server/postgresql83-server.wrapper
        stop
        ;
        --restart-cmd
        /opt/local/etc/LaunchDaemons/org.macports.postgresql83-server/postgresql83-server.wrapper
        restart
        ;
        --pid=none

Debug
Disabled

OnDemand
RunAtLoad

Par défaut, PostgreSQL ne sera pas lancé au démarrage.

- Si vous souhaitez que PostgreSQL soit lancé au démarrage, lancez la commande suivante :

// Le fichier "plist" sera modifié automatiquement
sudo launchctl load -w /Library/LaunchDaemons/org.macports.postgresql83-server.plist

- Dans le cas contraire, il faudra charger le fichier manuellement :

sudo launchctl load -F /Library/LaunchDaemons/org.macports.postgresql83-server.plist

Dans le cas où vous en souhaitez pas lancer automatiquement PostgreSQL au démarrage, créer des alias rend le contrôle manuel du serveur PostgreSQL plus simple. Pour cela, nous allons ajouter quelques lignes à notre fichier de configuration de shell.

cd ~
nano .profile
// Ajoutez les lignes suivantes
// Pour faire simple, on utilise directement le fichier "plist" et donc Launchd
alias pgstart='sudo launchctl load -F /Library/LaunchDaemons/org.macports.postgresql83-server.plist'
alias pgstop='sudo launchctl unload /Library/LaunchDaemons/org.macports.postgresql83-server.plist'

Pour vérifier le bon fonctionnement de PostgreSQL, nous pouvons utiliser :

• le client texte en ligne de commande : « psql »
• un client graphique commePgAdmin III (gratuit)

Pour utiliser la ligne de commande, il est souhaitable d’ajouter un fichier de configuration de Shell pour l’utilisateur « postgres ».

sudo nano /opt/local/var/db/postgresql83/.profile
// Contenu du fichier :
export PATH=/opt/local/bin:/opt/local/sbin:/opt/local/lib/postgresql83/bin:$PATH
// Changez les propriétaires du fichier
sudo chown postgres:postgres /opt/local/var/db/postgresql83/.profile

Testons rapidement PostgreSQL en ligne de commande :

A titre de mémo, l’anti slash s’obtient avec la combinaison de touches suivante :
[SHIFT]+[ALT]+[ : / ]

// Démarrer le server
pgstart

// Passer sous l utilisateur "postgres"
sudo su - postgres

// Se connecter au serveur sans préciser de base de données
psql

// Connaitre l aide
\?

// Lister les bases de données
\l

// Affiche
        List of databases
   Name    |  Owner   | Encoding
-----------+----------+----------
 postgres  | postgres | UTF8
 template0 | postgres | UTF8
 template1 | postgres | UTF8
(3 rows)

// Quitter
\q

// Quitter l utilisateur "postgres"
exit

// Stopper Postgres
pgstop

L’utilisation du client en ligne de commande est très pratique et sa connaissance est parfois indispensable. Cependant, lorsque vous travaillez en local, un client graphique comme PgAdmin III remplace la ligne de commande pour bien des tâches. Son utilisation est triviale, vous pouvez le télécharger à cette adresse.

Nous considérons que MacPorts est installé et configuré (voir ici dans le cas contraire). Après avoir mis à jour le catalogue, faisons une recherche sur le nom du paquet qui correspond à la version 2.2 d’Apache.

port search apache

Le paquet correspondant à Apache 2.2 est « apache2″.

Pour connaitre toutes les options d’installation, tapons la commande suivante :

port variants apache2

Nous allons installer Apache 2.2 avec ses options d’installation par défaut.

sudo port install apache2

La compilation n’a pas fonctionné du premier coup, « awk » était nécessaire mais non installé :

...
checking for mawk... (cached) no
checking for gawk... (cached) no
checking for nawk... (cached) no
checking for awk... (cached) no
configure: error: No awk program found

Error: The following dependencies failed to build: apr-util sqlite3 readline ncurses ncursesw openssl zlib pcre
Error: Status 1 encountered during processing.

Suite à cette erreur, j’ai lancé l’installation de « gawk » (GNU awk) :

sudo port install gawk

puis à nouveau « apache2″.

sudo port clean --all apache2
sudo port install apache2

La compilation d’Apache et de l’ensemble de ses dépendances prend plusieurs minutes.

Utilisez le fichier « exemple » de configuration d’Apache comme fichier de configuration :

cd /opt/local/apache2/conf
sudo cp httpd.conf.sample httpd.conf

MacPorts génère un fichier « .plist » pour la prise en charge d’Apache par le système de gestion du démarrage de programme. Le contenu de ce fichier est le suivant :

Labelorg.macports.apache2
ProgramArguments

        /opt/local/bin/daemondo
        --label=apache2
        --start-cmd
        /opt/local/etc/LaunchDaemons/org.macports.apache2/apache2.wrapper
        start
        ;
        --stop-cmd
        /opt/local/etc/LaunchDaemons/org.macports.apache2/apache2.wrapper
        stop
        ;
        --restart-cmd
        /opt/local/etc/LaunchDaemons/org.macports.apache2/apache2.wrapper
        restart
        ;
        --pid=none

Debug
Disabled

OnDemand
RunAtLoad

Par défaut Apache ne sera pas lancé au démarrage, ni à la demande.

- Si vous souhaitez qu’Apache soit lancé automatiquement au démarrage, tapez la commande suivante :

// Le fichier sera modifié automatiquement en effectuant la manipulation
sudo launchctl load -w /Library/LaunchDaemons/org.macports.apache2.plist

- Dans le cas contraire, il faudra utiliser manuellement la commande « Launchctl » pour utiliser apache :

// Charger le fichier plist, Apache est lancé
sudo launchctl load -F /Library/LaunchDaemons/org.macports.apache2.plist
// Arrêter Apache en déchargeant le fichier plist
sudo launchctl unload /Library/LaunchDaemons/org.macports.apache2.plist

Une autre façon de faire consiste à créer des Alias dans votre fichier de configuration de Shell. Ajoutez les lignes suivantes dans votre fichier « .profile ».

cd ~
nano .profile
// Ajoutez les lignes suivantes
alias apache2start='sudo /opt/local/apache2/bin/apachectl -k start'
alias apache2stop='sudo /opt/local/apache2/bin/apachectl -k stop'
alias apache2restart='sudo /opt/local/apache2/bin/apachectl -k restart'
alias apache2ctl='sudo /opt/local/apache2/bin/apachectl'

Vous pourrez ensuite contrôler Apache en tapant les alias :

// Pour lancer Apache
apache2start
// Pour arrêter Apache
apache2stop
...