Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
php [Le 05/01/2024, 10:14] krodelabestiole [Code source visible dans le navigateur] +note réinstaller le module |
php [Le 27/02/2025, 04:55] (Version actuelle) krodelabestiole [Configuration] (cli seulement) |
||
---|---|---|---|
Ligne 19: | Ligne 19: | ||
Pour un [[:web#serveurs|serveur web]] on utilisera principalement PHP soit en //FastCGI//, soit en //module d'Apache//. | Pour un [[:web#serveurs|serveur web]] on utilisera principalement PHP soit en //FastCGI//, soit en //module d'Apache//. | ||
- | Si on utilise [[:apache2|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. | + | Si on utilise [[:apache2|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). | 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). | ||
Ligne 32: | Ligne 32: | ||
Il peut être utile de disposer de plusieurs versions de PHP, pour travailler tantôt avec un CMS, une application ou un framework ancien, nécessitant PHP 7 par exemple, tantôt avec un version plus récente (PHP 8) pour démarrer ou mettre à niveau un projet. | Il peut être utile de disposer de plusieurs versions de PHP, pour travailler tantôt avec un CMS, une application ou un framework ancien, nécessitant PHP 7 par exemple, tantôt avec un version plus récente (PHP 8) pour démarrer ou mettre à niveau un projet. | ||
- | On trouve de nombreuses documentations et tutoriels sur le [[:web]] recommandant l'utilisation du [[:PPA]] d'Ondřej Surý. C'est une très mauvaise méthode. Il s'agit d'un //hack// assez grossier consistant à inclure les numéros des versions directement dans les noms des paquets afin de les gérer individuellement avec [[:APT]]. Cette méthode posera à coup presque sûr [[#conflits_potentiels_entre_plusieurs_versions_de_php|des problèmes]] à un moment ou à un autre (lors d'une mise à jour par exemple.((le forum est pétri d'[[https://forum.ubuntu-fr.org/viewtopic.php?pid=21961901#p21961901|exemples]]))\\ | + | On trouve de nombreuses documentations et tutoriels sur le [[:web]] recommandant l'utilisation du [[:PPA]] d'Ondřej Surý. C'est une très mauvaise méthode. Il s'agit d'un //hack// assez grossier consistant à inclure les numéros des versions directement dans les noms des paquets afin de les gérer individuellement avec [[:APT]]. Cette méthode posera à coup presque sûr [[#conflits_potentiels_entre_plusieurs_versions_de_php|des problèmes]] à un moment ou à un autre (lors d'une mise à jour par exemple.((le forum est très fourni en [[https://forum.ubuntu-fr.org/viewtopic.php?pid=21961901#p21961901|exemples]]))\\ |
[[:APT]] n'est simplement pas adapté à l'installation et l'utilisation d'un même logiciel en plusieurs versions. | [[:APT]] n'est simplement pas adapté à l'installation et l'utilisation d'un même logiciel en plusieurs versions. | ||
=== Docker === | === Docker === | ||
- | [[:Docker]] est un système de containérisation qui permet d'isoler les services les uns des autres et du reste du système. On ne l'utilisera cependant de préférence pas pour PHP directement, mais, selon le paradigme docker, pour le //service// que l'on souhaite mettre en place (il existe une [[https://hub.docker.com/_/wordpress|image]] pour [[:WordPress]], par exemple). | + | [[:Docker]] est un système de contenérisation qui permet d'isoler les services les uns des autres et du reste du système. On ne l'utilisera cependant de préférence pas pour PHP directement, mais, selon le paradigme docker, pour le //service// que l'on souhaite mettre en place (il existe une [[https://hub.docker.com/_/wordpress|image]] pour [[:WordPress]], par exemple). |
Voir aussi la page //[[:docker lamp|Monter un serveur LAMP grâce à Docker]]// (qui ne suit pas le paradigme docker). | Voir aussi la page //[[:docker lamp|Monter un serveur LAMP grâce à Docker]]// (qui ne suit pas le paradigme docker). | ||
Ligne 97: | Ligne 97: | ||
^ Nom ^ Paquet ^ Description ^ | ^ Nom ^ Paquet ^ Description ^ | ||
- | | [[http://php.net/manual/fr/ref.pdo-mysql.php|MySQL (PDO)]] et [[http://php.net/manual/fr/book.mysqli.php|MySQLi]] | [[apt>php-mysql]] | support de [[:mysql|MySQL]] ou [[:mariadb|MariaDB]] | | + | | [[https://php.net/manual/fr/ref.pdo-mysql.php|MySQL (PDO)]] et [[https://php.net/manual/fr/book.mysqli.php|MySQLi]] | [[apt>php-mysql]] | support de [[:mysql|MySQL]] ou [[:mariadb|MariaDB]] | |
- | | [[http://php.net/manual/fr/book.pgsql.php|PostgreSQL]] | [[apt>php-pgsql]] | support de [[:postgresql|PostgreSQL]] | | + | | [[https://www.php.net/manual/fr/book.pgsql.php|PostgreSQL]] | [[apt>php-pgsql]] | support de [[:postgresql|PostgreSQL]] | |
- | | [[http://php.net/manual/fr/book.sqlite.php|SQLite]] | [[apt>php-sqlite3]] | support de [[:sqlite|SQLite]] | | + | | [[https://www.php.net/manual/fr/mysqli.quickstart.php|SQLite]] | [[apt>php-sqlite3]] | support de [[:sqlite|SQLite]] | |
- | | [[http://php.net/manual/fr/set.mongodb.php|MongoDB]] | [[apt>php-mongodb]] | support de [[:MongoDB]] | | + | | [[https://php.net/manual/fr/set.mongodb.php|MongoDB]] | [[apt>php-mongodb]] | support de [[:MongoDB]] | |
==== Lister les modules ==== | ==== Lister les modules ==== | ||
Ligne 111: | Ligne 111: | ||
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|phpinfo()]]// vous montrera les modules activés sur votre serveur web. | 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|phpinfo()]]// vous montrera les modules activés sur votre serveur web. | ||
- | |||
==== Activer / désactiver les modules ==== | ==== Activer / désactiver les modules ==== | ||
Ligne 121: | Ligne 120: | ||
<code>sudo phpenmod mbstring</code> | <code>sudo phpenmod mbstring</code> | ||
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.) | 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.) | ||
+ | |||
===== Configuration ===== | ===== Configuration ===== | ||
Ligne 134: | Ligne 134: | ||
Ceci explique parfois des différences de comportement entre PHP exécuté par Apache, et manuellement en ligne de commande. | Ceci explique parfois des différences de comportement entre PHP exécuté par Apache, et manuellement en ligne de commande. | ||
+ | |||
+ | <note tip>Pour savoir où se trouve le fichier ''php.ini'' utilisé par la commande ''php'', exécuter : <code bash>php --ini</code> | ||
+ | Pour avoir des informations dont le fichier ''php.ini'' utilisé par le serveur web, il faut par contre passer par la fonction ''[[#phpinfo()]]''.</note> | ||
==== Activer le rapport d'erreur ===== | ==== Activer le rapport d'erreur ===== | ||
Ligne 149: | Ligne 152: | ||
On peut désactiver l'affichage de ces messages pas toujours très importants en remplaçant cette ligne par celle-ci : | On peut désactiver l'affichage de ces messages pas toujours très importants en remplaçant cette ligne par celle-ci : | ||
<file>php_value error_reporting "E_ALL & ~E_NOTICE & ~E_STRICT"</file> | <file>php_value error_reporting "E_ALL & ~E_NOTICE & ~E_STRICT"</file> | ||
- | |||
Les directives ''display_errors'' et ''error_reporting'' sont aussi accessibles pour définir l'affichage des erreurs globalement, directement dans votre fichier ''php.ini''.\\ | Les directives ''display_errors'' et ''error_reporting'' sont aussi accessibles pour définir l'affichage des erreurs globalement, directement dans votre fichier ''php.ini''.\\ | ||
Ligne 165: | Ligne 167: | ||
==== phpinfo() ==== | ==== phpinfo() ==== | ||
- | La fonction //[[http://php.net/manual/fr/function.phpinfo.php|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 fonction ''[[phpfn>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 : | 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 : | ||
Ligne 173: | Ligne 175: | ||
</file> | </file> | ||
- | On appelle ensuite ce script depuis un navigateur web : [[http://example/phpinfo.php]] | + | On appelle ensuite ce script depuis un navigateur web : ''[[http://example/phpinfo.php]]'' |
==== OPcache ==== | ==== OPcache ==== | ||
Ligne 182: | Ligne 184: | ||
OPcache est activé par défaut sur Ubuntu. | OPcache est activé par défaut sur Ubuntu. | ||
+ | ===== Serveur ===== | ||
+ | |||
+ | **PHP** implémente un [[:web#serveurs|serveur web]], principalement utilisé pour du développement ou des tests rapides. | ||
+ | |||
+ | On peut le lancer depuis certains [[:IDE]] ou directement en ligne de commande : | ||
+ | <code>php -S localhost:8000</code> | ||
+ | pour lancer ce serveur sur le port ''8000''. | ||
+ | |||
+ | Voir si besoin la [[https://www.php.net/manual/fr/features.commandline.webserver.php|documentation officielle]]. | ||
+ | |||
===== Problèmes courants ===== | ===== Problèmes courants ===== | ||
Ligne 204: | Ligne 216: | ||
* vérifiez l'installation du paquet [[apt>libapache2-mod-php]] | * vérifiez l'installation du paquet [[apt>libapache2-mod-php]] | ||
* s'il est bien installé, activez le module : | * s'il est bien installé, activez le module : | ||
+ | * sur [[:noble|Noble 24.04]] : <code>sudo a2enmod php8.3</code> | ||
+ | * sur [[:jammy|Jammy 22.04]] : <code>sudo a2enmod php8.1</code> | ||
+ | * sur [[:focal|Focal 20.04]] : <code>sudo a2enmod php7.4</code> | ||
+ | * sur [[:bionic|Bionic 18.04]] : <code>sudo a2enmod php7.2</code> | ||
+ | * puis relancez Apache : <code>sudo systemctl restart apache2</code> | ||
- | sur [[:focal|Jammy 22.04]] : | + | <note>Si vous rencontrez une erreur du type ''Module php8.1 does not exist!'' alors que le paquet ''libapache2-mod-php'' semble installé, supprimez le paquet ''libapache2-mod-php8.x'' (''8.x'' étant la version de PHP installée sur votre système) et ses dépendances avec une commande de la forme : |
- | <code>sudo a2enmod php8.1</code> | + | <code>sudo apt autopurge libapache2-mod-php8.x</code> (''8.x'' à adapter) puis réinstallez le paquet [[apt>libapache2-mod-php]].</note> |
- | sur [[:focal|Focal 20.04]] : | + | |
- | <code>sudo a2enmod php7.4</code> | + | |
- | sur [[:bionic|Bionic 18.04]] : | + | |
- | <code>sudo a2enmod php7.2</code> | + | |
- | Puis relancez Apache : | ||
- | <code>sudo systemctl restart apache2</code> | ||
- | |||
- | <note>Si vous rencontrez une erreur du type ''Module php8.1 does not exist!'', supprimez le paquet ''libapache2-mod-php8.x'' (''8.x'' étant la version de PHP installée sur votre système) et ses dépendances avec une commande de la forme : | ||
- | <code>sudo apt autopurge libapache2-mod-php8.x</code> (''8.x'' à adapter) puis réinstallez le paquet [[apt>libapache2-mod-php]].</note> | ||
==== Conflits potentiels entre plusieurs versions de PHP ==== | ==== Conflits potentiels entre plusieurs versions de PHP ==== | ||