Différences

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

--- php [Le 08/11/2020, 11:28]
193.194.70.14 [PHP]
+++ php [Le 27/02/2025, 04:55] (Version actuelle)
krodelabestiole [Configuration] (cli seulement)
@@ Ligne 1: / Ligne 1: @@
-{{tag>Xenial Bionic Focal php serveur}}
+{{tag>Bionic Focal php serveur}}
 ====== PHP ======
@@ 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).\\
+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.
-<note>Sous [[:Xenial]] (16.04), à moins qu'on ait déjà installé le module d'Apache, le paquet **[[apt>php]]** installe par dépendance **php-fpm** (//FastCGI//).
+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.
-Tandis que sous [[:debian_ubuntu_comparaison|Debian]] le paquet **php** installe par défaut le module d'Apache, et Apache.
+==== Ajout d'une autre version de PHP ====
-Attention donc à ne pas installer le paquet **php** sans le paquet **libapache2-mod-php** si vous ne souhaitez pas utiliser **php-fpm**.
+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.
-Ce comportement a été corrigé sous [[:Bionic]] (18.04), qui rejoint celui de Debian.</note>
+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.
-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.
+=== 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 40: / Ligne 53: @@
 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.
-Voici comment installer rapidement les modules les plus courants :
+Vous pouvez installer rapidement les modules les plus courants : **[[apt>php-curl,php-gd,php-intl,php-json,php-mbstring,php-xml,php-zip|php-curl php-gd php-intl php-json php-mbstring php-xml php-zip]]**
-<code bash>sudo apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip</code>
-<note important>
-Pour les versions récentes d'Ubuntu, ne spécifiez pas le numéro de version de PHP dans les noms des paquets qui le concernent, le système installera la dernière version… 7.* :\\
-\\
-par exemple ''php5-curl'' sous [[:trusty|Ubuntu 14.04 Trusty]] devient ''php7.0-curl'' sur [[:xenial|Ubuntu 16.04 Xenial]], plus simplement accessible par ''php-curl'' que ce soit sur Xenial (pour PHP 7.0), sur [[:bionic|Ubuntu 18.04 Bionic]] (pour PHP 7.2) ou sur [[:focal|Ubuntu 20.04 Focal]] (pour PHP 7.4).
-</note>
 ==== Modules installés par défaut ====
@@ Ligne 91: / 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 105: / 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 115: / 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 120: / Ligne 126: @@
 Pour le [[:apache2#mod_php|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**\\
+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 144: / 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 160: / 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 168: / 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 ====
-[[http://php.net/manual/fr/book.opcache.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.\\
+[[http://php.net/manual/fr/book.opcache.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.
+===== 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 191: / Ligne 208: @@
 ==== Code source visible dans le navigateur ====
-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.\\
+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).
@@ Ligne 199: / Ligne 216: @@
   * vérifiez l'installation du paquet [[apt>libapache2-mod-php]]
   * s'il est bien installé, activez le module :
-sur [[:focal|Focal 20.04]] :
+    * sur [[:noble|Noble 24.04]] : <code>sudo a2enmod php8.3</code>
-<code>sudo a2enmod php7.4</code>
+    * sur [[:jammy|Jammy 22.04]] : <code>sudo a2enmod php8.1</code>
-sur [[:bionic|Bionic 18.04]] :
+    * sur [[:focal|Focal 20.04]] : <code>sudo a2enmod php7.4</code>
-<code>sudo a2enmod php7.2</code>
+    * sur [[:bionic|Bionic 18.04]] : <code>sudo a2enmod php7.2</code>
-sur [[:xenial|Xenial 16.04]] :
+  * puis relancez Apache : <code>sudo systemctl restart apache2</code>
-<code>sudo a2enmod php7.0</code>
-Puis relancez Apache :
+<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 systemctl restart apache2</code>
+<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 ====
-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_lamp|docker]]).\\
+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 avez un problème. 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).
+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 :
@@ Ligne 226: / Ligne 243: @@
 ===== Voir aussi =====
-  * **(en)** [[http://www.php.net/|site officiel]]
+  * **(en)** [[https://www.php.net/|site officiel]]
   * [[http://php.net/manual/fr/|documentation officielle]]
   * [[https://www.youtube.com/watch?v=US9JCsnAVTU|vidéo expliquant en quoi PHP est différent des autres langages de programmation]]
-//Contributeurs : [[utilisateurs:krodelabestiole]]//
+//Contributeurs : [[utilisateurs:krodelabestiole]], [[utilisateurs:bcag2]]//