PHP

PHP (acronyme récursif pour "PHP: Hypertext Preprocessor", PHP étant au départ l'acronyme de Personal Home Page) est un langage de programmation principalement utilisé pour produire des pages web de manière dynamique. Il est donc, dans la très grande majorité des cas, couplé à un serveur HTTP (comme Apache) pour la communication avec le client web.

La production de pages web dynamiques pouvant nécessiter une interaction avec une base de données, PHP est souvent utilisé en association avec un système de gestion de base de données (SGBD) comme MySQL..

Il existe 4 manières d'installer et utiliser PHP sur Ubuntu :

• en ligne de commande (ou donc dans un script shell) via l'installation du paquet php-cli (cli pour command-line interface)
• avec un serveur HTTP en script FastCGI via l'installation du paquet php-fpm (fpm pour FastCGI Process Manager)
• avec un serveur HTTP en script CGI via l'installation du paquet php-cgi (c'est une méthode historique qui n'a plus trop d'intérêt)
• en module d'Apache via l'installation du paquet libapache2-mod-php

Pour un serveur web on utilisera principalement PHP soit en FastCGI, soit en module d'Apache.

Si on utilise Apache et pour un site à trafic ordinaire, on utilisera de préférence le module d'Apache parce qu'il est beaucoup plus simple à mettre en place et à administrer.

Pour un trafic à plusieurs milliers de visites par heure, mieux vaut utiliser PHP en FastCGI (parce qu'il est capable de traiter plusieurs processus simultanément).
Avec un serveur HTTP autre que Apache, on utilise aussi PHP en FastCGI : il n'existe pas de module PHP pour Nginx ou Lighttpd.

Chacun de ces paquets installera toutes les dépendances nécessaires au fonctionnement de PHP sur votre machine.

PHP est alors installé. Cependant la plupart des scripts PHP (CMS, forums, applications web en tout genre) utilisent des modules de PHP pour bénéficier de certaines fonctionnalités.

Si c'est à proscrire sur un serveur en production ou même un serveur LAMP de développement, il peut-être utile d'installer plusieurs versions sur une machine de développement, par exemple pour travailler tantôt avec une application ancienne avec un framework ou un CMS nécessitant un php7.2 par exemple, et tantôt avec la dernière version (php8.1 par exemple) pour démarrer ou mettre à niveau un développement.

# vérification de la version actuelle:
$ php -v
PHP 7.4.29-0ubuntu0.18.04.1 (cli) ( NTS )
 
# ajout du dépôt, puis installation de php et de ses modules
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.1-cli php8.1-dev php8.1-fpm php8.1-curl php8.1-gd php8.1-mysql php8.1-mbstring php-gettext php8.1-zip php8.1-xmlrpc php8.1-xml php8.1-intl php8.1-bz2 php8.1-json php8.1-pspell php8.1-tidy php-pear mcrypt
 
# vérification de la version installée:
$ php -v
PHP 8.1.6 (cli) (built: May 17 2022 16:47:53) (NTS)

Le basculement entre ces versions peut se faire par la commande :

sudo update-alternatives --config php

Les modules de PHP lui permettent d'étendre ses fonctionnalités. De très nombreux modules PHP sont disponibles sur les dépôts officiels d'Ubuntu.

Vous pouvez installer rapidement les modules les plus courants : php-curl php-gd php-intl php-json php-mbstring php-xml php-zip

Certains modules sont installés par défaut avec PHP via le paquet php-common.

• Calendar
• ctype
• Exif
• FileInfo
• FTP
• Gettext
• iconv
• PHP Data Objects
• Phar
• Mémoire partagée
• Sockets
• Tokenizer

D'autres modules peuvent être installés individuellement via APT.

Voici une liste des modules les plus couramment utilisés :

PHP permet de se connecter à différents types de serveurs de base de données. Pour cela il est également nécessaire d'installer des modules complémentaires.

Vous pouvez lister la plupart des modules PHP disponibles dans les dépôts officiels avec la commande

apt list php-\*

Vous pouvez lister les modules installés sur votre système grâce à la commande

php -m

Attention cependant au fait que les modules PHP activés en ligne de commande et via votre serveur HTTP ne sont pas nécessairement les mêmes. La fonction PHP phpinfo() vous montrera les modules activés sur votre serveur web.

Les modules sont en principe activés automatiquement lors de l'installation des paquets correspondants. Cependant au fur et à mesure des changements de configuration on peut se retrouver avec des modules installés mais pas activés.

On peut activer / désactiver un module respectivement avec les commandes phpenmod et phpdismod.
Par exemple :

sudo phpenmod mbstring

Par défaut la modification s'applique pour toutes les versions de PHP installées et toutes les SAPI utilisées (CLI, Apache, FPM, etc.)

La configuration de PHP se fait via un fichier php.ini.

Pour le module PHP d'Apache, le chemin d'accès au fichier php.ini sera généralement :

• sous Trusty (Ubuntu 14.04) : /etc/php5/apache2/php.ini
  
• sous Xenial (Ubuntu 16.04) : /etc/php/7.0/apache2/php.ini
• sous Bionic (Ubuntu 18.04) : /etc/php/7.2/apache2/php.ini
• sous Focal (Ubuntu 20.04) : /etc/php/7.4/apache2/php.ini

Les fichiers de configuration ne sont pas les mêmes pour utiliser PHP en ligne de commande : /etc/php/7.0/cli/php.ini
ou en script FastCGI : /etc/php/7.0/fpm/php.ini

Ceci explique parfois des différences de comportement entre PHP exécuté par Apache, et manuellement en ligne de commande.

Si vous développez une application en local, il est souvent utile de visualiser les messages d'erreurs directement sur votre page web. Ces erreurs sont cependant généralement aussi accessibles dans le journal d'erreur du serveur HTTP (/var/log/apache2/error.log pour Apache).

Pour afficher les erreurs, avec Apache vous pouvez par exemple définir des règles dans un fichier .htaccess à la racine de votre hôte virtuel :

.htaccess

php_flag display_errors on
php_value error_reporting "E_ALL"

error_reporting définit le niveau d'erreur que vous souhaitez afficher.

Le niveau d'erreur E_ALL affiche toutes les erreurs, y compris celles concernant des fonctionnalités dépréciées (qui seront désactivées dans des versions futures de PHP) ou des erreurs strictes, qu'on n'a pas forcément envie de corriger.
On peut désactiver l'affichage de ces messages pas toujours très importants en remplaçant cette ligne par celle-ci :

php_value error_reporting "E_ALL & ~E_NOTICE & ~E_STRICT"

Les directives display_errors et error_reporting sont aussi accessibles pour définir l'affichage des erreurs globalement, directement dans votre fichier php.ini.
Pour PHP 7.0 :

/etc/php/7.0/apache2/php.ini

...
display_errors=on
error_reporting=E_ALL & ~E_NOTICE & ~E_STRICT
...

Pour un site en production, mieux vaut désactiver l'affichage des erreurs et se référer uniquement au log d'erreur du serveur HTTP :

.htaccess

php_flag display_errors off

La fonction phpinfo() permet d'obtenir des informations sur sa configuration de PHP en situation. C'est utile en particulier parce que les configurations de PHP peuvent être différentes entre son utilisation en ligne de commande, en module d'apache ou en fastCGI.

La méthode est de créer un fichier phpinfo.php à la racine de l'hôte virtuel, donc par ex. /var/www/example/phpinfo.php contenant ceci :

<?php phpinfo(); ?>

On appelle ensuite ce script depuis un navigateur web : http://example/phpinfo.php

OPcache était à la base un module permettant d'implémenter des fonctionnalités de cache à PHP, ce qui permet d'accélérer l'execution des scripts et d'alléger leur charge côté serveur.
Il est désormais intégré nativement à PHP depuis la version 5.5.

OPcache est activé par défaut sur Ubuntu.

Une page blanche inattendue affichée immédiatement indique très certainement que l'affichage des retours d'erreur sur la page n'est pas activé.

Vous pouvez activer le rapport d'erreur, ou consulter le log d'erreur de votre serveur HTTP pour en savoir plus sur le problème rencontré.

Ce problème survient lorsque PHP n'est pas interprété par le serveur web. Le serveur envoie dans ce cas au navigateur directement le code PHP comme s'il s'agissait de texte, et le navigateur cherche généralement à l'interpréter comme du HTML, puisque c'est ce qu'il attend par défaut.
En plus de rendre l'application ou le site non fonctionnel, cela peut poser des problèmes de sécurité (fuite d'informations éventuellement sensibles).

Il faut dans ce cas revoir votre installation de PHP et sa configuration avec votre serveur Web.

Si vous utilisez PHP en tant que module d'Apache :

• vérifiez l'installation du paquet libapache2-mod-php
• s'il est bien installé, activez le module :

sur Focal 20.04 :

sudo a2enmod php7.4

sur Bionic 18.04 :

sudo a2enmod php7.2

sur Xenial 16.04 :

sudo a2enmod php7.0

Puis relancez Apache :

sudo systemctl restart apache2

Il est possible que plusieurs versions de PHP soient installées simultanément, par ex. après une mise à jour majeure d'ubuntu si vous avez spécifié le numéro de version de PHP lors de l'installation des paquets, ou si vous avez ajouté un PPA exotique pour installer une version spécifique de PHP (mauvaise idée, il vaut mieux dans ce cas utiliser docker).
Cela peut par ex. rendre des modules de PHP inaccessibles alors qu'ils semblent bien installés.

Vous pouvez vérifier cela avec cette commande :

apt list \*php\* --installed

Si vous voyez apparaître plusieurs versions de PHP, par ex. php7.2 et php7.0 ou php5.6, vous avez un problème(, pourquoi?). Dans ce cas supprimez les versions de PHP qui ne correspondent pas à la version proposée par les dépôts officiels d'ubuntu (php7.4 sur Focal 20.04, php7.2 sur Bionic 18.04, php7.0 sur Xenial 16.04), désinstallez le PPA exotique si il existe, puis réinstallez les paquets absents si nécessaire sans spécifier de numéro de version (libapache2-mod-php, etc).

La commande, ici sous bionic, doit retourner un message similaire, sauf si vous avez volontairement installé plusieurs versions :

sudo update-alternatives --config php
Il n'existe qu'une « alternative » dans le groupe de liens php (qui fournit /usr/bin/php) : /usr/bin/php7.2
Rien à configurer.

• (en) site officiel
• documentation officielle
• vidéo expliquant en quoi PHP est différent des autres langages de programmation

Contributeurs : krodelabestiole, bcag2