| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| php [Le 01/06/2022, 10:49] – [Conflits potentiels entre plusieurs versions de PHP] lien vers le forum comme exemple bcag2 | php [Le 14/02/2026, 20:47] (Version actuelle) – [Configuration] chemin complet en exemple krodelabestiole |
|---|
| | {{tag>Noble Jammy php serveur}} |
| {{tag>Bionic Focal php serveur}} | |
| |
| ====== PHP ====== | ====== PHP ====== |
| |
| PHP (acronyme récursif pour "**P**HP: **H**ypertext **P**reprocessor", PHP étant au départ l'acronyme de **P**ersonal **H**ome **P**age) 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 [[:apache2|Apache]]) pour la communication avec le client web. | PHP (acronyme récursif pour //**P**HP: **H**ypertext **P**reprocessor//, PHP étant initialement l'acronyme de //**P**ersonal **H**ome **P**age//) 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 [[:web#serveurs|serveur HTTP]] (comme [[:apache2|Apache]]) pour la communication avec le [[:web#clients|client web]]. |
| |
| La production de [[:cms|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]].. | La production de [[:cms|pages web dynamiques]] pouvant nécessiter une interaction avec une base de données, PHP est souvent utilisé en association avec un [[wpfr>système de gestion de base de données]] (SGBD) comme [[:MySQL]]. |
| |
| ===== Installation ===== | ===== Installation ===== |
| <note tip>Pour installer PHP avec Apache et MySQL ou MariaDB, reportez-vous de préférence à la [[:LAMP|page LAMP]].</note> | <note tip>Pour installer PHP avec Apache et MySQL ou MariaDB, reportez-vous de préférence à la [[:LAMP|page LAMP]].</note> |
| |
| Il existe 4 manières d'installer et utiliser PHP sur Ubuntu : | Il existe plusieurs manières d'installer et utiliser PHP sur Ubuntu : |
| * en ligne de commande (ou donc dans un [[:tutoriel:script_shell|script shell]]) via [[:tutoriel:comment_installer_un_paquet|l'installation du paquet]] **[[apt>php-cli]]** (//cli// pour //command-line interface//) | * en [[:commande shell|ligne de commande]] (commande ''[[man>php]]'') via [[:deb#installer_un_paquet_deb|l'installation du paquet]] ''[[apt>php-cli]]'' (''cli'' pour //command-line interface//) |
| * avec un serveur HTTP en [[wpfr>FastCGI|script FastCGI]] via [[:tutoriel:comment_installer_un_paquet|l'installation du paquet]] **[[apt>php-fpm]]** (//fpm// pour //FastCGI Process Manager//) | * avec un serveur HTTP en [[wpfr>FastCGI|script FastCGI]] via [[:deb#installer_un_paquet_deb|l'installation du paquet]] ''[[apt>php-fpm]]'' (''fpm'' pour //FastCGI Process Manager//) |
| * avec un serveur HTTP en script CGI via [[:tutoriel:comment_installer_un_paquet|l'installation du paquet]] **[[apt>php-cgi]]** (c'est une méthode historique qui n'a plus trop d'intérêt) | * avec un serveur HTTP en script CGI via [[:deb#installer_un_paquet_deb|l'installation du paquet]] ''[[apt>php-cgi]]'' (c'est une méthode historique qui n'a plus trop d'intérêt) |
| * en [[:apache2#mod_php|module d'Apache]] via [[:tutoriel:comment_installer_un_paquet|l'installation du paquet]] **[[apt>libapache2-mod-php]]** | * en [[:apache2#mod_php|module d'Apache]] via [[:deb#installer_un_paquet_deb|l'installation du paquet]] ''[[apt>libapache2-mod-php]]'' |
| |
| 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). |
| Avec un serveur HTTP autre que Apache, on utilise aussi PHP en FastCGI : il n'existe pas de module PHP pour [[:Nginx]] ou [[:Lighttpd]]. | Avec un [[:web#serveurs|serveur HTTP]] autre que [[:apache2|Apache]], on utilise aussi PHP en FastCGI : il n'existe pas de module PHP pour [[:Nginx]], [[:Lighttpd]] ni [[https://caddyserver.com/|Caddy]].((En dehors de modules non officiels, comme [[https://frankenphp.dev/fr/|FrankenPHP]] pour [[https://caddyserver.com/|Caddy]].)) |
| |
| Chacun de ces paquets installera toutes les dépendances nécessaires au fonctionnement de PHP sur votre machine. | 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. | PHP est alors installé. Cependant la plupart des scripts PHP ([[:CMS]], forums, [[:web#applications web]] en tout genre) utilisent des modules de PHP pour bénéficier de certaines fonctionnalités. |
| |
| ==== Ajout d'une autre version de PHP ==== | ==== Ajout d'une autre version de PHP ==== |
| <note warning>Cela peut engendrer des conflits, cf [[#conflits_potentiels_entre_plusieurs_versions_de_php]] </note> | |
| 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. | |
| <code bash> | |
| # 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 | 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. |
| 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: | 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]]))\\ |
| $ php -v | [[:APT]] n'est simplement pas adapté à l'installation et l'utilisation d'un même logiciel en plusieurs versions. |
| PHP 8.1.6 (cli) (built: May 17 2022 16:47:53) (NTS) | |
| </code> | |
| |
| Le basculement entre ces versions peut se faire par la commande : | === Docker === |
| <code bash> | |
| sudo update-alternatives --config php | [[: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). |
| </code> | |
| | 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 ===== | ===== Modules ===== |
| 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. | 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 : **[[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]]** | 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]]''. |
| |
| ==== Modules installés par défaut ==== | ==== Modules installés par défaut ==== |
| |
| [[https://packages.ubuntu.com/focal/amd64/php7.4-common/filelist|Certains modules]] sont installés par défaut avec PHP via le paquet **[[apt>php-common]]**. | [[https://packages.ubuntu.com/noble/amd64/php8.3-common/filelist|Certains modules]] sont installés par défaut avec PHP via le paquet ''[[apt>php-common]]''. |
| |
| * [[http://php.net/manual/fr/book.calendar.php|Calendar]] | * [[http://php.net/manual/fr/book.calendar.php|Calendar]] |
| |
| ^ Nom ^ Paquet ^ Description ^ | ^ Nom ^ Paquet ^ Description ^ |
| | [[http://php.net/manual/fr/book.curl.php|cURL]] | [[apt>php-curl]] | Support de [[wpfr>cURL]], qui permet de se connecter et de communiquer avec d'autres serveurs en HTTP, HTTPS, FTP, gopher, telnet, DICT, file ou LDAP. | | | [[http://php.net/manual/fr/book.curl.php|cURL]] | ''[[apt>php-curl]]'' | Support de [[wpfr>cURL]], qui permet de se connecter et de communiquer avec d'autres serveurs en HTTP, HTTPS, FTP, gopher, telnet, DICT, file ou LDAP. | |
| | [[http://php.net/manual/fr/book.image.php|GD]] | [[apt>php-gd]] | Outil de traitement d'images. | | | [[http://php.net/manual/fr/book.image.php|GD]] | ''[[apt>php-gd]]'' | Outil de traitement d'images. | |
| | [[http://php.net/manual/fr/book.intl.php|intl]] | [[apt>php-intl]] | Fonctions d'internationalisation. | | | [[http://php.net/manual/fr/book.intl.php|intl]] | ''[[apt>php-intl]]'' | Fonctions d'internationalisation. | |
| | [[http://php.net/manual/fr/book.json.php|JSON]] | [[apt>php-json]] | Implémente le format d'échange de données [[wpfr>JavaScript Object Notation]]. | | | [[http://php.net/manual/fr/book.json.php|JSON]] | ''[[apt>php-json]]'' | Implémente le format d'échange de données [[wpfr>JavaScript Object Notation]]. | |
| | [[http://php.net/manual/fr/book.mcrypt.php|Mcrypt]] | [[apt>php-mcrypt]] | Implémente des algorithmes de chiffrement. Ce module **n'existe plus depuis PHP 7.2** ([[:Bionic]]). Il faut maintenant utiliser [[http://php.net/manual/fr/book.sodium.php|Sodium]] ou [[http://php.net/manual/fr/book.openssl.php|OpenSSL]]. | | | [[http://php.net/manual/fr/book.mcrypt.php|Mcrypt]] | ''[[apt>php-mcrypt]]'' | Implémente des algorithmes de chiffrement. Ce module **n'existe plus depuis PHP 7.2** ([[:Bionic]]). Il faut maintenant utiliser [[http://php.net/manual/fr/book.sodium.php|Sodium]] ou [[http://php.net/manual/fr/book.openssl.php|OpenSSL]]. | |
| | [[http://php.net/manual/fr/book.mbstring.php|mbstring]] | [[apt>php-mbstring]] | Implémente des jeux de caractères très grands pour certaines langues. | | | [[http://php.net/manual/fr/book.mbstring.php|mbstring]] | ''[[apt>php-mbstring]]'' | Implémente des jeux de caractères très grands pour certaines langues. | |
| | [[http://php.net/manual/fr/book.xml.php|XML]] | [[apt>php-xml]] | Analyseur syntaxique XML (permet à PHP de "comprendre" du XML ou du HTML). | | | [[http://php.net/manual/fr/book.xml.php|XML]] | ''[[apt>php-xml]]'' | Analyseur syntaxique XML (permet à PHP de "comprendre" du XML ou du HTML). | |
| | [[http://php.net/manual/fr/book.zip.php|Zip]] | [[apt>php-zip]] | Offre la possibilité de lire et d'écrire des archives compressées ZIP, et d'accéder aux fichiers et dossiers s'y trouvant. | | | [[http://php.net/manual/fr/book.zip.php|Zip]] | ''[[apt>php-zip]]'' | Offre la possibilité de lire et d'écrire des archives compressées ZIP, et d'accéder aux fichiers et dossiers s'y trouvant. | |
| | [[http://php.net/manual/fr/book.imagick.php|ImageMagick]] | [[apt>php-imagick]] | Outil de traitement d'images. | | | [[http://php.net/manual/fr/book.imagick.php|ImageMagick]] | ''[[apt>php-imagick]]'' | Outil de traitement d'images. | |
| | [[http://php.net/manual/fr/book.imap.php|IMAP]] | [[apt>php-imap]] | Implémentations des protocoles IMAP, NNTP, et POP3 pour les [[:courriel|courriels]]. | | | [[http://php.net/manual/fr/book.imap.php|IMAP]] | ''[[apt>php-imap]]'' | Implémentations des protocoles IMAP, NNTP, et POP3 pour les [[:courriel|courriels]]. | |
| | [[http://php.net/manual/fr/book.apcu.php|APCu]] | [[apt>php-apcu]] | Fournit des fonctionnalités supplémentaires au système de cache implémenté nativement dans PHP ([[#OPcache]]). | | | [[http://php.net/manual/fr/book.apcu.php|APCu]] | ''[[apt>php-apcu]]'' | Fournit des fonctionnalités supplémentaires au système de cache implémenté nativement dans PHP ([[#OPcache]]). | |
| |
| ==== Association avec un serveur de base de données ==== | ==== Association avec un serveur de base de données ==== |
| |
| ^ 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 ==== |
| |
| Vous pouvez lister la plupart des modules PHP disponibles dans les dépôts officiels avec la commande | Vous pouvez lister la plupart des modules PHP disponibles dans les dépôts officiels avec la commande ''[[:apt-cli|apt]]'' : |
| <code>apt list php-\*</code> | <code>apt list ~n^php-</code> |
| |
| Vous pouvez lister les modules installés sur votre système grâce à la commande | Vous pouvez lister les modules installés sur votre système grâce à la commande |
| <code>php -m</code> | <code>php -m</code> |
| |
| 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 ==== |
| 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. | 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''.\\ | On peut activer / désactiver un module respectivement avec les commandes ''[[man>phpenmod]]'' et ''[[man>phpdismod]]''.\\ |
| Par exemple : | Par exemple : |
| <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 ===== |
| |
| La configuration de PHP se fait via un fichier ''php.ini''. | La configuration de **PHP** se trouve principalement dans un fichier ''php.ini'' dont le [[:chemins|chemin]] dépend principalement de la manière dont est utilisé PHP (voir [[#installation|ci-dessus]]. |
| |
| Pour le [[:apache2#mod_php|module PHP d'Apache]], le chemin d'accès au fichier ''php.ini'' sera généralement : | <note important> |
| * sous [[:Trusty]] (Ubuntu 14.04) : **/etc/php5/apache2/php.ini**\\ | On peut techniquement modifier les fichiers ''php.ini'', mais ceux-ci sont créés par [[:APT]] et peuvent être écrasés lors de n'importe quelle mise à jour. |
| * 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**\\ | Pour mettre en place des paramètres de configuration personnalisés, mieux vaut utiliser le répertoire ''conf.d'' qui existe généralement au même niveau que le fichier ''php.ini'' concerné, et créer par exemple un fichier ''/etc/php/8.3/apache2/conf.d/custom.ini'' contenant exclusivement les directives à créer ou à ajuster. |
| ou en script [[http://php.net/manual/fr/install.fpm.php|FastCGI]] : **/etc/php/7.0/fpm/php.ini**\\ | </note> |
| | |
| | Pour le [[:apache2#mod_php|module PHP d'Apache]], le [[:chemins|chemin d'accès]] au fichier ''php.ini'' sera généralement : |
| | * sous Ubuntu [[:noble|Noble 24.04]] : ''/etc/php/8.3/apache2/php.ini'' |
| | * sous Ubuntu [[:jammy|Jammy 22.04]] : ''/etc/php/8.1/apache2/php.ini'' |
| | * sous Ubuntu [[:focal|Focal 20.04]] : ''/etc/php/7.4/apache2/php.ini'' |
| | * sous Ubuntu [[:bionic|Bionic 18.04]] : ''/etc/php/7.2/apache2/php.ini'' |
| | |
| | Les fichiers de configuration ne sont pas les mêmes pour utiliser PHP en ligne de commande : ''/etc/php%%/%%//8.x//%%/%%cli/php.ini'' (''//8.x//'' à remplacer par la version de PHP, ''8.3'' sur [[:Noble]] par exemple)\\ |
| | ou en script [[http://php.net/manual/fr/install.fpm.php|FastCGI]] : ''/etc/php/8.x/fpm/php.ini''. |
| |
| 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 ''[[man>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 ===== |
| 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''.\\ |
| Pour PHP 7.0 : | Pour PHP 8.3 : |
| <file - /etc/php/7.0/apache2/php.ini>... | <file - /etc/php/8.3/apache2/php.ini>... |
| display_errors=on | display_errors=on |
| error_reporting=E_ALL & ~E_NOTICE & ~E_STRICT | error_reporting=E_ALL & ~E_NOTICE & ~E_STRICT |
| ==== 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 : |
| </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 ==== |
| |
| [[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. | Il est désormais intégré nativement à PHP depuis la version 5.5. |
| |
| 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 ===== |
| |
| ==== Code source visible dans le navigateur ==== | ==== 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). | 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). |
| |
| |
| Si vous utilisez [[:apache2#mod_php|PHP en tant que module d'Apache]] : | Si vous utilisez [[:apache2#mod_php|PHP en tant que module d'Apache]] : |
| * 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 [[: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> |
| <code>sudo systemctl restart apache2</code> | Si vous rencontrez une erreur du type ''Module php8.1 does not exist!'' alors que le paquet ''libapache2-mod-php'' semble installé, [[:deb#installer_un_paquet_deb|supprimez le paquet]] ''libapache2-mod-php//8.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 ==== |
| |
| 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 exemple 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 citer -- mauvaise idée, voir plutôt //[[#Ajout d'une autre version de PHP]]//).\\ |
| Cela peut par ex. rendre des modules de PHP inaccessibles alors qu'ils semblent bien installés. | Cela peut entre autre rendre des modules de PHP inaccessibles alors qu'ils semblent bien installés. |
| |
| Vous pouvez vérifier cela avec cette commande : | Vous pouvez vérifier cela avec cette commande : |
| <code>apt list \*php\* --installed</code> | <code>apt list ~nphp --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). | 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 (''php8.3'' sur [[:noble|Noble 24.04]], ''php8.1'' sur [[:jammy|Jammy 22.04]], ''php7.4'' sur [[:focal|Focal 20.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 : | La commande, ici sous [[:bionic]], doit retourner un message similaire, sauf si vous avez volontairement installé plusieurs versions : |
| * [[https://www.youtube.com/watch?v=US9JCsnAVTU|vidéo expliquant en quoi PHP est différent des autres langages de programmation]] | * [[https://www.youtube.com/watch?v=US9JCsnAVTU|vidéo expliquant en quoi PHP est différent des autres langages de programmation]] |
| |
| //Contributeurs : [[utilisateurs:krodelabestiole]], [[utilisateurs:bcag2]]// | ---- |
| | //[[:Contributeurs]] : [[:utilisateurs:krodelabestiole]], [[:utilisateurs:bcag2]].// |