Ceci est une ancienne révision du document !
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.
Installation
Il existe 4 manières d'utiliser PHP sur Ubuntu :
- en ligne de commande (ou donc dans un script shell) via le paquet php-cli
- avec un serveur HTTP en script FastCGI via le paquet php-fpm
- avec un serveur HTTP en script CGI via le paquet php-cgi (c'est une méthode historique qui n'a plus trop d'intérêt)
- en module d'Apache via le paquet libapache2-mod-php
Pour un serveur web on utilisera donc 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. Avec un serveur HTTP autre que Apache, on utilise aussi PHP en FastCGI : il n'existe pas de module PHP pour Nginx ou Lighttpd.
Tandis que sous Debian le paquet php installe par défaut le module d'Apache, et Apache.
Attention donc à ne pas installer le paquet php sans le paquet libapache2-mod-php si vous ne souhaitez pas utiliser php-fpm.
Installation en module d'Apache
Installation en FastCGI
Association avec un serveur de base de données
PHP permet de se connecter à différents types de serveurs de base de données. Il est cependant nécessaire d'installer des modules complémentaires.
Support de MySQL et MariaDB
Le support de MySQL ou MariaDB par PHP se fait via l'installation du paquet php-mysql.
Support de PostgreSQL
Le support de PostgreSQL par PHP se fait via l'installation du paquet php-pgsql.
Support de SQLite
Le support de SQLite par PHP se fait via l'installation du paquet php-sqlite.
Support de Sybase / MS SQL server
Le support de Sybase / MS SQL server par PHP se fait via l'installation du paquet php-sybase.
Installation des modules complémentaires
Voir la page dédiée aux modules PHP.
Configuration
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 Ubuntu 14.04 : /etc/php5/apache2/php.ini
- sous Ubuntu 16.04 : /etc/php/7.0/apache2/php.ini
Les fichiers de configuration ne sont pas les mêmes pour utiliser PHP en ligne de commande (cli pour command-line interface) : /etc/php/7.0/cli/php.ini
ou en script FastCGI (fpm pour FastCGI Process Manager) : /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.
Activer le rapport d'erreur
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_flag 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_flag 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 ...
Désactiver le rapport d'erreur
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