Déploiement d'un module PHP sur un serveur web

Le langage PHP fut créé en 1994 par Rasmus Lerdorf pour son site web. C'était à l'origine une bibliothèque logicielle en C7 dont il se servait pour conserver une trace des visiteurs qui venaient consulter son CV. Au fur et à mesure qu'il ajoutait de nouvelles fonctionnalités, Rasmus a transformé la bibliothèque en une implémentation capable de communiquer avec des bases de données et de créer des applications dynamiques et simples pour le Web (Source Wikipédia).

Ce langage de programmation libre descendant du C est exécuté du côté serveur pour pouvoir finalement générer autant du code (HTML ou CSS par exemple) ou des données (PNG, GIF,...) qui seront envoyées au navigateur du client capable des les interpréter. Une autre force du PHP est qu'il est très utile pour envoyer des données à une base de données. Il est multi-plateforme : autant sur Linux qu'avec Windows il permet aisément de reconduire le même code sur un environnement à peu près semblable (prendre en compte les règles d'arborescences de répertoires qui peuvent changer). Sa puissance en fait un élément central de sites très connus tels que Facebook ou Wikipédia. Avec le temps, le PHP est devenu la référence pour créer des sites dynamiques ou des applications web.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (<?php et ?>) qui délimitent le code qu'il doit interpréter. Notons que comme en C (le PHP étant un descendant du C), le "//" permet de faire que la ligne qui le suit soit seulement un commentaire.

<?php

echo "Bonjour le monde !";

// ... encore du code

echo "Dernière instruction";

// le script se termine ici, sans la balise de fermeture PHP

?>

De cette manière, cela permet à PHP d'être intégré dans toutes sortes de documents, car tout ce qui se trouve en dehors des balises ouvrantes / fermantes de PHP est ignoré. Par exemple ci-dessous on intègre du HTML qui ne sera pas interprété par le serveur et qui sera directement transmis au client

<h1>Mon Site Web</h1>

<?php

//Du code

?>

Dans la racine de votre site, créer un fichier simple contenant du php.

sudo nano /home/www/monsite.fr/home.php

<?php

echo "<h1>Hello World !<h1>";

?>

Rendez vous sur votre site et ajouter à l'url le nom du fichier que vous venez de créer. Dans mon cas cela donne monsite1.fr/home.php

Zoom

On voit que le site nous propose de télécharger le fichier au lieu de nous afficher le "Hello World !". Nous allons voir dans ce module comment faire pour afficher les fichiers PHP sur notre site.

Nous allons devoir installer un paquet permettant à Nginx de traiter les fichiers PHP. Pour cela il suffit d'entrer la commande :

sudo apt-get install php-fpm

Le fichier de configuration de php-fpm se trouve à l'adresse /etc/php/8.1/fpm/php.ini . Le fichier est très complet et bien expliqué (en anglais), la configuration de base est très bien pour l'utilisation que nous allons en faire, il est cependant recommandé d'aller remplacer display_errors = off par display_errors = on , ce qui peut être très utile en cas d'erreurs lorsque l'on est en phase de développement. Cette variable est à laisser off dans un environnement de production, car on veut en général cacher au maximum les éventuelles erreurs PHP pour des raison d'ergonomie, de présentation mais également de sécurité.

Pour notre cas, nous allons activer l'affichage des erreurs pour nous aider à débugger notre application le temps du développement

sed -i "s|^display_errors = Off|display_errors = On|g" /etc/php/8.1/fpm/php.ini

sed -i "s|^display_startup_errors = Off|display_startup_errors = On|g" /etc/php/8.1/fpm/php.ini

systemctl restart php8.1-fpm.service

Nous allons aussi devoir effectuer des modifications dans nos configuration nginx pour lui dire quoi faire avec nos fichier php.

Voici une configuration minimale pour nginx utilisant du php :

server{

        listen 80;

        server_name monsite.fr;

        root /home/www/monsite;

        index index.php index.html;

        location / {

                try_files $uri $uri/ =404;                        #on indique au serveur qu'on essaye d'abord de charger le fichier demandé dans l'url (avec $uri) ou sinon le dossier ($uri/) ou de renvoyer une erreur 404 si il ne trouve pas le fichier

                }

        location ~ \.php$ {                                       #on explique à nginx ce qu'il doit faire si on lui demande un fichier terminant par .php

                include snippets/fastcgi-php.conf;                #on inclut une configuration nginx situé dans /etc/nginx/snippets/ 

                fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;   #on indique à nginx quel processus s'occupe du php, on peut trouver la liste des processus dans /var/run

}

        error_log /home/logs/monsite.error.log;

        access_log /home/logs/monsite.log;

}

On peut ensuite à la racine de notre site créer un fichier phpinfo.php contenant le code ci-dessous :

<?php phpinfo(); ?>

Enfin on peut se rendre sur notre site et ajouter /phpinfo.php à l'url et observer que notre site reconnaît désormais les fichiers php.

La page affichée est une page récapitulative de la configuration de php sur notre serveur.