Différences

Ci-dessous, les différences entre deux révisions de la page.

--- php [Le 11/09/2022, 10:34]
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
+++ 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//.
-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).
@@ Ligne 29: / Ligne 29: @@
 ==== Ajout d'une autre version de PHP ====
-Il peut-être utile de disposer de plusieurs version de PHP sur une machine de développement (sur un serveur aussi… mais on aura plutôt recourt à [[:docker]]), 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.
-La bonne pratique pour faire cela est d'utiliser [[:PHPBrew]]
+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 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.
+=== Docker ===
+[[: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).
+=== Distrobox ===
+[[https://github.com/89luca89/distrobox|Distrobox]] est une nouvelle technologie qui permet d'installer des logiciels de [[:distributions]] différentes de la sienne (autres versions d'Ubuntu ou distributions complètement différentes). Elle repose sur docker ou d'autres systèmes de containérisation, ce qui empêche par isolation les logiciels installés d'entrer en conflit avec le système, tout en étant plus simple à utiliser et plus souple que [[:docker]].
+=== PHPBrew ===
+[[:PHPBrew]] est un autre gestionnaire de paquets qui permet d'utiliser différentes versions de PHP sans entrer en conflit les unes avec les autres.
 ===== Modules =====
@@ Ligne 81: / Ligne 97: @@
 ^ 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 ====
@@ Ligne 95: / 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.
 ==== Activer / désactiver les modules ====
@@ Ligne 105: / Ligne 120: @@
 <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.)
 ===== Configuration =====
@@ Ligne 114: / Ligne 130: @@
   * 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**\\
+Les fichiers de configuration ne sont pas les mêmes pour utiliser PHP en ligne de commande : **/etc/php/7.x/cli/php.ini** (//x// à remplacer par le second chiffre, 7.**4** par exemple)\\
-ou en script [[http://php.net/manual/fr/install.fpm.php|FastCGI]] : **/etc/php/7.0/fpm/php.ini**\\
+ou en script [[http://php.net/manual/fr/install.fpm.php|FastCGI]] : **/etc/php/7.x/fpm/php.ini**\\
 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 =====
@@ Ligne 133: / Ligne 152: @@
 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>
 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 149: / Ligne 167: @@
 ==== 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 :
@@ Ligne 157: / Ligne 175: @@
 </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 ====
@@ Ligne 166: / Ligne 184: @@
 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 =====
@@ Ligne 188: / Ligne 216: @@
   * vérifiez l'installation du paquet [[apt>libapache2-mod-php]]
   * 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>
 ==== Conflits potentiels entre plusieurs versions de PHP ====
-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 (le PPA d'//Ondřej Surý// pour ne pas le nommer, mauvaise idée, il vaut mieux dans ce cas utiliser [[:docker_lamp|docker]], ou éventuellement [[:PHPBrew]]).\\
+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 (le PPA d'//Ondřej Surý// pour ne pas le nommer, mauvaise idée, voir [[#Ajout d'une autre version de PHP]]).\\
 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 :
 <code>apt list \*php\* --installed</code>
-Si vous voyez apparaître plusieurs versions de PHP, par ex. ''php7.2'' et ''php7.0'' ou ''php5.6'', vous pouvez avoir des problèmes((https://forum.ubuntu-fr.org/viewtopic.php?id=2029875)). 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|Focal 20.04]], ''php7.2'' sur [[:bionic|Bionic 18.04]], ''php7.0'' sur [[:xenial|Xenial 16.04]]), [[:ppa#la_methode_propre_les_paquets_de_gestion_automatiqueppa-purge_launchpad-getkeys|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 ([[apt>libapache2-mod-php]], etc). Reportez-vous à [[#ajout_d_une_autre_version_de_php]] pour disposer de plusieurs version de PHP.
+Si vous voyez apparaître plusieurs versions de PHP, par ex. ''php7.2'' et ''php7.0'' ou ''php5.6'', vous pouvez avoir des problèmes((un autre [[https://forum.ubuntu-fr.org/viewtopic.php?id=2029875|exemple]])). 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|Focal 20.04]], ''php7.2'' sur [[:bionic|Bionic 18.04]], ''php7.0'' sur [[:xenial|Xenial 16.04]]), [[:ppa#la_methode_propre_les_paquets_de_gestion_automatiqueppa-purge_launchpad-getkeys|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 ([[apt>libapache2-mod-php]], etc). Reportez-vous à [[#ajout_d_une_autre_version_de_php]] pour disposer de plusieurs version de PHP.
 La commande, ici sous [[:bionic]], doit retourner un message similaire, sauf si vous avez volontairement installé plusieurs versions :