Plus vite avec HHVM et nginx

Ce tutoriel ne s’adresse pas aux débutants et a pour objectif de rappeler quelles sont les grandes étapes d’installation de Jorani avec le serveur web nginx et la machine Hip Hop de Facebook. Certaines étapes telles que l’installation de la base de données ou du logiciel en lui-même sont omises. En complément, je suggère donc la lecture du tutoriel d’installation avec Apache.

Nous expliquerons comment procéder à l’installation sous Ubuntu 14.10. On rappelle que HHVM ne fonctionne qu’avec des machines 64 bits.

Récupérer HHVM

HHVM est livré sous la forme de sources à compiler ou en tant que packages. Nous utiliserons ceux d’Ubuntu 14.10.

sudo apt-get install software-properties-common
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0x5a16e7281be7a449
sudo add-apt-repository 'deb http://dl.hhvm.com/ubuntu utopic main'
sudo apt-get update
sudo apt-get install hhvm

Configurer HHVM

La page du rapport de présence d’un employé fait appel à la fonction PHP cal_days_in_month qui n’existe pas encore (à la date de rédaction de cet article) dans l’API HHVM. Aussi il faudra activer la couche de compatibilité avec Zend (dans /etc/hhvm/php.ini) :

hhvm.enable_zend_compat = true

Démarrer HHVM en mode Fast-CGI

HHVM exécute les scripts PHP et dialogue avec votre serveur web via Fast-CGI d’une manière assez similaire à PHP-FPM. Dans cet exemple, nous le lancerons de manière à ce qu’il communique avec le serveur via le réseau (il est aussi possible d’utiliser une socket si les deux serveurs sont sur la même machine) :

hhvm --mode daemon -vServer.Type=fastcgi -vServer.Port=9010

Si vous rencontrez des erreurs (segmentation fault, libgmp.so.10, libmemcachedutil.so.2), merci de relire la documentation du projet HHVM, car des solutions y sont proposées.

Si vous souhaitez utiliser Apache, vous trouverez plus d’informations dans la documentation du projet HHVM.

Configurer nginx

Un exemple de configuration est donné dans le dépôt de Jorani sur Github. Il suffit de l’adapter à votre environnement. Par exemple, je change la ligne :

fastcgi_pass 127.0.0.1:9000;

en

fastcgi_pass 127.0.0.1:9010;

Puisque j’ai lancé HHVM sur ce port réseau.

N’oubliez pas de configurer votre système de manière à ce que nginx ait les permissions de lecture sur le répertoire web où vous avez installé jorani.

Il faut également installer Jorani et le configurer correctement.