Introduction à WordPress sous Nginx

J’ai commencé à utiliser Nginx il y a plusieurs années. Comme plusieurs, j’utilisais Apache qui était la solution la plus populaire. Un jour, alors que nos visites quotidiennes ont dépassé les centaines des requêtes en même temps, les problèmes ont fait leur apparition. Apache crashait constamment.

Ajouter du matériel plus performant n’était pas une option à cause de coûts. C’est à ce moment que j’ai découvert Nginx!

WordCamp Montréal

Le contenu qui suit a été présenté au WordCamp de Montréal. Le WordCamp est une conférence dédiée à WordPress. Étant un grand fan de WordPress et également de Nginx, l’occasion était parfaite de réunir les deux sujets.

Toutefois, en faisant ma présentation, je me suis rendu compte qu’il y avait beaucoup d’aspects théoriques nécessitant du code. Montrer du code dans une présentation n’est pas l’idéal, mais c’était nécessaire dans ce cas. Puis, je me suis rendu compte que je n’aurais pas le temps de tout couvrir. Un article sur mon blogue devenait nécessaire.

Voici donc la présentation telle que présentée au WordCamp :

La mission

Je reprendrai donc ici les étapes vous permettant d’installer WordPress sous un serveur Nginx que vous aurez vous-même installé! Notez que j’utiliserai Ubuntu 14.04 pour y parvenir via les services de Digital Ocean.  Si vous souhaitez en apprendre davantage sur les différences entre Apache et Nginx, je vous recommande de lire: Apache vs Nginx.

Bien qu’il aurait été possible de tout compiler soi-même le code source, j’utiliserai Apt-Get. Par le passé, j’avais choisi de tout compiler manuellement, mais cela demande énormément de temps (d’attente et de débogage pour les librairies incompatibles entre elles). Si vous n’avez aucune expérience, donnez-vous une chance!

Pour réussir notre mission, nous devrons :

• Installer Nginx
• Installer PHP et MySQL
• Installer PHP-FPM
• Installer WordPress

 

Préparation à l’installation

Tout d’abord, vous devrez rediriger un nom de domaine (ou sous-domaine) vers l’adresse IP du serveur web. Dans le cas présent, nous considèrerons que monsite.com a été acheté et redirigé vers l’adresse IP du serveur : 66.77.88.99.

Avant d’installer quoi que ce soit sur votre serveur web, il est recommandé de le mettre à jour. Nous exécuterons un update (mise à jour de la liste des packages) et un upgrade (mise à jour des packages installés).

> apt-get update
> apt-get upgrade

Ça y est, on est prêt à débuter!

 

Installation de Nginx

L’installation de Nginx est plutôt simple et consiste en une seule commande :

> apt-get install nginx

Ensuite, on démarre Nginx :

> service nginx start

C’est tout! Vous pouvez maintenant tester votre installation via l’adresse IP du serveur : http://66.77.88.99.

Si l’installation a fonctionné, vous verrez ceci :

Par défaut, les fichiers que doit servir Nginx se trouvent dans : /usr/share/nginx/html

Vous auriez pu trouver cette information dans le fichier de configuration de base: /etc/nginx/sites-available/default

Vous y trouverez le fichier index.html ainsi que les images qui affichent la page. Vous pouvez aller faire une modification dans le fichier index.html pour confirmer que c’est le bon fichier.

Tadam!

Il y a quelques notions théoriques à comprendre pour utiliser Nginx efficacement. Les voici :

> service nginx start # Démarrage de Nginx
> service nginx stop  # Arrêt de Nginx
> service nginx restart # Redémarrage de Nginx
> service nginx reload # Recharge de la configuration de Nginx
> /usr/sbin/nginx -t # Test de la configuration de Nginx

 

Quand vous faites une modification à la configuration de Nginx, seul un « reload » est nécessaire. Contrairement à Apache qui vérifie chaque fois le contenu du fichier .htaccess, Nginx lit la configuration uniquement au démarrage et lors d’un « reload ». Cela aide à accélérer la vitesse d’affichage puisque la lecture d’un fichier est un processus lent (contrairement à l’utilisation d’information en mémoire).

Maintenant, il faut savoir où peut-on modifier les fichiers de configuration pour Nginx. Ils se trouvent dans : /etc/nginx

Dans un premier temps, il y a le fichier de configuration principal du serveur soit nginx.conf que j’ai modifié pour qu’il contienne ceci:

user www-data;
worker_processes auto;
pid /run/nginx.pid;

events {
	worker_connections 768;
}

http {

	### Basic Settings ###
	sendfile on;
	tcp_nopush on;
	tcp_nodelay on;
	keepalive_timeout 65;
	types_hash_max_size 2048;
	server_tokens off;

	server_names_hash_bucket_size 64;
	# server_name_in_redirect off;

	include /etc/nginx/mime.types;
	default_type application/octet-stream;


	### Gzip Settings ###
	gzip on;
	gzip_disable "msie6";


	### nginx-naxsi config ###
	#include /etc/nginx/naxsi_core.rules;


	### Virtual Host Configs ###
	include /etc/nginx/conf.d/*.conf;
	include /etc/nginx/sites-enabled/*;
}

On modifie généralement ce fichier tout de suite après l’installation et on y touche rarement par la suite.

Vous pouvez consulter la documentation sur la configuration de Nginx pour en apprendre davantage.

Puis, il y a deux répertoires à retenir :

• /etc/nginx/sites-available ← sites disponibles
• /etc/nginx/sites-enabled ← sites activés

De manière générale, on crée la configuration d’un site dans le répertoire des sites disponibles et on ajoute un lien symbolique dans le répertoire des sites activés. Ainsi, si on doit désactiver le site, on peut supprimer uniquement le lien symbolique et garder la configuration! C’est ce que nous ferons.

Donc dans /etc/nginx/sites-available, nous créerons le fichier monsite.com. Nous insérerons le code suivant :

# Gestion sans www (redirection vers www)
server {
	server_name     monsite.com;
	return          301 http://www.monsite.com$request_uri;
}

# Gestion www
server {
	# Port
	listen 80;

	# Hostname
	server_name www.monsite.com;

	# Logs (acces et erreurs)
	access_log /var/log/nginx/monsite.com.access.log;
	error_log /var/log/nginx/monsite.com.error.log;

	# Repertoire
	root /home/monsite/www;
	    
	# Fichier a executer par defaut (en ordre)
	index index.html index.php;
}

 

À noter : plusieurs scripts trouvés sur internet contiennent des « if ». Je vous invite à lire l’article ifs are evil trouvé dans la documentation de Nginx.

Puis, on ajoute un lien symbolique pour l’ajouter dans les sites activés :

> ln -s /etc/nginx/sites-available/monsite.com /etc/nginx/sites-enabled/monsite.com

 

Création du site

Puis, nous devrons créer le répertoire pour accueillir le contenu du site. Personnellement, j’aime bien créer un utilisateur pour chaque site et mettre le code dans le dossier home de cet utilisateur. Cela assure une indépendance au niveau des utilisateurs.

> useradd -d /home/monsite -m monsite
> su monsite
> mkdir -p ~/www
> echo "Mon site!" > ~/www/index.html
> exit

 

Attention : WordPress insiste pour utiliser le même nom d’utilisateur qu’à l’installation pour la propriété des fichiers. Il est donc une bonne idée d’avoir un utilisateur par compte pour éviter à WordPress de devoir se connecter via FTP pour simuler adéquatement les droits de fichiers. Vous pouvez lire l’article sur les permissions pour les sites avec WordPress.

On peut maintenant tester notre site. Il faut tout d’abord recharger la configuration :

> /usr/sbin/nginx -t
> service nginx reload

 

Puis, allez voir le site : http://www.monsite.com

Ça fonctionne!

 

Installation de PHP, PHP-FPM et MySQL

Qui dit WordPress dit également PHP (minimum 5.2.4) et MySQL (minimum 5.0). L’installation est assez simple et se résume ainsi pour MySQL:

> apt-get install mysql-server php5-mysql mysql-client

(Pendant l’installation, on vous demandera de choisir un mot de passe administrateur pour MySQL.)

Et pour PHP et PHP-FPM, j’y vais assez simplement (même si de nombreux autres packages pourraient être ajoutés):

> apt-get install php5-cli php5-fpm

 

Configuration de PHP

Plusieurs optimisations peuvent être faites à ce stade, mais nous nous contenterons de faire le minimum dans notre php.ini qui se trouve dans : /etc/php5/fpm/php.ini

# Trouver la ligne :
# ;cgi.fix_pathinfo=1
# … et la changer pour:
cgi.fix_pathinfo = 0

# Trouver la ligne:
# post_max_size = 8M
# … et la changer pour:
post_max_size = 50M

# Trouver la ligne:
# upload_max_filesize = 2M
# … et la changer pour:
upload_max_filesize = 50M

 

Le premier changement est pour une question de sécurité. Les deux suivants sont pour vous permettre d’envoyer vos extensions et thèmes sans être trop restreints au niveau de la taille du fichier qui peut être envoyé.

Pour optimiser l’exécution du PHP, il est fortement conseillé d’activer OPcache afin de pouvoir garder en mémoire le code pré-compilé.  Voyez une réponse complète sur StackOverflow.

 

Création d’une base de données MySQL

Nous ne ferons aucune optimisation pour MySQL dans le cadre de cet article, mais vous devriez valider ce qui peut être fait pour améliorer les performances. Voici comment créer un utilisateur et une base de données pour notre accueillir notre site :

> mysql -u root -p
Enter password:

mysql> CREATE DATABASE monsite;

mysql> CREATE USER 'umonsite'@'localhost' IDENTIFIED BY 'qwerty1234';
mysql> GRANT ALL PRIVILEGES ON monsite.* TO 'umonsite'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> quit

 

Ensuite, on teste notre utilisateur

> mysql -u umonsite –p

 

Si vous entrez le bon mot de passe, ça fonctionne!

 

Configuration de PHP-FPM

Présentement, notre installation de Nginx prend les fichiers tels qu’ils sont sur le serveur et les retourne. C’est bien sauf dans le cas des fichiers PHP qui doivent être exécutés. Nginx devra donc intercepter les fichiers avec l’extension PHP pour qu’ils soient exécutés.

La configuration de PHP-FPM se trouve dans le répertoire : /etc/php5/fpm/

La gestion de PHP-FPM se fait via un « pool » de connexions. Il est possible d’utiliser un seul pool par serveur ou un pool par site. Pour WordPress, tel que mentionné plus haut pour la gestion des droits de fichiers, il est préférable d’avoir un pool par site. Ainsi, nous créerons un nouveau fichier nommé monsite.conf dans le répertoire /etc/php5/fpm/pool.d/ et contenant le code suivant :

[monsite]

user = monsite
group = monsite

listen = /var/run/php5-fpm.monsite.sock
listen.owner = www-data
listen.group = www-data

pm = dynamic
pm.max_children = 75
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20
pm.max_requests = 500

Remarquez les lignes surlignées où l’information varie d’un site à l’autre.

La configuration est complétée pour notre nouveau site. Le service doit être redémarré!

> service php5-fpm restart

 

Test d’un fichier php

Allons maintenant modifier notre fichier de configuration de Nginx pour monsite.com ajouter un fichier php dans le compte de notre nouvel utilisateur.

Modifions tout d’abord notre fichier de configuration :

# Gestion sans www (redirection vers www)
server {
	server_name     monsite.com;
	return          301 http://www.monsite.com$request_uri;
}
# Gestion www
server {
	# Port
	listen 80;

	# Hostname
	server_name www.monsite.com;

	# Logs (acces et erreurs)
	access_log /var/log/nginx/monsite.com.access.log;
	error_log /var/log/nginx/monsite.com.error.log;

	# Repertoire
	root /home/monsite/www;

	# Fichier a executer par defaut (en ordre)
	index index.html index.php;

	# Gestion des fichiers PHP (envoi vers PHP-FPM)                         
	location ~ \.php$ {
		try_files $uri =404;
		fastcgi_pass unix:/var/run/php5-fpm.monsite.sock;
		fastcgi_index index.php;
		fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
		include fastcgi_params;
	}

}

Remarquez les lignes surlignées qui ont été ajoutées.

Maintenant, nous créerons un fichier PHP afin de s’assurer que la gestion fonctionne.

su monsite
echo "<?php phpinfo(); ?>" > ~/www/pi.php
exit

 

Il ne reste qu’à redémarrer Nginx pour prendre tous les changements en considération :

> service nginx restart

 

Allons voir le résultat : http://www.monsite.com/pi.php

Vous devriez avoir un résultat similaire à ceci :

Et si on redémarrait

Maintenant, testons un redémarrage du système pour voir si on pourra accéder au site par la suite. Il faut s’assurer que tous les services sont fonctionnels.

> reboot

Attendez 2 minutes et visitez : http://www.monsite.com/pi.php

Le site est fonctionnel… ouf!

 

Configuration pour WordPress

Maintenant, il faut ajuster notre configuration pour WordPress, il existe de nombreuses façons d’y parvenir, mais la méthode qui fonctionne le mieux pour moi est de créer des fichiers standardisés que j’inclus dans ma configuration si le site utilise WordPress.

Je débute par créer un répertoire « wordpress » dans le répertoire de Nginx :

> mkdir –p /etc/nginx/wordpress

 

À l’intérieur de /etc/nginx/wordpress, je crée les fichiers suivants :
wp-global.conf

# WordPress - Site unique                  

# Redirection vers index.php si le fichier n'existe pas (gestion permalien)
location / {
	try_files $uri $uri/ /index.php?$args;
}

# Ajout d'un slash a la fin des requetes */wp-admin
rewrite /wp-admin$ $scheme://$host$uri/ permanent;

# Ne pas logger les erreurs 404 et ajouter expires header.
location ~* ^.+\.(ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|wav|bmp|rtf)$ {
	access_log off; log_not_found off; expires max;
}

 

wp-restriction.conf

# WP Restrictions                                       

# Pas de log pour le favicon
location = /favicon.ico {
	log_not_found off;
	access_log off;
}

# Pas de log pour le robots.txt
location = /robots.txt {
	allow all;
	log_not_found off;
	access_log off;
}

# Refus de servir tous fichiers debutants avec un .
location ~ /\. {
	deny all;
}

# Refus d'upload d'un fichier php (piratage)
location ~* /(?:uploads|files)/.*\.php$ {
	deny all;
}

 

multisite.conf

# Multisite rewrite (A CORRIGER: Le IF !!)
if (!-e $request_filename) {
	rewrite /wp-admin$ $scheme://$host$uri/ permanent;
	rewrite ^/[_0-9a-zA-Z-]+(/wp-.*) $1 last;
	rewrite ^/[_0-9a-zA-Z-]+(/.*\.php)$ $1 last;
}

 

Puis, je fais tout simplement le lien dans le fichier de configuration de mon site avec les nouveaux fichiers créés. Ainsi, je n’ai pas à tout retranscrire à chaque fois.

Mon fichier de configuration ressemble maintenant à ceci :

# Gestion sans www (redirection vers www)
server {
	server_name     monsite.com;
	return          301 http://www.monsite.com$request_uri;
}

# Gestion www
server {
	# Port
	listen 80;

	# Hostname
	server_name www.monsite.com;

	# Logs (acces et erreurs)
	access_log /var/log/nginx/monsite.com.access.log;
	error_log /var/log/nginx/monsite.com.error.log;

	# Repertoire
	root /home/monsite/www;

	# Fichier a executer par defaut (en ordre)
	index index.html index.php;

	# Ajout de fichiers pour WordPress
	include         wordpress/wp-restrictions.conf;
	include         wordpress/wp-global.conf;
	#include        wordpress/wp-multisite.conf;

	# Gestion des fichiers PHP (envoi vers PHP-FPM)
	location ~ \.php$ {
		try_files $uri =404;
		fastcgi_pass unix:/var/run/php5-fpm.monsite.sock;
		fastcgi_index index.php;
		fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
		include fastcgi_params;
	}

}

Remarquez les lignes surlignées qui ont été ajoutées!

Il ne reste qu’à recharger la configuration :

> service nginx reload

La configuration est officiellement complétée!

 

Installation de WordPress

Nous sommes maintenant rendus au bout que vous connaissez tous! L’installation ne prendra que quelques minutes. On commence par récupérer le code :

> apt-get install zip
> su monsite
> cd ~/www
> rm *
> wget http://wordpress.org/latest.zip
> unzip latest.zip
> cd wordpress
> mv * ../
> cd ..
> rm -Rf wordpress latest.zip

 

Puis, on visite le site et on suit les étapes pour compléter l’installation : http://www.monsite.com

Voilà! Vous avez maintenant un site web WordPress géré avec Nginx.