Ceci est la version imprimable de Programmation PHP.

Si vous imprimez cette page, choisissez « Aperçu avant impression » dans votre navigateur, ou cliquez sur le lien Version imprimable dans la boîte à outils, vous verrez cette page sans ce message, ni éléments de navigation sur la gauche ou en haut.
Cliquez sur Rafraîchir cette page pour obtenir la dernière version du wikilivre.
Pour plus d'informations sur les version imprimables, y compris la manière d'obtenir une version PDF, vous pouvez lire l'article Versions imprimables.

Programmation PHP

Une version à jour et éditable de ce livre est disponible sur Wikilivres,
une bibliothèque de livres pédagogiques, à l'URL :
https://fr.wikibooks.org/wiki/Programmation_PHP

Vous avez la permission de copier, distribuer et/ou modifier ce document selon les termes de la Licence de documentation libre GNU, version 1.2 ou plus récente publiée par la Free Software Foundation ; sans sections inaltérables, sans texte de première page de couverture et sans Texte de dernière page de couverture. Une copie de cette licence est incluse dans l'annexe nommée « Licence de documentation libre GNU ».

Catégorie:Versions imprimables#Programmation%20PHP/Version%20imprimable

Introduction

Historique

Répartition des langages de programmation côté serveur, des sites Internet le 28 avril 2016.

PHP est un langage de script créé par Rasmus Lerdorf en 1995. Principalement utilisé pour la programmation Web, on pourrait le situer entre les SSI (Server Side Includes) et le langage de script Perl. Il est utilisable sur tous les systèmes d'exploitation, donc sur Windows, MacOS, GNU-Linux ou autre Unix commercial, ce qui en fait un langage très portatif.

La sortie de PHP 5 en 2004 a permis au langage d'atteindre une certaine maturité, pour être reconnu comme un serveur d'application à part entière tel que JEE ou .Net.

PHP a ensuite acquis une place incontournable dans le développement Web Open Source. Sa popularité vient de sa syntaxe, proche du C, de sa vitesse et de sa simplicité. En 2013, on estime qu'il y a plus de 244 millions de serveurs qui utilisent le langage. En 2016 il est utilisé dans plus de 80 % des sites Internet, et toujours 77,5 % en août 2022^[1].

PHP 5

Les nouvelles fonctionnalités du PHP 5 (paru en 2004) concernent surtout la programmation orientée objet^[2] :

interfaces
classes abstraites
constructeurs et destructeurs de classes (ainsi que d'autres méthodes magiques)
portée des attributs et méthodes (public, protected, private)
attributs et méthodes statiques
attributs et méthodes finaux
type hinting de classe.

PHP 7

Les principales fonctionnalités apportées par PHP 7 (depuis 2015) sont^[3] :

typage strict par classe
paramètres typés
retours de méthode typés
opérateur de coalescence null (??)
opérateur vaisseau spatial (<=>)
tableaux de constantes
classes anonymes
groupage des déclarations (use, avec des accolades).

PHP 8

Nouvelles fonctionnalités du PHP 8.0 en 2020^[4]^[5] :

paramètres nommés
types d'union (X|Y)
propriétés promues (déclarations dans le constructeur)
autorisation d'une virgule de fin dans les paramètres
autorisation des méthodes abstraites dans les traits
autorisation des indices négatifs dans les tableaux autoincrémentés
l'instruction match
opérateur null-safe (?->)
fonction str_contains()
fonction str_starts_with() et str_ends_with()
fonction get_debug_type() : il s'agit d'un gettype() plus précis, car il renvoie le nom de la classe au lieu de "object"
exécution juste-à-temps (JIT), pour améliorer les performances : plus de 20 % de requêtes en plus par seconde^[6].

8.1

Pour PHP 8.1, sorti en novembre 2021 :

types d'intersection (X&Y)
type de retour never
constantes de classe finales
énumérations
fibres (threads virtuels pilotés par la classe Fiber)
fonction array_is_list()
attributs en lecture seule (readonly).

8.2

PHP 8.2 est sorti le 8 décembre 2022^[7] :

classes en lecture seule : readonly class signifie que tous les arguments de son constructeur son implicitement en readonly.
types null, true et false.
constantes dans les traits.
Forme normale disjonctive de type (combinaison de l'union et de l'intersection).

8.3

PHP 8.3 sort le 23 novembre 2023^[8] :

classes anonymes en lecture seule.
constantes typées.
fonction "json_validate".

8.4

PHP 8.4 date du 21 novembre 2024 :

Property Hooks : définition des accesseurs depuis leur attribut.
Visibilité asymétrique (aviz) : définition de la portée des accesseurs depuis la promotion de propriété.
Objets paresseux (lazy objects)^[9] : objets instanciés au moment où ils sont appelés.
Attribut #[\Deprecated] (pour remplacer l'annotation)^[10].

Sites Web statiques ou dynamiques

À l'origine du Web, les sites Web étaient des sites statiques : constitués d'un ensemble de pages écrites dans le langage HTML. L'information présente sur ces pages était toujours identique et leur mise à jour était particulièrement fastidieuse. Le serveur Web se contentait de diffuser les pages telles quelles à l'utilisateur. L'interaction entre le site et l'utilisateur était très sommaire : l'utilisateur demandait une page web et le serveur la lui fournissait.

Aujourd'hui la plupart des sites sont dynamiques : à l'intérieur des pages HTML, le concepteur du site a inséré des programmes. Ces programmes permettent une plus grande souplesse dans la gestion du site, sa mise à jour et ses fonctionnalités. La possibilité d'insérer des programmes a permis de décupler les fonctionnalités des sites Web.

Pour vous en convaincre prenons quelques exemples :

Vous voulez écrire un site qui présente une centaine de produits. Vous n'allez pas écrire 100 pages différentes, une pour chacun des produits ! Mais plutôt une seule page (page type) permettant de présenter n'importe quel produit. Cette page va contenir un programme qui interagira avec une base de données. Dans la base de données, seront stockées les informations utiles pour chaque produit : le nom du produit, sa présentation, sa référence, son prix, etc. Le programme aura donc pour rôle d'aller chercher l'information utile dans la base de données et de l'afficher en HTML. De plus, pour ajouter un produit, il suffira d'ajouter un élément dans la base de données. Il est même possible d'avoir des programmes permettant de passer une commande pour vos différents produits !
Vous voulez diffuser rapidement des informations sur Internet : vous voulez avoir un outil convivial qui vous permet d'ajouter un article, de le modifier, de le supprimer... Vous allez donc écrire un programme permettant de modifier à volonté les différents articles. Un exemple bien connu de ce type de programme est le blog : il s'agit d'un programme permettant à n'importe quel utilisateur non informaticien de gérer ses différents articles.
L'encyclopédie Wikipédia est réalisée avec un programme (en PHP d'ailleurs) qui permet à chaque utilisateur de créer et de modifier les articles tout en gardant un historique complet des différentes versions des articles.
les forums de discussion sont des lieux d'échange permettant une interaction étroite entre le serveur et l'utilisateur. Grâce aux programmes qu'ils utilisent, il est possible de se connecter, de consulter les messages des différents forums, d'y répondre. Les modérateurs de ces forums peuvent modifier les messages, les supprimer, interdire un utilisateur indélicat.

Dans chacun des exemples précédents il a été nécessaire d'incorporer un programme à l'intérieur des pages du site afin de réaliser des fonctionnalités de haut niveau. Aujourd'hui la quasi-totalité des sites professionnels sont dynamiques et il est quasi inconcevable de réaliser un site statique. Le langage PHP est un des langages utilisables pour réaliser facilement les sites Web dynamiques, ne serait-ce que parce qu'il est disponible sur la plupart des serveurs hébergeant des sites.

Possibilités

Si vous êtes déjà allés sur un site qui vous demandait de vous connecter, vous avez utilisé un script côté serveur. Ce script était certainement écrit en PHP, en raison de la popularité de ce dernier.

PHP transforme une page statique (fichier HTML par exemple), en une suite d'instructions interprétables par PHP, installée sur un serveur Web comme Apache - ça peut-être simplement un "Hello World" 50 fois dans une colonne, ou une interaction avec un système de base de données, comme MySQL, fréquemment couplé à PHP.

Mais PHP peut aussi servir à programmer des batchs sans page web aucune.

Les premières versions de PHP étaient faiblement typées, mais depuis la version 7 il est possible de forcer un typage fort dans un fichier en lui ajoutant :

 declare(strict_types = 1);

Installer PHP

Principe

Dans la cadre d'un apprentissage, des sites comme http://phpfiddle.org/ ou Tutorialspoint permettent d'exécuter ponctuellement des petits scripts PHP sans rien installer.

Par ailleurs, installer PHP seul permet d'exécuter des commandes shell (ex : php -v donne la version, et php -i toutes les infos telles que les paramètres de limite mémoire), mais le réel intérêt est d'installer PHP en complément d'un serveur HTTP, pour y publier des sites web.

Unix / Linux

LAMP

Logiciel tout-en-un pour Linux (Apache + MySQL + PHP), comme WAMP pour Windows.

commande nécessitant les privilèges root

# apt-get install tasksel
# tasksel install lamp-server

Installation manuelle

L'installation des logiciels séparément permet plus de personnalisation, par exemple de remplacer Apache par Nginx.

Apache sur Debian / Ubuntu

commande nécessitant les privilèges root

# apt-get install apache2

Le service peut ne pas être lancé par défaut, mais même s'il l'est on peut quand-même essayer de l'activer avec :

commande nécessitant les privilèges root

# /etc/init.d/apache2 start

On peut ensuite tester le serveur, pour voir si une page s'affiche ou s'il refuse la connexion :

commande

$ lynx http://localhost/

Cette adresse est le rebouclage, elle peut aussi être rentrée directement dans tout navigateur web.

Si Apache était déjà installé vérifier le fichier pour indiquer le démarrage automatique d'Apache 2 /etc/default/apache2 :

 # vi /etc/default/apache2
 ...
 NO_START=0

Installer PHP

On distingue principalement deux versions de PHP : celle dont le binaire est appelé par le serveur Web, et php-fpm qui possède son propre service daemon (aussi appelé par le serveur Web) testable ainsi :

telnet localhost 9000
CTRL + ALT + ]
quit

FPM signifie FastCGI Process Manager, puisque le processus PHP-fpm écoute les requêtes CGI^[1]. Cela peut se traduire soit par des requêtes TCP/IP, soit par un socket Unix (.sock dans le vhost).

PHP peut-être installé avec toutes les déclinaisons de la distribution Debian (stable, testing, unstable). Il suffit pour cela d'insérer vos lignes préférées dans le fichier /etc/apt/sources.list :

deb http://ftp.fr.debian.org/debian/ stable main non-free contrib
deb-src http://ftp.fr.debian.org/debian/ stable main non-free contrib

Ce qui suit suppose que le serveur Web a bien été installé ; exécuter les commandes suivantes :

sudo apt-get update && apt-get install php8.4 && apt-get install libapache2-mod-php8.4

Une fois ces commandes exécutées, redémarrer le serveur Web. Dans le cas d'Apache cela s'effectue avec la commande suivante :

/etc/init.d/apache2 restart

Si tout s'est bien passé, vous disposez maintenant d'un serveur Web qui a la capacité d'exécuter des scripts PHP dans votre navigateur.

Testons :

commande

$ lynx http://localhost/test.php

Pour débugger :

commande

$ tail /var/log/apache2/error.log

Une fois les serveurs Web installés, ils se lancent automatiquement à chaque démarrage de la machine, ce qui est souhaitable pour un serveur, mais pas toujours pour un PC. Pour éviter cela, il suffit d'y désactiver les daemons :

sudo update-rc.d apache2 disable
sudo update-rc.d mysql disable

Mise à jour

Pour PHP 7 ou 8 sur Ubuntu :

sudo add-apt-repository ppa:ondrej/php

Sur Debian :

sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

Puis :

sudo apt update
sudo apt install php8.4 php8.4-common php8.4-cli php8.4-fpm

sudo a2enmod php8.4
sudo systemctl reload apache2

Bibliothèques

Voici une liste de bibliothèques fréquemment utilisées dans les applications :

# apt-get install -y \
    php8.4-mysql \
	php8.4-gd \
	php8.4-curl \
	php8.4-mbstring \
	php8.4-xml

D'autres s'installent avec pecl au lieu de apt.

Pour les activer après installation, on peut éditer le php.ini ou lancer : phpenmod nom_du_module_php. Ex : sudo phpenmod gd.

Pour les désactiver : phpdismod nom_du_module_php

Pour détecter l'emplacement du php.ini de la version de PHP par défaut : php --ini.

Désinstaller PHP

Pour éviter de désinstaller tous les paquets PHP un par un (par exemple après une bascule de PHP7.0 vers PHP7.1), il existe "ppa-purge" :

sudo apt-get install ppa-purge
sudo ppa-purge ppa:ondrej/php-7.0

Apache sur Gentoo

Premièrement il faut installer Apache :

emerge apache

Ensuite, il faut installer PHP :

emerge dev-lang/php

Puis il faut qu'apache utilise PHP dans sa configuration.

Code : Configuration de apache

# nano -w /etc/conf.d/apache2
APACHE2_OPTS="-D PHP5"

MySQL seul

MySQL est disponible sur http://dev.mysql.com/downloads/gui-tools/5.0.html au format :

.msi (Windows)
.dmg (Mac)
.rpm (Linux)
.tar

En l'absence de gestionnaire de paquets, utiliser le .tar ainsi :

shell> groupadd mysql
shell> useradd -r -g mysql mysql
shell> cd /usr/local
shell> tar zxvf /path/to/mysql-VERSION-OS.tar.gz
shell> ln -s full-path-to-mysql-VERSION-OS mysql
shell> cd mysql
shell> chown -R mysql .
shell> chgrp -R mysql .
shell> scripts/mysql_install_db --user=mysql
shell> chown -R root .
shell> chown -R mysql data
shell> bin/mysqld_safe --user=mysql &

APT

$ sudo apt-get install mysql-server mysql_secure_installation

Variante

La dénomination des paquets mentionnés peut varier légèrement selon la version. Dans un terminal, entrez :

$ sudo apt-get install mysql-server

et confirmez.

(Remarque : il semblerait qu'en installant le paquet "mysql-server-5.0", au lieu du paquet mentionné plus haut, certaines personnes rencontrent des problèmes. Il est donc préférable d'installer ce paquet, ou d'installer la dernière version 4 stable avec : $ sudo apt-get install mysql-server-4.1. Consultez le forum pour plus d'informations : )

Lancez ensuite la commande :

cd && sudo mysql_secure_installation

Appuyez sur Entrée lorsqu'il vous demande le mot de passe root MySQL : pour le moment il n'y en a pas.

MySQL a ses propres utilisateurs, avec leurs propres privilèges. Le root MySQL n'est donc pas le root système. Il est conseillé de ne pas mettre les mêmes mots de passes pour les utilisateurs MySQL et les utilisateur du système.

Le script vous demande alors si vous voulez mettre un mot de passe pour l'utilisateur root. Répondez Y, et entrez (2 fois le nouveau mot de passe du root MySQL). Il vous pose ensuite une série de questions. Si vous ne savez pas quoi répondre, acceptez les choix par défaut en appuyant simplement sur Enter.

Votre serveur MySQL est prêt. Par défaut il se lance à chaque démarrage du système, si vous ne le souhaitez pas, il vous suffit de lancer :

$ sudo dpkg-reconfigure mysql-server

et de répondre "Non" à la question du démarrage systématique de MySQL.

Sur Gentoo

emerge mysql

Modules

De nombreux modules complémentaires peuvent être installés sur Apache.

Pour les lister, on utilise apachectl (parfois apache2ctl) :

apachectl -t -D DUMP_MODULES

ou

apache2ctl -M

Pour activer un module :

a2enmod Nom_du_module

Un fichier est alors créé dans /etc/apache2/mods-enabled/.

Exemple pour la réécriture d'URL :

a2enmod rewrite

Pour le désactiver :

a2dismod Nom_du_module

La configuration du module reste toutefois disponible dans /etc/apache2/mods-available/.

Les extensions PHP nécessitent une autre commande. Ex :

phpenmod mbstring

Sites

Pour lister les sites du serveur :

apachectl -S

Pour activer un site :

a2ensite Nom_du_site

Le fichier du site est alors visible dans /etc/apache2/sites-enabled/.

Pour le désactiver :

a2dissite Nom_du_site

Le site est dans /etc/apache2/sites-available/.

Problème d'encodage d'Apache2

Si vous rencontrez un problème d'encodage des caractères de vos pages, par exemple les caractères accentués apparaissant sous la forme "�" (<?>), c'est probablement parce qu'Apache2 déclare dans les en-têtes HTTP qui accompagnent les pages visionnées un encodage par défaut en Unicode (UTF-8) :

 Content-Type: text/html; charset=UTF-8

Tandis que les pages visionnées utilisent un autre encodage des caractères, comme par exemple Latin1 (ISO-8859-1). Même si vos documents indiquent le jeu de caractères utilisé, le paramètre donné par le serveur dans les en-têtes HTTP est prioritaire !

Pour corriger ce problème, il faudra éditer /etc/apache2/apache2.conf :

  $ sudo gedit /etc/apache2/apache2.conf

Encodage par défaut en Latin1 (ISO-8859-1)

Cherchez la ligne suivante :

 #AddDefaultCharset	ISO-8859-1

Décommentez-la en enlevant le # :

 AddDefaultCharset	ISO-8859-1

Pour ceux qui ont la locale iso-8859-15 (sinon vous pouvez faire "sudo dpkg-reconfigure locales" pour l'ajouter) et qui désirent l'utiliser par défaut, ajoutez un 5 en fin de ligne :

 AddDefaultCharset	ISO-8859-15

ainsi que la ligne suivante dans le paragraphe en-dessous :

 AddCharset ISO-8859-15 .iso8859-15  .latin15 .fr

Il ne vous reste plus qu'à mettre "fr" en première position dans la ligne LanguagePriority (juste au-dessus), et à demander à apache de relire sa configuration :

  $ sudo /etc/init.d/apache2 reload

Aucun encodage par défaut

Il est également possible de s'affranchir de tout encodage par défaut, de la manière suivante :

Cherchez la directive AddDefaultCharset :

 AddDefaultCharset	ISO-8859-1

Remplacez l'attribut par la valeur Off :

 AddDefaultCharset	Off

Là encore, on demandera à Apache de relire sa configuration :

  $ sudo /etc/init.d/apache2 reload

Maintenant, les en-têtes HTTP ne contiendront plus d'indication d'encodage des caractères. Attention : il faudra alors que chaque page indique l'encodage utilisé, car s'en remettre à la détection automatique par les navigateurs peut s'avérer assez aléatoire !

Windows

Tout-en-un

Des logiciels tout-en-un (serveur Web, base de donnée MySQL, et PHP) permettent de s'affranchir d'une installation fastidieuse et rédhibitoire pour le débutant :

EasyPHP^{téléchargement} : n'a pas vocation à être installé pour de la production, mais pour le développement. Il stocke les bases de données dans C:\Program Files (x86)\EasyPHP\binaries\mysql\data.
WAMP^{téléchargement} : est du même type qu'EasyPHP : ce logiciel installe facilement un serveur Web Apache, une base de données MySQL et PHP 4 et 5. Il a l'avantage de permettre de passer facilement de PHP 4 à PHP 5, sans avoir à refaire une installation ou une compilation. Tout comme EasyPHP, c'est un environnement de développement, et non un environnement de production. Attention : la résolution des noms d'hôtes se réalise séparément. Les installations WAMP servent à tester en local sur votre PC. Dans la plupart des cas, il suffit d'utiliser le fichier Hosts local, comme on le ferait sur une machine Linux, afin de lier des noms aux adresses IP. Dans Windows XP, Vista et 7, ce fichier se trouve dans le répertoire systemroot\System32\Drivers\Etc. Il peut se faire que le service ait déjà été configuré. Lorsque vous vous en doutez, contactez votre administrateur réseau. Remarque : vous trouverez une liste des possibilités de résolution de noms avec MS Windows sur Microsoft.com.
XAMPP^{téléchargement} : est du même type qu'EasyPHP ou WAMP, le deuxième P étant pour Perl. Son usage est recommandé avec PHPEclipse, et il fournit aussi un serveur Apache Tomcat par défaut.
The Uniform Server^{téléchargement} : en anglais seulement avec Apache2, Perl5, PHP5, MySQL5, phpMyAdmin.

Sur Windows 10 pro, le serveur IIS est installé par défaut, et oblige Apache à changer de port (888 au lieu de 80) lors de l'installation. Pour résoudre cela il suffit de décocher Internet Information Services dans Programmes et fonctionnalités, Activer ou désactiver des fonctionnalités Windows. De même, le port MySQL est susceptible de passer de 3306 à 3388.

Sur Windows 10, EasyPHP development server (alias Devserver, la version rouge) ne fonctionne pas (il manque MSVCR110.dll), mais EasyPHP hosting server (alias Webserver, la bleue) tourne normalement. Or, elle se lance automatiquement à chaque démarrage, ce qui le ralentit significativement. Pour éviter cela, exécuter services.msc, puis passer les trois services ci-dessous en démarrage manuel. Ensuite pour les lancer à souhait (en tant qu'administrateur), créer un script MySQL.cmd contenant les lignes suivantes :

net start ews-dbserver
net start ews-httpserver
net start ews-dashboard
pause
net stop ews-dashboard
net stop ews-httpserver
net stop ews-dbserver

Message d'erreur relatif à SSL

Pour l'instant, WAMP ne supporte pas encore le Secure Socket Layer (SSL). L'installation se finit par un message qui vous informe de ce fait. Afin de pouvoir travailler sans problèmes, éditez le fichier c:\windows\php.ini. Cherchez dans ce fichier la ligne qui commence avec extension=php_openssl.dll. Commentez cette ligne en la faisant précéder d'un point-virgule :

;extensions=php_openssl.dll

Si tout se passe bien, vous pouvez ouvrir la page de test dans votre navigateur.

Installation manuelle

Apache est disponible sur le site Web de Apache Software Foundation apache.org.
PHP est téléchargeable sur le site officiel de php. Choisissez le fichier au format ZIP.
Enfin, vous trouverez MySQL sur mysql.com.

Installer Apache

Pour installer Apache, double-cliquez sur le fichier exécutable, et suivez les instructions d'installation automatique.

Si vous installez Apache sur un ordinateur de développement, renseignez le champ "nom de domaine" avec la valeur localhost.

Si vous installez un serveur de production et que vous disposez d'un nom de domaine, vous devriez disposer des informations nécessaires concernant votre nom de domaine, fournies par le registrar.

Une fois l'installation terminée, il faut encore indiquer à Apache qu'il doit fonctionner conjointement avec PHP, car il ne sait pas les traiter par défaut. Pour cela, il faut modifier les informations de configuration d'Apache, contenues dans le fichier httpd.conf, qui se trouve dans le dossier d'installation d'Apache, dans le sous-dossier conf.

Installer PHP

Une fois l'archive téléchargée, décompressez-la à la racine de votre disque dur et renommez le dossier en 'PHP'. Dans le dossier PHP, vous trouverez deux fichiers: php.ini-dist et php.ini-recommended. Copiez php.ini-recommended dans votre dossier C:\Windows ou C:\winnt (le nom du dossier dépend de la version de votre système.
renommez-le en php.ini.

Ce fichier est le fichier de configuration qui contrôle les options dont vous disposerez. Par exemple :

PHP.ini	PHP	Rôle
`error_reporting E_ALL`	`error_reporting(E_ALL);`	Affiche tous les avertissements et erreurs directement sur le site. C'est utile pour la préproduction car cela évite de rechercher d'éventuels messages dans les logs, mais peut perturber la mise en page pour des avertissements bénins.
`error_reporting 0`	`error_reporting(0);`	N'affiche aucun message sur le site relatif à son exécution
`max_execution_time = 300`	`set_time_limit(300);`	Définit le "timeout", c'est-à-dire le temps maximum en secondes autorisé pour exécuter un script PHP.
`post_max_size = 80M`	`ini_set('post_max_size', '80M');`	Définit la taille maximum d'un fichier que l'on peut envoyer au serveur en HTTP.

MySQL

Télécharger et installer le .msi sur http://dev.mysql.com/downloads/gui-tools/5.0.html.

Pour arrêter, démarrer, démarrer automatiquement le serveur MySQL vous devez aller dans la gestion des services (Démarrer/Exécuter/services.msc).

Apache CGI ou module ?

On peut configurer Apache pour utiliser PHP comme binaire CGI, ou comme module.

L'installation en module offre de meilleures garanties en matière de sécurité, de meilleures performances, et certaines fonctionnalités absentes de l'installation en CGI. Cette installation est cependant un peu plus difficile (mais rassurez-vous, pas tellement plus que l'installation CGI), aussi nous intéresserons nous à celle-ci.

Dans le répertoire de PHP, trouvez la DLL php5ts.dll, et copiez-la dans le répertoire d'Apache.
Ouvrez ensuite le fichier httpd.conf. On en a déjà parlé plus tôt, vous vous souvenez où il est, n'est-ce pas ?
Dans ce fichier, ajouter cette ligne qui permet à Apache de savoir que l'extension .php concerne l'utilisation du module PHP :
```
AddType application/x-httpd-php .php
```
Puis, ajoutez ces deux lignes qui charge et exécute (respectivement) le module PHP5 au démarrage du serveur :
```
LoadModule php5_module c:\php\php5apache.dll
```
```
AddModule mod_php5.c
```

Enregistrez le fichier httpd.conf et fermez-le.

IIS

IIS est activé automatiquement sur Windows Server et Windows 10, et peut l'être manuellement pour les versions antérieures, dans le panneau de configuration, Activer ou désactiver des fonctionnalités de Windows. C'est également là que l'on peut le désactiver pour donner le port 80 à Apache.

Son processus est issu de C:\Windows\System32\inetsrv\w3wp.exe et est lancé en tant que "Service réseau". Ce compte local devra donc avoir le droit de lecture sur les fichiers du site web.

Sur Windows Server uniquement, lors de la première utilisation il faut ajouter le rôle Serveur Web dans le Gestionnaire de serveur, accessible dans le menu démarrer, Tous les programmes, Outils d'administration^[2]. Puis pour ce rôle il faut cocher plusieurs services de rôle :

CGI^[3] (sous peine d'erreurs 500 à chaque commande PHP).
ODBC pour les connexions aux bases de données.
...

Télécharger et installer ensuite le manager PHP^[4] pour pouvoir configurer PHP dans :

Le Gestionnaire des services Internet (%windir%\system32\inetsrv\InetMgr.exe) sur Windows Server.
Les Services Internet sur Windows PC.

Si ensuite IIS renvoie systématiquement des erreurs 500 par la suite (même sans appel PHP), installer Visual C++ 32 bits^[5] (PHP ne fonctionne pas en 64 bits en 2016).

Docker

Il existe de nombreuses images de conteneur Docker pouvant fournir PHP. Exemple de Dockerfile^[6] :

FROM php:8.2-cli
FROM php:8.2-fpm

PHP 7.4 FPM

Exemple avec GD^[7] :

FROM php:7.4-fpm

RUN apt-get update && apt-get install -y \
        libfreetype6-dev \
        libjpeg62-turbo-dev \
        libpng-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd

IDE

Pour développer efficacement en PHP il est indispensable d'utiliser un environnement de développement intégré (IDE) plutôt qu'un éditeur de texte sur le PC client. Ils seront abordés dans les chapitres suivants.

vim

vim dispose de plugins pour programmer en PHP^[8].

Références

Composer

Composer est un logiciel de gestion des bibliothèques PHP open source. Celles-ci sont aussi accessibles sur https://packagist.org/.

Installation

Pour l'installer il y a trois solutions :

Avec les commandes PHP décrites sur https://getcomposer.org/download/.
En téléchargeant le package par navigateur à la même adresse.
En le téléchargeant avec la commande cURL^[1], comme le montre la vidéo suivante :

À la fin il faut juste disposer du fichier composer.phar.

Pour le lancer, on peut utiliser la commande composer s'il est installé avec PHP, ou php composer.phar s'il est juste téléchargé.

Pour l'installer à partir du téléchargement :

 curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Enfin, pour tester l'installation, lancer :

 composer -v

Utilisation

Le programme Composer lit et modifie la liste des bibliothèques du projet dans le fichier composer.json.

init

Pour créer le fichier composer.json :

composer init

create-project

Alternative à init pour les apps initialisée par un framework.

composer create-project "symfony/skeleton:^5" mon_projet

require

Pour installer un paquet, par exemple client client HTTP Guzzle :

 composer guzzlehttp/guzzle

Si l'installation réussit, il ajoute le nom et la version du paquet dans composer.json, ceux de ses dépendances dans composer.lock, et télécharge leurs fichiers dans un dossier "vendors". Il informe ensuite des problèmes de dépendances, par exemple si la version de PHP locale est inférieure à celle recommandée pour le paquet. En cas d'erreur il retire tout ce qu'il a fait.

Paramètres

On peut aussi préciser le numéro de version, par exemple MediaWiki :

 composer require mediawiki/semantic-media-wiki "1.9.*,>=1.9.0.1"

On peut aussi installer plusieurs paquets à la suite :

 composer require symfony/framework-bundle symfony/console

Pour éviter de télécharger une bibliothèque destinée au développement en environnement de production, l'ajouter en mode "dev", puis lancer composer install en développement, et composer install --no-dev en production :

 composer require --dev phpunit/phpunit ^8

Pour utiliser une branche du dépôt de la dépendance, , utiliser le mot réservé ":dev-" suivi de son nom. Ex :

 composer require mediawiki/semantic-media-wiki:dev-123_ma_branche

Pour utiliser un commit particulier du dépôt de la dépendance, utiliser le mot réservé "dev-master". Ex :

 composer require mediawiki/semantic-media-wiki dev-master#hash_du_commit

install

Généralement quand on clone un projet git existant contenant un composer.json, il suffit ensuite pour le faire fonctionner, d'installer ses dépendances ainsi :

 composer install

Si plusieurs versions de PHP sont installées, il faut préciser laquelle exécute composer ainsi :

/usr/bin/php8.4 /usr/local/bin/composer install

update

Ne jamais lancer de composer update sur un projet existant, sous peine de devoir tout retester. En effet, mieux vaut ne mettre à jour qu'une seule bibliothèque en précisant son nom :

 php composer.phar update mediawiki/semantic-media-wiki --with-dependencies

Il faut parfois éditer le composer.json avec la règle de la nouvelle version souhaitée avant de lancer l'update.

show

Affiche toutes les bibliothèques installées sur une ligne chacune, ce qui est plus lisible que composer.lock.

depends

Affiche les bibliothèques qui dépendent du package donné en paramètre.

clear-cache

 composer clear-cache

Syntaxe du composer.json

La syntaxe JSON de ce fichier contient quelques extensions^[2] :

name

Le nom de l'application, telle qu'elle sera appelée par composer.

Il existe une syntaxe pour le nommage des bibliothèques sous peine de warnings lors des manipulations avec composer. Elles doivent être de la forme vendor name/package name, uniquement avec des caractères alphanumériques plus "-", "." ou "_".

require

Le paragraphe "require" contient les noms des dépendances ainsi que leurs numéros de version (SemVer).

Symbole	Rôle (placé avant un numéro de version)	Exemple
>=	permet d'en étendre le numéro. De même on trouve les symboles >, <, <=.	`"php": ">=5.5.9"` inclut PHP 7.
!=	exclut une version.
-	définit une plage de versions.
¦¦	ajoute des versions possibles.	`"symfony/symfony": "2.8 ¦¦ 3.0"` regroupe uniquement ces deux versions.
*	étend à toutes les sous-versions.	`"symfony/symfony": "3.1.*"` comprend la 3.1.1.
~	étend aux versions suivantes du même niveau.	`"doctrine/orm": "~2.5"` concerne aussi la 2.6 mais pas la 2.4 ni la 3.0.
^	fait la même chose que tilde sous réserve qu'il y ait une compatibilité ascendante.

Stability Flag

Après la version à trois nombres, on peut suffixer un arobase puis un Stability Flag^[3]. Exemples :

@dev
@stable

require-dev

On y trouve ce qui a été installé avec require --dev, donc généralement des bibliothèques de tests et d'analyse de code.

config

Ensemble de paramètres de composer^[4], par exemple le timeout ou les identifiants vers certains dépôts.

autoload

Mapping des namespaces vers les classes. Cela permet de plus d'inclure tous les fichiers des dossiers automatiquement (et donc d'éviter les fonctions require() et include())^[5].

Exemple :

    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    },

De plus, un mapping spécifique aux environnements dev est possible avec :

    "autoload-dev": {
        "psr-4": {
            "App\\Tests\\": "tests/"
        }
    },

scripts

Scripts qui s’exécutent quand on lance "composer"^[6].

Soit automatiquement si présents dans "auto-scripts".
Soit manuellement. Exemple avec Doctrine dans Symfony :

...
"scripts": {
    "doctrine-cc": "php bin/console doctrine:cache:clear-metadata && php bin/console doctrine:cache:clear-query && php bin/console doctrine:cache:clear-result"
},
...

Utilisation :

composer doctrine-cc

extra

Complément de "scripts".

conflict

Liste automatiquement les dépendances en conflit, c'est-à-dire qui ne peuvent pas être installées avec l'application courante dans une tierce.

repositories

Pour spécifier des dépôts privés (qui ne sont pas accessibles sans communiquer leur URL).

Exemple complet

Exemple de mediawiki/core^[7] :

{
	"name": "mediawiki/core",
	"description": "Free software wiki application developed by the Wikimedia Foundation and others",
	"type": "mediawiki-core",
	"keywords": [
		"mediawiki",
		"wiki"
	],
	"homepage": "https://www.mediawiki.org/",
	"authors": [
		{
			"name": "MediaWiki Community",
			"homepage": "https://www.mediawiki.org/wiki/Special:Version/Credits"
		}
	],
	"license": "GPL-2.0-or-later",
	"support": {
		"issues": "https://bugs.mediawiki.org/",
		"irc": "irc://irc.libera.chat/mediawiki",
		"wiki": "https://www.mediawiki.org/"
	},
	"prefer-stable": true,
	"require": {
		"composer/semver": "3.2.4",
		"cssjanus/cssjanus": "2.0.0",
		"ext-ctype": "*",
		"ext-dom": "*",
		"ext-fileinfo": "*",
		"ext-iconv": "*",
		"ext-intl": "*",
		"ext-json": "*",
		"ext-libxml": "*",
		"ext-mbstring": "*",
		"ext-xml": "*",
		"ext-xmlreader": "*",
		"guzzlehttp/guzzle": "7.2.0",
		"liuggio/statsd-php-client": "1.0.18",
		"monolog/monolog": "2.2.0",
		"oojs/oojs-ui": "0.42.0",
		"pear/mail": "1.4.1",
		"pear/mail_mime": "1.10.9",
		"pear/net_smtp": "1.9.2",
		"php": ">=7.2.22",
		"psr/container": "1.1.1",
		"psr/log": "1.1.3",
		"ralouphie/getallheaders": "3.0.3",
		"wikimedia/assert": "0.5.0",
		"wikimedia/at-ease": "2.1.0",
		"wikimedia/base-convert": "2.0.1",
		"wikimedia/cdb": "1.4.1",
		"wikimedia/cldr-plural-rule-parser": "2.0.0",
		"wikimedia/common-passwords": "0.3.0",
		"wikimedia/composer-merge-plugin": "2.0.1",
		"wikimedia/html-formatter": "3.0.1",
		"wikimedia/ip-set": "3.0.0",
		"wikimedia/ip-utils": "3.0.2",
		"wikimedia/less.php": "3.1.0",
		"wikimedia/minify": "2.2.4",
		"wikimedia/normalized-exception": "1.0.1",
		"wikimedia/object-factory": "3.0.2",
		"wikimedia/parsoid": "^0.14.0-a14@alpha",
		"wikimedia/php-session-serializer": "2.0.0",
		"wikimedia/purtle": "1.0.7",
		"wikimedia/relpath": "3.0.0",
		"wikimedia/remex-html": "2.3.2",
		"wikimedia/request-timeout": "1.1.0",
		"wikimedia/running-stat": "1.2.1",
		"wikimedia/scoped-callback": "3.0.0",
		"wikimedia/services": "2.0.1",
		"wikimedia/shellbox": "2.0.0",
		"wikimedia/utfnormal": "3.0.2",
		"wikimedia/timestamp": "3.0.0",
		"wikimedia/wait-condition-loop": "2.0.2",
		"wikimedia/wrappedstring": "3.2.0",
		"wikimedia/xmp-reader": "0.8.1",
		"zordius/lightncandy": "1.2.5"
	},
	"require-dev": {
		"composer/spdx-licenses": "1.5.4",
		"doctrine/dbal": "2.10.4||3.0.0",
		"doctrine/sql-formatter": "1.1.1",
		"giorgiosironi/eris": "^0.10.0",
		"hamcrest/hamcrest-php": "^2.0",
		"johnkary/phpunit-speedtrap": "^3.1",
		"justinrainbow/json-schema": "~5.2",
		"mediawiki/mediawiki-codesniffer": "37.0.0",
		"mediawiki/mediawiki-phan-config": "0.10.6",
		"nikic/php-parser": "4.10.2",
		"nmred/kafka-php": "0.1.5",
		"php-parallel-lint/php-console-highlighter": "0.5",
		"php-parallel-lint/php-parallel-lint": "1.3.0",
		"phpunit/phpunit": "^8.5",
		"psy/psysh": "0.10.5",
		"seld/jsonlint": "1.8.3",
		"symfony/yaml": "~3.4|~5.1",
		"wikimedia/testing-access-wrapper": "~2.0",
		"wmde/hamcrest-html-matchers": "^1.0.0"
	},
	"replace": {
		"symfony/polyfill-ctype": "1.99",
		"symfony/polyfill-mbstring": "1.99"
	},
	"suggest": {
		"ext-apcu": "Local data cache for greatly improved performance",
		"ext-curl": "Improved http communication abilities",
		"ext-openssl": "Cryptographical functions",
		"ext-wikidiff2": "Diff accelerator",
		"monolog/monolog": "Flexible debug logging system",
		"nmred/kafka-php": "Send debug log events to kafka"
	},
	"autoload": {
		"psr-0": {
			"ComposerHookHandler": "includes/composer",
			"ComposerVendorHtaccessCreator": "includes/composer",
			"ComposerPhpunitXmlCoverageEdit": "includes/composer"
		}
	},
	"autoload-dev": {
		"files": [
			"vendor/hamcrest/hamcrest-php/hamcrest/Hamcrest.php",
			"vendor/wmde/hamcrest-html-matchers/src/functions.php"
		]
	},
	"scripts": {
		"mw-install:sqlite": "php maintenance/install.php --server=http://localhost:4000 --dbtype sqlite --dbpath cache/ --scriptpath '' --pass adminpassword MediaWiki Admin",
		"serve": "php -S localhost:4000",
		"lint": "parallel-lint --exclude vendor",
		"phan": "phan -d . --long-progress-bar",
		"phpcs": "phpcs -p -s --cache",
		"fix": [
			"phpcbf"
		],
		"pre-install-cmd": "ComposerHookHandler::onPreInstall",
		"pre-update-cmd": "ComposerHookHandler::onPreUpdate",
		"post-install-cmd": "ComposerVendorHtaccessCreator::onEvent",
		"post-update-cmd": "ComposerVendorHtaccessCreator::onEvent",
		"test": [
			"composer lint .",
			"composer phpcs ."
		],
		"test-some": [
			"composer lint",
			"composer phpcs"
		],
		"phpunit": "phpunit",
		"phpunit:unit": "phpunit --colors=always --testsuite=core:unit,extensions:unit,skins:unit",
		"phpunit:integration": "phpunit --colors=always --testsuite=core:integration,extensions:integration,skins:integration",
		"phpunit:coverage": "phpunit --testsuite=core:unit --exclude-group Dump,Broken",
		"phpunit:coverage-edit": "ComposerPhpunitXmlCoverageEdit::onEvent",
		"phpunit:entrypoint": "php tests/phpunit/phpunit.php"
	},
	"config": {
		"optimize-autoloader": true,
		"prepend-autoloader": false
	},
	"extra": {
		"merge-plugin": {
			"include": [
				"composer.local.json"
			],
			"merge-dev": false
		}
	}
}

Changer de version de PHP

Composer ne permet pas de changer de version de PHP en ligne de commande. Pour ce faire, il faut éditer le composer.json en mettant la version cible souhaitée, puis lancer composer update.

Références

PhpStorm

IDE en freemium réputé le meilleur pour le langage PHP (compter 10 € par mois pour l'utiliser au-delà d'un mois), PhpStorm permet entre autres des recherches relativement rapides dans le code grâce à son indexation, de l'autocomplétion des langages Web, de nombreuses propositions d'optimisations de code et des plugins (ex : Git, Docker, frameworks PHP...).

Installation

Le logiciel est multi-plateforme est ses prérequis figure avec les liens de téléchargement sur le site officiel : https://www.jetbrains.com/help/phpstorm/installation-guide.html.

Configuration

Pour un projet git, il est recommandé d'ajouter le dossier .idea/ créé par PhpStorm dans le fichier .gitignore.

Pour éviter de modifier la totalité des fichiers d'un projet mal formaté, il faut désactiver le reformatage automatique lors du copier-coller sans Settings, Editor, Smart Keys, Reformat on paste : None.

Exclure les fichiers minifiés de l'indexation

Idéalement l'indexation des fichiers par PhpStorm devrait prendre moins d'une minute, et ses recherches ne devraient renvoyer que du code source lisible par un humain (par les fichiers minifiés).

Pour ce faire, il faut exclure certains dossiers dans File\Settings\Directories.

Par exemple sur un projet Symfony on exclura :

public/build (pour les .js optimisés)
var (pour les .php optimisés, et les logs)

Fonctionnalités

Refactorisation

Par rapport à ses concurrents, il offre de nombreuses options de refactorisation. Par exemple, quand on renomme une variable en passant par le menu "Refactor", il peut le répercuter dans tout le code du projet qui l'appelle, y compris dans les getters et setters. De plus, il peut ajouter ces derniers automatiquement, ainsi que le constructeur d'une classe selon ses attributs (raccourci ALT + Ins), avec un formatage très personnalisable, par exemple pour les retours à la ligne après chaque attributs ou selon une largeur.

À ce propos, afin de respecter la PSR-1 lors de l'insertion de setters, il convient de paramétrer dans Editor\Code Style\PHP\Blank lines, Before return statement = 1.

Autoformatage

Il fournit aussi de nombreuses options d'autoformatage et son analyse de code permet par exemple de trouver les variables non utilisées. Quand on appelle une méthode avec du type hinting, il apparait sans avoir besoin d'ouvrir le fichier de cette dernière. Depuis la version 2019.3, il affiche les méthodes mortes en couleur plus sombre (en plus des variables mortes qu'il signalait déjà).

Par ailleurs, pour le pretty-print XML ou JSON : Code\Reformat Code.

Terminal

Par ailleurs, il possède un lien vers un terminal shell intégré dans une fenêtre du footer, et peut aussi exécuter des requêtes SQL sur des bases si on lui ajoute les sources de données. À ce propos, il permet de naviguer dans une base de données nativement avec une interface, comme le fait PhpMyAdmin, Adminer ou MySQL Workbench.

L'interpréteur de commande est modifiable dans Settings\Tools\Terminal. Par exemple pour utiliser du shell Unix depuis Windows, on peut mettre : C:\Program Files\Git\bin\sh.exe

Gestion de version

Son système VCS est compatible avec git et permet de voir l'historique des modifications des fichiers en couleur. Par exemple avec un clic droit dans la marge on peut afficher les annotations pour retrouver l'auteur d'un passage, puis réitérer l'opération en affichant les annotations précédentes pour remonter tout l'historique.

De plus, quand on regarde le différentiel des fichiers modifiés depuis le dernier commit (onglet "Version Control" en bas, "resolve", puis "merge..."), en cas de conflit il propose un outil de résolution à trois colonnes très ergonomique.

Enfin, son outil de rebase interactif permet des squash et fixup en masse (dans Log, sélectionner la branche, sélectionner les commits à squasher dans la liste).

Xdebug

Xdebug peut être déclenché depuis une page Web ou une commande shell. S'il est déjà installé sur le serveur PHP, et pour les pages Web dans le navigateur, voici ce qu'il reste à faire pour le faire fonctionner dans PhpStorm :

Cliquer sur l'icône en haut à droite Listen for debug connect.
Lancer le script à déboguer (afficher la page Web ou entrer la commande shell).

Une fenêtre apparait alors dans PhpStorm Incoming Connection From Xdebug, demandant quel est l'index.php correspondant au signal reçu. Cocher "Import mappings from deployment" si les fichiers sont exécutés sur un serveur distant, et "Manually choose local file or project" s'il est local. Cette deuxième option dresse une liste des index.php trouvés dans le projet, mais pour conserver celui par défaut, choisir leur dossier parent (le nom du projet), et cliquer sur "Accept".

En cas de problème, un outil de diagnostic se trouve dans File, Settings, chercher "Xdebug".

Docker

Si le serveur PHP est dans un conteneur Docker, il faut le stipuler à PhpStorm :

Ajouter un serveur : dans File, (Languages & Frameworks,) PHP, Servers, ajouter une URL pour le port 80, et une pour le 443. Pour chacun, cocher "Use path mappings" et y mettre le chemin de chaque projet accessible dans le conteneur PHP.
Ajouter une configuration de lancement : en haut à droite dans Add Configuration... ou Edit Configurations..., créer une entrée PHP Remote Debug, dans laquelle il faut renseigner le serveur précédemment créé, et la clé de session envoyée par le module de son navigateur.

Le php.ini dépend de l'OS hôte^[1] :

Linux :

    xdebug.remote_host = 172.170.0.1

Windows :

    xdebug.remote_host = "docker.for.win.host.internal"

Mac :

    xdebug.remote_host = "docker.for.mac.host.internal"

Exemple de Dockerfile :

    RUN pecl install -f xdebug \
    && docker-php-ext-enable xdebug

    COPY xdebug.ini $PHP_INI_DIR/conf.d
    # ou s'il y a peu de lignes à ajouter dans le .ini :
    RUN echo "xdebug.start_with_request=yes" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

Raccourcis clavier

Raccourcis clavier indispensables
Maj Maj	Rechercher un fichier
Ctrl + Maj + N	Ouvrir un fichier (ex : quand on le copie-colle depuis le terminal)
Ctrl + Maj + F	Rechercher dans les fichiers
Ctrl + G	Aller à la ligne n°X
Ctrl + D	Dupliquer la ligne courante
Ctrl + Maj + Alt	Sélectionner (en clic, double-clic ou glisser) plusieurs morceaux de codes pour pouvoir les copier.
Ctrl + Maj + Alt + T	Renommer en refactorant
Ctrl + B	Trouver les utilisations de l'objet courant (équivalent au clic droit, find usages)
Ctrl + E	Fichiers récents
Ctrl + K	Commiter
Ctrl + L	Vider le terminal (utile pour afficher uniquement les derniers logs)
Alt + Insert	Générer du code, par exemple le constructeur ou les getters et setters à partir des attributs.
Alt + clic	Décupler le curseur pour écrire la même chose à plusieurs endroits.
F2	Se rendre sur l'erreur de compilation du fichier courant

Plugins

PhpStorm dispose de plusieurs plugins installables dans un deuxième temps, classables par thèmes. Certains sont payants, mais en voici des gratuits utiles :

Modal commit interface : pour visualiser le git status et rajouter des fichiers à commiter (après installation, cocher "Use modal commit interface" pour l'activer).
EditorConfig récupère automatiquement la configuration d'IDE par projet (par exemple les conventions de codage)^[2] à partir d'un fichier .editorconfig versionné. NB : ce format de fichier fonctionne dans la plupart des autres IDEs^[3].
SonarLint analyse de code statique en cours de frappe, synchronisable avec SonarQube.
Prise en charge de plusieurs frameworks PHP :
- Symfony donne :
  - Un accès aux fichiers YAML de déclaration de services depuis les classes PHP et vice-versa en un clic^[4]
  - Un accès aux fichiers Twig entre eux ou depuis les classes PHP en un clic. Il faut toutefois ajouter au préalable chaque dossier "template" dans Settings, PHP, Symfony, Twig / Template (Namespace = __main__, Type = ADD_PATH).
- WordPress
- Drupal
- Joomla
Des frameworks JS :
- Node.js
- Angular
- Next.js
- Vue.js
Docker

Critique

Il est possible que l'application freeze le PC. Pour éviter cela aller dans le menu Help/Change Memory Settings et diminuer la valeur.
Début 2019, il considère à tort un fichier accessible par deux liens symboliques Linux comme deux fichiers.
Depuis au moins 2020, quand plusieurs projets sont ouverts ensemble, il mélange leurs espaces de nom (namespaces) comme si c'était le même (notamment dans les CTRL + clic).
Quand on exclut un dossier de l'indexation, si l'application crée un sous-dossier, il est indexé à tort. Par exemple, dans Symfony var/ est exclu mais var/cache/ apparait dans les recherches si on ne l'exclut pas manuellement après exécution de l'application.

Références

NetBeans

Installation de NetBeans

NetBeans est un environnement de développement intégré (EDI), générique et extensible. Il permet nativement de développer en Java, C, C++, JavaScript, XML, Groovy, PHP et HTML.

De plus, il possède son propre wiki officiel^[1] (en anglais). La présente page est donc destinée à le synthétiser au maximum.

Pour démarrer l'installation, le télécharger la version LTS sur https://netbeans.org/downloads/, ou bien la toute dernière sur http://bits.netbeans.org/dev/nightly/latest/.

Configuration

Pour installer les plugins comme PHP ou Python : https://netbeans.org/downloads/index.html.
Par défaut le chemin d'accès d'un fichier ouvert apparait en survol de son nom. Pour l'afficher en permanence sous la barre de menu : Tools, Options, Appearance, Show full file path.
L'autoformatage est réglable dans Tools, Options, Editor, Formatting.
- Pour déplacer la barre verticale rouge qui se trouve par défaut à 80 caractères de la gauche : Tools, Options, Editor, Formatting, Right Margin. Par exemple sur GitHub, la taille des écrans est de 120 caractères, il vaut donc mieux ne pas dépasser cette largeur pour éviter lors des relectures de codes, de descendre chercher un des ascenseurs pour remonter lire une fin de ligne.
Pour bénéficier des avantages propres à un framework (ex : autocompletion des objets du projet ou ouverture d'une déclaration de méthode avec "CTRL + clic" sur un appel), il convient, après installation dans "Tools\Plugins" de spécifier manuellement son emplacement dans "Tools\Options", puis pour PHP par exemple "Framework & Tools".

Utilisation

NetBeans permet de comparer deux fichiers : Tools, Diff...

Gestion de versions

Les gestions de version sont regroupées dans le menu Team. NetBeans peut donc tout à fait remplacer des clients Git purs tels que GitHub Desktop ou Smartgit.

Pour éviter de commiter fichier par fichier, ajouter le bouton Commit All - Repository en le faisant glisser depuis View, Toolbars, Customize.

Principaux raccourcis claviers

Liste exhaustive en anglais : http://wiki.netbeans.org/KeymapProfileFor60.

Alt + Maj + o : ouvre le fichier recherché.
Ctrl + o : ouvre le fichier déclarant l’objet sélectionné (recherche de classe).

Ctrl + Maj + f : cherche un texte dans les fichiers le dépôt.
Ctrl + b : cherche la déclaration d'un élément (dans le même fichier ou pas).

Ctrl + espace : propose une liste de complétion (mots-réservés et squelettes de fonctions).
Ctrl + Maj + espace : affiche la documentation d'une méthode (Javadoc, PHPDoc...).
Ctrl + p : affiche uniquement les arguments possibles d'une méthode.

Ctrl + Maj + c : commente les lignes sélectionnées.

Plugins

Certains plugins peuvent se révéler utiles :

http://plugins.netbeans.org/plugin/45925/sort-line-tools : trie les lignes dans l'ordre alphabétique.
http://plugins.netbeans.org/plugin/37077/autosave-module-for-6-9-and-later : sauvegarde automatiquement chaque fichier modifié en temps réel.

Références

↑ http://wiki.netbeans.org

Eclipse

Eclipse est un environnement de développement intégré (EDI), générique et extensible (site officiel http://www.eclipse.org). Son système de plugins permet d'ajouter des fonctionnalités diverses.

Initialement prévu pour développer en Java, grâce aux plugins il peut maintenant également gérer des projets développés avec d'autres langages de programmation tels que :

Le C et le C++ grâce à l'ensemble de plugins CDT (C Development Toolkit)^[1] (compilateur non intégré).
Le Python via PyDev^[2].
Avant l'arrivée d'Android Studio, le développement pour Android se faisait avec Eclipse grâce à l'ensemble de plugins ADT (Android Development Toolkit).

Certains IDE sont basés sur Eclipse, et permettent par exemple le développement de logiciel embarqués pour des systèmes temps réel.

Installation de Eclipse

La page de téléchargement d'Eclipse permet de récupérer une version déjà adaptée au langage ciblé sur http://www.eclipse.org/downloads/. Mais pour installer un plugin manuellement, il faut :

Lancer Eclipse, puis dans le menu déroulant :Help>Software Updates>Find and Install...
Cocher Search for new features to install, bouton Next. Bouton New Remote Site..., entrer l'adresse de téléchargement :

Name: Nom du plugin
URL: adresse du plugin, ex : http://www.eclipse.org/cdt/downloads.php

Bouton Finish, choisir un miroir proche puis continuer l'installation.

Utilisation de Eclipse

L'interface de l'IDE Eclipse est basée sur différentes perspectives. Une seule perspective n'est visible à la fois, et se compose de plusieurs vues. Exemples :

La perspective "Java" se compose par défaut de la vue "Package Explorer", de la vue éditeur de code en Java avec un onglet par fichier ouvert, de la vue "Outline" donnant la hiérarchie des éléments composant la classe du fichier ouvert.
La perspective "Debug" est ouverte automatiquement au lancement d'une application en mode débogage et se compose par défaut de la vue "Debug" affichant la pile d'appel, de la vue des points d'arrêt nommée "Breakpoints", de la vue éditeur de code en Java avec un onglet par fichier ouvert, de la vue "Outline" donnant la hiérarchie des éléments composant la classe du fichier ouvert.
Deux ou plusieurs perspectives peuvent être affichées conjointement.

Chaque vue est une sous-fenêtre qui a un titre et se place dans un cadre particulier de la fenêtre de l'IDE. Les vues peuvent être déplacées à la souris par drag and drop pour changer la disposition de la perspective. Plusieurs vues peuvent partager le même cadre, auquel cas, une barre d'onglets permet de basculer entre les vues. Un double clic sur le titre d'une vue provoque l'affichage du cadre qui la contient en pleine fenêtre, réduisant les autres cadres à une icône sur les côtés. Un second double clic restaure les cadres.

Le menu "Window" permet de changer de perspective, et d'ajouter des vues à la perspective courante. Une vue peut également être retirée de la perspective affichée en utilisant la croix à droite du titre de la vue.

Édition de lignes

L'éditeur de code possède des raccourcis clavier pratiques rendant l'édition des lignes de code plus rapide :

Touches		Effet
Shift	↵ Enter	Ajouter une nouvelle ligne après la ligne courante.
Ctrl	↑/↓	Faire défiler la vue vers le haut/le bas.
CtrlShift	↑/↓	Déplacer le curseur sur le membre précédent/suivant de la classe.
Alt	↑/↓	Déplacer la ligne courante ou les lignes sélectionnées vers le haut/le bas dans le texte.
CtrlAlt	↑/↓	Dupliquer la ligne courante ou les lignes sélectionnées vers le haut/le bas.
CtrlShift	:	Commenter/Décommenter la ligne courante.

Complétion de code

L'éditeur de code peut compléter automatiquement le code là où se trouve le curseur :

Touches

Effet

Ctrl

Espace

Ouvrir la liste des suggestions de complétion.

Une fois la suggestion choisie, la validation se fait par l'une des touches suivantes :

↵ Enter, n'ajoute rien derrière la suggestion ;
Espace ou ., ajoute également le caractère produit derrière la suggestion.

Toute autre touche produit le caractère sans valider (annuler la complétion).

AltShift

:

Complète avec la seule possibilité, ou produit un bip s'il y a plusieurs possibilités.

Navigation et autres astuces

Défilement rapide avec la molette de la souris: Maintenez la touche Ctrl enfoncée pendant l'utilisation de la molette de la souris pour faire défiler le contenu d'un fichier page par page plutôt que ligne par ligne.
Visualiser l'ouverture du bloc correspondant à la fermeture: Dans les codes sources dépassant la hauteur de fenêtre de l'éditeur, placez le pointeur de la souris sur l'accolade fermante d'un bloc pour voir apparaître un résumé du code d'ouverture du bloc en bulle d'aide. Ceci est fort utile pour vérifier quel bloc est fermé par l'accolade sans avoir à faire défiler le code.
Aller à la définition d'un membre de classe: Placez le pointeur de la souris sur un identifiant de classe, méthode ou variable et enfoncez la touche Ctrl pour faire apparaître un lien cliquable vers la définition.
Localiser toutes les occurrences dans la classe: Cliquez sur un identifiant de membre de classe pour faire apparaître toutes les occurrences d'utilisation dans le fichier : à la fois dans le texte et dans la barre de défilement. Les blocs apparaissant dans la barre de défilement sont cliquables pour faire défiler le code à la position de l’occurrence. Il y a deux couleurs distinctes pour les occurrences utilisées en lecture (accès, appel, ...) et celles utilisées en écriture (affectation).; Il peut arriver que cela ne semble pas fonctionner car l'éditeur peut être dans un mode autre que celui par défaut. Il faut dans ce cas appuyer une ou deux fois la touche Échap pour que cela fonctionne.

Inconvénients

L'IDE Eclipse montre beaucoup de choses à ne pas faire quand on conçoit une interface graphique ; notamment concernant les raccourcis clavier :

Certains raccourcis standard dans la grande majorité des logiciels ne sont pas supportés par Eclipse (exemple : Ctrl+O pour ouvrir un fichier),
Il est possible de modifier les raccourcis clavier via une boîte de dialogue cachée dans le dédale des menus de l'IDE (qui change à chaque version), toutefois le champ "When" doit être rempli avec la condition d'activation du raccourci (activation contextuelle). Il est impossible de définir un raccourci valable quel que soit le contexte.

L'historique de navigation entre les fichiers est également mal géré : après une action de navigation avant (CTRL+clic sur une méthode, par exemple) changeant le fichier courant, plusieurs retours en arrière sont généralement nécessaires pour revenir à la position précédente.

Références

↑ https://eclipse.org/cdt/
↑ (anglais) http://pydev.org/

Visual Studio Code

Visual Studio Code (ou simplement nommé "code") est un logiciel éditeur de texte graphique, gratuit fonctionnant sous Windows. Il est capable de prendre en charge le débogage, d'effectuer la coloration syntaxique, l'auto-complétion et surtout le pliage de code (code folding), c'est à dire le masquage à volonté de différents blocs d'instructions (contenu d'une classe, d'une fonction, d'une boucle, etc.) : cette fonctionnalité se révèle extrêmement pratique lorsque vos scripts commencent à s'allonger... Il intègre également la gestion de version (notamment Git et SVN)^[1], une fenêtre de terminal ainsi qu'un raccourci pour lancement des scripts.

Cet éditeur est disponible pour Windows sur https://code.visualstudio.com .

Langages supportés

Visual Studio Code prend immédiatement en charge presque tous les principaux langages informatiques.

Plusieurs d'entre eux sont inclus par défaut, comme HTML et CSS, et aussi JavaScript, TypeScript, Java, PHP, mais d'autres extensions de langage peuvent être trouvées et téléchargées gratuitement à partir de VS Code Marketplace^[2].

Utilisation

Édition de lignes

L'éditeur de code possède des raccourcis clavier pratiques rendant l'édition des lignes de code plus rapide :

Touches		Effet
Ctrl	↵ Enter	Ajouter une nouvelle ligne après la ligne courante.
Ctrl	↑/↓	Faire défiler la vue vers le haut/le bas.
Alt	↑/↓	Déplacer la ligne courante ou les lignes sélectionnées vers le haut/le bas dans le texte.
AltShift	↑/↓	Dupliquer la ligne courante ou les lignes sélectionnées vers le haut/le bas.
Ctrl	:	Commenter/Décommenter la ligne courante.

Références

Bases du langage

PHP est un langage dont les programmes s'exécutent côté serveur pour produire la réponse à une requête HTTP, ou une commande shell.

En général, il produit une réponse dans un langage de notation (ex : HTML, XML, ou JSON), et le code PHP peut s'intégrer dedans, par exemple dans les balises HTML comme montré dans ce chapitre introductif.

Il peut également produire une sortie dans un format binaire, par exemple une image PNG produite dynamiquement pour une représentation graphique des données, ou un fichier quelconque pour filtrer les accès à des fichiers téléchargeables.

Dans les premiers chapitres, seul le cas de la sortie en HTML est abordé.

Intégration du code

Pour que PHP interprète votre code, vous devez remplir deux conditions :

Votre code doit être placé dans un fichier d'extension .php (selon la configuration du serveur cela peut varier), ouvert via un serveur web en HTTP.
Votre code doit être compris entre deux balises : <?php ... ?>. Tout ce qui n'est pas compris entre ces balises n'est pas interprété par PHP :

<!DOCTYPE html>
<html>
<head>
    <title>Le titre de l'onglet</title>
    <meta charset="utf8" />
</head>
<body>
    <p>Du texte en html</p>

    <? echo 'un exemple de texte en php'; ?>

    <p>Encore du texte en html</p>

    //Écriture recommandée et universelle
    <?php
        echo "Encore du texte en php";
    ?>

<body>
</html>

L'utilisation des balises <? ?> (sans le mot "php") peut poser des problèmes de compatibilité. Il faut en effet que pour cela, la directive short_open_tags soit activée dans la configuration de l'environnement, ce qui n'est pas le cas sur la plupart des serveurs mutualisés et hébergements gratuits. Imaginez que vous changiez de serveur avec un interpréteur qui ne reconnaisse pas les balises courtes, il vous faudra alors modifier les balises de chaque fichier, travail fastidieux. Il est donc conseillé de prendre l'habitude d'utiliser les balises de la forme <?php ?>, reconnue universellement.

Pour regarder si votre configuration prend en compte ce type de balises, entrez le code suivant :

    <?php
        phpinfo();

Cela affichera le contenu du php.ini. Pour l'obtenir en CLI :

php -r "phpinfo();"

Autre exemple : trouver le .ini utilisé :

php8.4 -r "echo php_ini_loaded_file().PHP_EOL;"

Il est possible de trouver des extensions de fichiers comme .phtml, .php3 ou autres. Il est cependant conseillé d'utiliser l'extension .php qui garantit son interprétation par PHP.

Dans le cas des fichiers .php qui commencent par <?php et finissent par ?>, la balise fermante est optionnelle voire déconseillée.

Les directives

Il est possible de définir certains comportements de PHP lors de la compilation par des directives inscrites dans la commande declare()^[1]. Par exemple :

 declare(encoding = 'UTF-8');

Références

↑ http://php.net/manual/fr/control-structures.declare.php

Commentaires

Principe

Les commentaires sont en réalité des portions de texte qui ne seront pas interprétées par PHP et ne seront visibles que dans le code source. Ils jouent un rôle très important dans la réalisation et la mise à jour d'un script : en effet, les commentaires rendent le code plus lisible et peuvent aider les éventuelles personnes qui souhaitent retravailler votre script. En effet, si les commentaires sont très utiles aux programmeurs seuls, ils le sont encore plus lors du travail en équipe.

Il existe trois façons différentes d'ajouter des commentaires à son script PHP :

La méthode avec les symboles // pour ajouter un commentaire sur une ligne.
La méthode avec le sigle # pour ajouter un commentaire sur une ligne également.
La méthode avec les caractères /* */ pour désigner un bloc de commentaires.

<?php
# un commentaire PHP

// encore un commentaire PHP

/* et encore 
   un 
   autre, 
   mais sur plusieurs lignes cette fois-ci ! */

Il est important de ne pas emboîter les commentaires. Exemple à ne pas suivre :

<?php
    /*blabla /* hihi*/ blalbal*/

L'interpréteur comprendra que le commentaire s'arrête à hihi*/ et il tentera d'interpréter blalbal*/. Il en résultera donc une erreur.

Annotations

Il existe des logiciels qui génèrent une documentation complète à partir des commentaires insérés dans le code du programme. De là est apparue une certaine forme de standardisation de ceux-ci afin de faciliter la génération de documentation, appelée PHPDoc. On peut en effet ajouter des commentaires structurés pour permettre de générer une documentation automatique via PEAR^[1] ou PhpDocumentor. En pratique, cela se traduit par des mots-clés interprétés, précédés d'un arobase, appelés "annotations".

Exemple^[2] :

/**
* Commentaires sur le rôle du fichier courant
*
* date modifier : 13 mars 2013
* @since 13 mars 2013
* @author Prénom Nom (courriel)
* @copyright PHPascal.com
* @version 1.2
*
*/

Les annotations permettent de plus, aux IDE d'en déduire l'autocomplétion, et aident les analyseurs de code statique à garantir la qualité du code. Elles étaient les seules à pouvoir préciser certains types de variables avant l'apparition des type hinting et type checking en PHP7.

Exemple de commentaires indispensables avant PHP7 :

class MyEntity
{
    /** @var int|null */
    private $id;

    /**
     * @return int|null
     */
    public function getId()
    {
        return $this->id;
    }
}

Depuis PHP7 :

class MyEntity
{
    private int $id;

    public function getId(): ?int
    {
        return $this->id;
    }
}

Attributs

Depuis PHP8, il existe des attributs, représentés par des mots-clés suivant un croisillon, pour préciser des informations (métadonnées) sur les classes, fonctions, constantes ou variables^[3]. Ex :

<?php
    #[\ReturnTypeWillChange]
    public function getMixedData()
    {
        return $this->mixedData;
    }

Cet attribut sert à ne pas ajouter de warning si le type retourné ne peut pas être déterminé^[4].

Il en existe aussi d'autres comme :

"Attribute" : pour déclarer un nouvel attribut (en précisant par exemple s'il est restreint aux fonctions).
"Route" : pour relier une URL à une méthode.

Les attributs d'une classe peuvent être récupérés à l'exécution avec : ReflexionClass()->getAttributes().

Références

Premier programme

Hello World

Écrivons notre premier programme PHP. Pour le moment nous nous contenterons d'afficher le fameux "Hello World".

La commande shell est^[1] :

php -r "print 'Hello World!';"

Dans un fichier

Soit le fichier HelloWorld.php ci-dessous, il peut être lancé par :

les commandes shell php -q HelloWorld.php ou php -f HelloWorld.php
un navigateur Web, ex : http://localhost/HelloWorld.php

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
  <head>
    <title>Mon premier script PHP !</title>
  </head>
  <body>
    <p><?php echo 'Hello World!'; ?></p>
  </body>
</html>

Étude du code

Le terme echo représente une fonction propre à PHP qui a pour rôle d'afficher du texte, mais on peut aussi utiliser la fonction print à la place.

Quant à 'Hello World', il est écrit entre apostrophes pour indiquer qu'il s'agit de texte, mais on peut aussi utiliser des guillemets à la place.

Enfin, le point-virgule (;) sert à indiquer la fin de l'instruction. On peut donc placer plusieurs commandes sur une seule ligne.

Parse error

Il s'agit d'une erreur fréquente quand on débute en PHP. Elle est généralement due à une erreur de syntaxe. Cela peut être simplement à cause de l'omission d'un point-virgule ou bien par ce que vous avez une apostrophe qui gène.

Exemple de code erroné :

<?php
  // Parse error assurée
  echo 'J'irais bien boire un coup.';

Ne s'affichera pas, pour ce faire il faut juste mettre un antislash (\) devant notre apostrophe.

Exemple de code opérationnel :

<?php
  // Antislash et c'est bon
  echo 'J\'irais bien boire un coup.';

On peut aussi rendre plus lisible le code source en utilisant les caractères suivants :

\n : saut de ligne,
\t : tabulation,
\r : retour de chariot.

Attention : Ces caractères ne sont interprétés par le moteur PHP que s'ils sont introduits à l'aide de double apostrophe (guillemets) :

  echo "Retourne à la ligne\n";

Vous pouvez remarquer que l'exemple précédent est constitué de deux langages HTML et PHP, vous remarquerez aussi que le script est placé entre les balises <body></body> ce n'est pas une obligation ainsi le code suivant retourne la même chose :

<?php
  $texte= 'Hello World';
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
  <head>
    <title>Mon premier script PHP !</title>
  </head>
  <body>

    <?php
      echo ($texte);
    ?>

  </body>
</html>

Particularités de PHP CLI

PHP en ligne de commande possède plusieurs différences avec PHP sur serveur Web :

Les variables superglobales sont différentes : il n'y a pas de $_GET, $_POST et $_COOKIE.
Les paramètres (après le nom du script) sont récupérables par la variable globale $argv, et leur nombre par $argc (ou $_SERVER['argc'] si "register_globals = off;" dans php.ini).

 global $argv;
 global $argc;

Références

↑ http://php.net/manual/fr/features.commandline.options.php

Catégorie:Bonjour le monde#PHP

Variables

Définition

En PHP, les variables sont représentées par un signe dollar "$" suivi du nom de la variable, ou d'un underscore "_" pour les constantes (un warning apparait quand ces dernières sont redéfinies).

Le nom est sensible à la casse (par exemple $MaVariable est différent de $mavariable). Dans tous les cas, les variables doivent commencer par une lettre (a-z, A-Z) :

     $1MaVariable // incorrect
     $MaVariable  // correct
     $_MaVariable // correct
     $àéè         // correct
     MA_CONSTANTE  // correct
     _MA_CONSTANTE  // correct

Exemple

  <?php
  // Initialisation des variables
  $Prenom = 'Romuald';
  $Age    = '23 ans';
  $Profession = 'informaticien';

  // Affichage
   echo 'Bonjour ' . $Prenom . ', tu as ' . $Age . ' et ta profession est ' . $Profession . '.';
  // Ce qui affichera sur votre navigateur : Bonjour Romuald, tu as 23 ans et ta profession est informaticien.

  // Une autre manière de faire
  echo "Bonjour $Prenom, tu as $Age et ta profession est $Profession";
  // Ce qui affichera sur votre navigateur : Bonjour Romuald, tu as 23 ans et ta profession est informaticien.

  // Subtilité des " et des '
  echo 'Bonjour $Prenom, tu as $Age et ta profession est $Profession';
  // Ce qui affichera sur votre navigateur : Bonjour $Prenom, tu as $Age et ta profession est $Profession
  // Le contenu d'une chaîne construite avec des " sera interprété par PHP et les variables
  // éventuellement utilisées seront remplacées par leurs valeurs.

Nota bene : une variable accolée à du texte est précédée d'un point. Ce dernier sert à la concaténation et dans le cas présent est surtout utile pour indiquer à l'interpréteur que l'on passe du texte, puis à une variable. On lui évite ainsi un temps de réflexion qu'il aurait si l'on avait écrit :

echo "Bonjour $Prenom, tu as $Age et ta profession est $Profession";

Pour citer du texte contenant uniquement des apostrophes ou des guillemets, on peut encadrer les uns par les autres :

echo 'Hello "World"!';

Pour citer du texte contenant les deux symboles, on peut utiliser le caractère d'échappement "\" :

echo 'Hello \'the\' "World" !';

Here document

Pour éviter de s'encombrer des caractères d'échappement, il existe aussi les syntaxes heredoc et nowdoc avec l'opérateur "<<<"^[1]. Ex :

$v = 1;

echo <<<Test
 'Hello' "World" \\ $v heredoc
Test;
// 'Hello' "World" \ 1 heredoc

echo <<<'Test'
 'Hello' "World" \\ $v nowdoc
Test;
// 'Hello' "World" \\ $v nowdoc

heredoc interprète similairement à une chaine entre guillemets et nowdoc entre apostrophes.

Le mot de fin ("Test" dans l'exemple) des syntaxes heredoc ne doit pas être indenté ni suivi d'autres caractères que le ";", dans les versions PHP antérieures à 7.3^[2].

Le délimiteur heredoc ou nowdoc permet de forcer une coloration syntaxique dans certains IDE comme PhpStorm ou vscode^[3]. Par exemple, echo <<<HTML a un rendu différent de echo <<<SQL.

Par défaut, on peut accéder aux propriétés et méthodes d'objets en heredoc. Ex :

$v1 = new stdClass();
$v1->name = "World";
$v2 = ['one', 'two'];
echo <<<Test
 Hello $v1->name $v2[1]
Test;

Mais si cela pose problème, utiliser les accolades pour forcer l'interpolation :

$v1 = new stdClass();
$v1->name = ['one', 'two'];
echo <<<Test
 Hello $v1->name[1]   // Hello Array[1]
 Hello {$v1->name[1]} // Hello two
Test;

Chaines binaires

A ne pas confondre avec les nombres binaires qui sont composés de 0 et de 1, les chaines binaires sont apparues en PHP 5.2.1 et indiquées avec le préfixe "b". Ex :

b'ma_chaine'

Elles se distinguent des autres chaines par leur encodage, qui ne permet pas à ses caractères non ASCII d'être affichés brutes. Par exemple, print(b'é'); donne : �.

On peut alors la convertir avec :

print(iconv('ISO-8859-1', 'UTF-8', b'é'));

Types de variables

Contrairement à de nombreux langages de programmation, en PHP il ne faut pas prédéclarer une variable mais celle-ci est typée lors de son instanciation.

$x = 1; // indique implicitement que $x est un entier
$mot = 'test'; // indique que $mot est une chaîne de caractères

En PHP il y a donc quatre types de variables scalaires :

entiers (integer) : nombres naturels sans décimale (sans virgule) ;
réels (float) : nombres décimaux (on parle généralement de type "double", car il s'agit de nombre décimaux à double précision). On peut y introduire des puissances de 10 avec la lettre "e" (ex : 2e1 = 20, 4e-3 = 0.004) ;
booléens (boolean) : deux valeurs possibles : 1 ou 0. Elles sont équivalentes aux mots réservés true ou false (en français, vrai ou faux) ;
chaînes de caractères (string) : ensembles de caractères (des phrases).

De plus, on trouve les types complexes :

tableaux (array) : listes d'éléments ordonnés.
objets (object) : classe instanciée.

Pratique sur les nombres flottant

Il faut toujours arrondir les nombres flottant à l'affichage, mais aussi lors des comparaisons^[4].

Exemple :

 $ php -r "var_dump(8 - 6.4 == 1.6);"
 bool(false)

 $ php -r "var_dump(round(8 - 6.4, 1) == 1.6);"
 bool(true)

Lors de la division de nombres à virgules flottantes, on peut facilement avoir une imprécision à cause du mode de leur stockage en mémoire :

echo PHP_VERSION.PHP_EOL;
var_dump(fmod(9999.00000, 9998.00001));

donne :

7.3.14
float(0.99999000000025)

Variables dynamiques

Il est pratique d'avoir parfois des noms de variables qui sont variables. C'est-à-dire un nom de variable qui est affecté et utilisé dynamiquement. La valeur maVariable est affectée à une variable classique appelée a avec l'instruction suivante :

    $a = "maVariable";

Une variable dynamique, ou variable variable, utilise le nom d'une autre variable. Dans l'exemple ci-dessous, la valeur bonjour est affectée à la variable dynamique $$a, c'est-à-dire à une variable dont le nom est la valeur $a de la variable a. La variable classique a contient la valeur maVariable donc le code :

    $$a = "bonjour";

est équivalent à : $maVariable="bonjour";, ou encore ${$a} = "bonjour";.

Attention : cette syntaxe est inutile pour les fonctions. Ex :

 <?php
    function direBonjour()
    {
        echo "Bonjour !";
    }

    $a = 'direBonjour';
    $a();

Dans le cas des tableaux variables, il faut préciser si l'index s'applique à la variable ou à la variable dynamique à l'aide d'accolades^[5] :

 <?php
    $a = ['Hello', 'World'];
    echo ${$a[0]}; // Undefined variable: Hello
    echo ${$a}[0]; // Array to string conversion

Variable de classe variable

Les variables de classe seront introduites en détails dans un chapitre ultérieur. Mais il faut savoir que leurs noms peuvent aussi être variables avec ces notations :

 echo $this->$myVariableName;
 echo $this->{'variable'.$i};
 echo self::$myStaticVariableName;
 echo constant(self::class.'::'.strtoupper($myConstantName));

Autres variables

Les variables présentées dans ce paragraphe sont des tableaux indicés par le nom de la valeur accédée (une chaîne de caractère).

Variables superglobales

Pour plus de détails voir : Programmation PHP/Variables superglobales.

Variables de sessions

Pour plus de détails voir : Programmation PHP/Sessions.

Lors de la création d'une session (session_start()), il est possible d'enregistrer des variables (par session_register('nom_variable') = $variable ). On peut aussi utiliser le tableau $_SESSION pour créer et modifier une variable de session (par exemple : $_SESSION['ma_variable'] = 3; )

Il est également possible de supprimer les sessions courantes dans le code PHP en utilisant la fonction session_destroy(). La destruction de la session en cours peut aussi se faire par la fermeture du navigateur.

Pour supprimer une variable de session sans supprimer la session entière, il suffit d'utiliser la fonction unset($_SESSION['ma_variable']).

Variables de cookie

Pour plus de détails voir : Programmation PHP/Cookies.

Le tableau $_COOKIE permet de gérer les cookies (définis avec setcookie()^[6]). Ces cookies sont d'une très grande importance mais sont limités à 20 dans la configuration par défaut de PHP.

Ne pas mettre d'informations privées (mots de passe du serveur...) dans ces variables car elles sont stockées dans un fichier non protégé, sur le disque dur de l'utilisateur.

Variables de requêtes

$_REQUEST est un tableau associatif constitué du contenu des variables $_GET, $_POST, $_COOKIE.

Variables de fichiers

Pour plus de détails voir : Programmation PHP/Fichiers.

Lors d'un téléchargement de fichiers vers le serveur, une variable est assignée aux données de ce fichier. Il s'agit de $_FILES. Elle permet de récupérer le nom du fichier envoyé (exemple : mon_image.png), le nom du fichier temporaire où PHP a copié les données et où il est donc possible de les lire (exemple: C:\temp\T0001AF7.tmp).

Exemple :

 $_FILES['nom_fichier']

Variables mixtes

Le mot clé mixed permet de définir une variable mixte.

Variables de serveurs

$_SERVER permet d'obtenir des renseignements sous forme d'un tableau sur le serveur.

'PHP_SELF': Le nom du fichier du script en cours d'exécution, par rapport à la racine web. Par exemple, $_SERVER['PHP_SELF'] dans le script situé à l'adresse http://www.monsite.com/test.php/foo.bar sera /test.php/foo.bar. La constante __FILE__ contient le chemin complet ainsi que le nom du fichier courant.
'argv': Tableau des arguments passées au script. Lorsque le script est appelé en ligne de commande, cela donne accès aux arguments, comme en langage C. Lorsque le script est appelé avec la méthode GET, ce tableau contiendra la chaîne de requête.
'argc': Contient le nombre de paramètres de la ligne de commande passés au script (si le script fonctionne en ligne de commande).
'GATEWAY_INTERFACE': Numéro de révision de l'interface CGI du serveur : i.e. ' CGI/1.1 '.
'SERVER_NAME': Le nom du serveur hôte qui exécute le script suivant. Si le script est exécuté sur un hôte virtuel, ce sera la valeur définie pour cet hôte virtuel.
'SERVER_SOFTWARE': Chaîne d'identification du serveur, qui est donnée dans les en-têtes lors de la réponse aux requêtes.
'SERVER_PROTOCOL': Nom et révision du protocole de communication : i.e. ' HTTP/1.0 ';
'REQUEST_METHOD': Méthode de requête utilisée pour accéder à la page; i.e. ' GET ', ' HEAD ', ' POST ', ' PUT '.
'REQUEST_TIME': Le temps Unix depuis le début de la requête. Disponible depuis PHP 5.1.0.
'QUERY_STRING': La chaîne de requête, si elle existe, qui est utilisée pour accéder à la page.
'DOCUMENT_ROOT': La racine sous laquelle le script courant est exécuté, comme défini dans la configuration du serveur.
'HTTP_ACCEPT': Contenu de l'en-tête Accept: de la requête courante, s'il y en a une.
'HTTP_ACCEPT_CHARSET': Contenu de l'en-tête Accept-Charset: de la requête courante, si elle existe. Par exemple : ' iso-8859-1,*,utf-8 '.
'HTTP_ACCEPT_ENCODING': Contenu de l'en-tête Accept-Encoding: de la requête courante, si elle existe. Par exemple : ' gzip '.
'HTTP_ACCEPT_LANGUAGE': Contenu de l'en-tête Accept-Language: de la requête courante, si elle existe. Par exemple : ' fr '.
'HTTP_CONNECTION': Contenu de l'en-tête Connection: de la requête courante, si elle existe. Par exemple : ' Keep-Alive '.
'HTTP_HOST': Contenu de l'en-tête Host: de la requête courante, si elle existe.
'HTTP_REFERER': L'adresse de la page (si elle existe) qui a conduit le client à la page courante. Cette valeur est affectée par le client, et tous les clients ne le font pas. Certains navigateur permettent même de modifier la valeur de HTTP_REFERER sous forme de fonctionnalité. En bref, ce n'est pas une valeur de confiance.
'HTTP_USER_AGENT': Contenu de l'en-tête User_Agent: de la requête courante, si elle existe. C'est une chaîne qui décrit le client HTML utilisé pour voir la page courante. Par exemple : Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586). Entre autres choses, vous pouvez utiliser cette valeur avec get_browser pour optimiser votre page en fonction des capacités du client.
'HTTP_header': Valeur de l'en-tête HTTP correspondant envoyé dans la requête du client.
'HTTPS': Définissez à une valeur non-vide si le script nécessite d'utiliser le protocole HTTPS.
'REMOTE_ADDR': L'adresse IP du client qui demande la page courante.
'REMOTE_HOST': Le nom de l'hôte qui lit le script courant. La résolution DNS inverse est basée sur la valeur de REMOTE_ADDR
'REMOTE_PORT': Le port utilisé par la machine cliente pour communiquer avec le serveur web.
'SCRIPT_FILENAME': Le chemin absolu vers le fichier contenant le script en cours d'exécution.
'SERVER_ADMIN': La valeur donnée à la directive SERVER_ADMIN (pour Apache), dans le fichier de configuration. Si le script est exécuté par un hôte virtuel, ce sera la valeur définie par l'hôte virtuel.
'SERVER_PORT': Le port de la machine serveur utilisé pour les communications. Par défaut, c'est '80'. En utilisant SSL, par exemple, il sera remplacé par le numéro de port HTTP sécurisé.
'SERVER_SIGNATURE': Chaîne contenant le numéro de version du serveur et le nom d'hôte virtuel, qui sont ajoutés aux pages générées par le serveur, si cette option est activée.
'PATH_TRANSLATED': Chemin dans le système de fichier (pas le document-root) jusqu'au script courant, une fois que le serveur a fait une traduction chemin virtuel -> réel.
'SCRIPT_NAME': Contient le nom du script courant. Cela sert lorsque les pages doivent s'appeler elles-mêmes. La constante __FILE__ contient le chemin complet ainsi que le nom du fichier (i.e. inclut) courant.
'REQUEST_URI': L'URI qui a été fourni pour accéder à cette page. Par exemple : ' /index.html '.
'PHP_AUTH_DIGEST': Lorsque vous utilisez PHP avec Apache en tant que module faisant une identification HTTP Digest cette variable est définie dans l'en-tête 'Authorization' envoyé par le client (que vous devez donc utiliser pour réaliser la validation appropriée).
'PHP_AUTH_USER': Lorsque vous utilisez PHP avec Apache ou IIS (ISAPI en PHP 5) en tant que module faisant une identification HTTP, cette variable est définie à l'utilisateur fourni par l'utilisateur.
'PHP_AUTH_PW': Lorsque vous utilisez PHP avec Apache ou IIS (ISAPI en PHP 5) en tant que module faisant une identification HTTP, cette variable est définie au mot de passe fourni par l'utilisateur.
'AUTH_TYPE': Lorsque vous utilisez PHP avec Apache en tant que module faisant une identification HTTP, cette variable est définie au type d'identification.

Détection du protocole

Pour déterminer si l'utilisateur se connecte en HTTP ou HTTPS à partir de la superglobale $_SERVER :

$_SERVER['REQUEST_SCHEME'] semble la meilleure option, car renvoie "http" ou "https".
$_SERVER['SERVER_PORT'] renvoie 80 ou 443.
$_SERVER['HTTPS'] donne true en HTTPS ou null en HTTP (provoque un warning unset).
$_SERVER['SERVER_PROTOCOL'] ne convient pas du tout car renvoie "HTTP/1.1" dans les deux cas.
$_SERVER['HTTP_X_FORWARDED_PROTO'] et $_SERVER['HTTP_FRONT_END_HTTPS'] : à creuser...

Si ces variables renvoient les caractéristiques HTTP en connexion HTTPS, c'est qu'il faut activer SSL pour le site.

Tester les types

Plusieurs fonctions permettent de déterminer les types des objets.

Soit une variable $v :

gettype($v) donne son type simple ("object" si c'est une instance de classe).
get_class($v) donne son type complexe si c'est une instance de classe.
is_null($v) teste si un objet est null. Équivaut à "=== null"^[7].
is_bool($v) est vrai si booléen.
is_numeric($v) est vrai si numérique.
is_int($v) est vrai si entier.
is_float($v) est vrai si décimal.
is_string($v) est vrai si chaine.
is_array($v) est vrai si tableau.
is_object($v) est vrai si objet.
$v instanceof MaClasse est vrai si l'objet est de type "MaClasse".

Conversions

En PHP, il n'y a pas de déclaration de variable selon un type figé. Pour le forcer, il faut donc utiliser les fonctions suivantes, ou un cast (vers un type entre parenthèses).

Soit une variable $v, et $s un séparateur :

intval($v) ou (int) $v convertit en entier.
floatval($v) ou (float) $v convertit en flottant.
chr($v) convertit en caractère.
strval($v) ou (string) $v convertit un scalaire en chaine de caractères.
implode($s, $v) ou join($s, $v) transforme un tableau en chaine selon un séparateur donné.
explode($s, $v) convertit une chaine en tableau avec un séparateur donné entre les valeurs.

De plus, il est possible de réaliser un transtypage en préfixant la variable avec le type entre parenthèses. Exemple :

$a = 1;
$b = (bool) $a;
print gettype($a); // integer
print gettype($b); // boolean

(bool) "false" renvoie true car toute string non vide est vraie.

URLs

Tous les caractères Unicode n'étant pas admis dans les URL, on utilisera urlencode() pour convertir une chaine dans ce format.

De plus, si l'URL contient des paramètres HTTP, http_build_query() permet, en plus de l'encodage, de les générer à partir d'un tableau associatif.

Références

Variables superglobales

Les variables superglobales

Ces variables sont prédéfinies à PHP et sont destinées à stocker des informations bien spécifiques. Elles se présentent généralement sous la forme d'un tableau associatif à une ou deux dimensions. Elles sont disponibles dans tous les contextes d'exécution (fonctions ou méthodes).

Voici une liste non-exhaustive (comprenant les cas d'utilisation les plus courants) :

Variables de serveur : $_SERVER

Elle contient des informations sur le serveur (nom, IP, logiciels installés…)

Par exemple pour extraire l'URL de la page courante :

echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'];

Références

« Extraire l’url de la page en cours » [html]
(en) « $_SERVER » [html]

Variables d'environnement : $_ENV

Elle contient des informations sur l'environnement d'exécution du script PHP (c'est-à-dire sur le serveur). Elle est donc directement liée au serveur et à son système.

Prenons comme exemple, le prénom 'Paul' :

<?php
echo 'Mon nom d\'utilisateur est ' .$_ENV["USER"] . '!';

En imaginant que l'utilisateur 'Paul' exécute ce script, on aura alors :

Exemple

Mon nom d'utilisateur est Paul !

Cookies : $_COOKIE

Elle stocke les informations sur les cookies envoyés aux clients.

Un petit exemple pour illustre cela :

<?php
echo 'Bonjour ' . htmlspecialchars($_COOKIE["name"]) . '!';

On suppose que le cookie "name" a été défini précédemment, (on prendra Paul encore une fois)

L'exemple ci-dessus va afficher alors :

Exemple

Bonjour Paul !

GET variables : $_GET

Elle stocke les valeurs des arguments passés par URL. Ses clés sont donc par conséquent variables. Pour illustrer ces propos, imaginons que l'utilisateur ai entrée l'URL suivant : http://example.com/?name=Paul

<?php
echo 'Bonjour ' . htmlspecialchars($_GET["name"]) . '!';

L'exemple ci-dessus va afficher alors :

Exemple

Bonjour Paul !

POST variables : $_POST

Elle stocke les valeurs des informations passées par formulaire avec la méthode="post". Ses clés sont donc par conséquent variables.

L'exemple ci dessous est un formulaire comportant un champ de saisie et un bouton de soumission.

Quand un utilisateur soumet des données en cliquant sur "Soumettre", les données du formulaire sont envoyées dans un fichier spécial dans l'attribut d'action de la balise <form>.

Puis, on peut utiliser $_POST pour recueillir la valeur du champ de saisie.

Exemple

<html>
<body>

<form method="post" action="<?php echo $_SERVER['PHP_SELF'];?>">
  Nom : <input type="text" nom="fnom">
  <input type="soumettre">
</form>

<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // collecte la valeur du champ de saisie
    $nom = $_REQUEST['fnom'];
    if (empty($nom)) {
        echo "Le nom est vide";
    } else {
        echo $nom;
    }
}
?>

</body>
</html>

Variables de requête : $_REQUEST

Un tableau associatif constitué du contenu des variables $_GET, $_POST, $_COOKIE.

L'exemple ci dessous est un formulaire comportant un champ de saisie et un bouton de soumission.

Quand un utilisateur soumet des données en cliquant sur "Soumettre", les données du formulaire sont envoyées dans un fichier spécial dans l'attribut d'action de la balise <form>.

Puis, on peut utiliser $_REQUEST pour recueillir la valeur du champ de saisie.

Exemple

<html>
<body>

<form method="post" action="<?php echo $_SERVER['PHP_SELF'];?>">
  Nom : <input type="text" nom="fnom">
  <input type="soumettre">
</form>

<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // collecte la valeur du champ de saisie
    $nom = $_REQUEST['fnom'];
    if (empty($nom)) {
        echo "Le nom est vide";
    } else {
        echo $nom;
    }
}
?>

</body>
</html>

Variable de téléchargement : $_FILES

Elle stocke les informations sur un fichier envoyé via HTTP par le client par un formulaire.

Variables de session : $_SESSION

Elle contient les valeurs de la session en cours pour le client.

Variables globales : $GLOBALS

Elle stocke les variables globales de la page. Ses clés sont donc variables.

Ci-dessous, un exemple d'utilisation de la variable $GLOBALS.

Exemple

<?php 
$x = 75; 
$y = 25;
 
function addition()
{ 
    $GLOBALS['z'] = $GLOBALS['x'] + $GLOBALS['y']; 
}
 
addition(); 
echo $z;

Lorsqu'on exécute ce code, on obtient "100" (=> résultat de la variable 'z' + 'y').

filter_input()

Une bonne pratique consiste à filtrer les contenus des variables superglobales, qui sont vulnérables aux injections de code^[1].

Pour des raisons de sécurité, on évitera donc d'appeler directement les tableaux des variables superglobales comme dans les paragraphes précédents, pour leur préférer la syntaxe filter_input()^[2] :

<?php
echo filter_input(INPUT_GET, 'password'); // bien
echo $_GET['password'];                   // pas bien

Ne pas confondre avec la fonction filter_var() qui permet d'appliquer des validations ou nettoyages de certaines données^[3] (ex : email, URL, adresse IP, booléen...).

Références

Constantes

Tout comme en C, PHP peut utiliser des variables dont on précise la valeur une fois pour toutes et qui ne pourra être modifiée jusqu'à la fin de l'exécution du code.

Nom

Le nom d'une constante suit les mêmes règles que celles pour les variables, mis à part qu'il n'est pas précédé par $. Par convention on les baptise avec des lettres capitales.

// Noms valides
CONSTANTE1
CONSTANTE_2

// Noms invalides
0CONSTANTE

Déclaration

Pour déclarer une constante, on utilise la fonction define() (depuis PHP3) qui renvoie un booléen true en cas de réussite de déclaration et false en cas d'échec^[1].

La syntaxe de define est la suivante :

define(chaine_de_caractere, valeur);

La chaîne de caractère est le nom de la constante, pouvant contenir lettre, tiret, underscore et chiffre (la première lettre de la chaîne est une lettre dans [a-zA-Z]).

Utilisation

L'utilisation est semblable à celle des variables.

<?php
  define("CONSTANTE", "Texte ici");
  echo CONSTANTE; // affiche "Texte ici"

Depuis PHP 5, la déclaration de constantes à l'intérieur d'une classe peut se faire avec le mot-clé const de la façon suivante :

<?php
class MaClasse
{
    const CONSTANTE = "Texte ici";
    
    function afficher()
    {
      echo self::CONSTANTE;
    }
}

$instance = new MaClasse;
$instance->afficher();

Ces constantes sont publiques par défaut, mais PHP 7.1 introduit la possibilité de les rendre privée avec : private const.

Informations supplémentaires

Type de données

Une constante, si elle peut être de type booléen, entier, nombre à virgule flottante ou chaîne de caractère, mais en aucun cas un objet

Depuis PHP 7, elle peut aussi être un tableau de scalaires.

 <?php
 // Le code suivant va générer une erreur en PHP 5 (mais pas en PHP 7)
 define ("CONSTANTE", ["a", "b", "c"]);
 print_r(CONSTANTE);

Depuis PHP7.4, les nombres entiers peuvent être rendus plus lisibles dans le code en ajoutant des "_" comme séparateurs. Ex :

echo 10_00_000; // affiche 10000000

Unicité de la déclaration

La redéclaration d'une constante portant le même nom est ignorée, et la valeur de la première déclaration reste valable.

 <?php
 define ("CONSTANTE", "première définition");
 define ("CONSTANTE", "deuxième définition"); // ignoré
 echo CONSTANTE; // retournera toujours "première définition"

D'où l'utilisation de defined() pour déterminer si une constante est déjà définie ou pas^[2] :

 define("CONSTANTE", "première définition");
 if (!defined("CONSTANTE")) {
     //...

Conflit de nom

Il existe des constantes intégrées à PHP, or on ne peut créer une constante portant leurs noms, cela entraînerait une erreur. En général, évitez la syntaxe suivante pour le nom d'une variable ou d'une constante :

__NOM__

Constantes prédéfinies

Il en existe de deux types^[3] :

fixes en valeur
dont la valeur est dynamique

Constantes intégrées à valeur fixe

Les constantes suivantes ont des valeurs fixes, comme celles définies avec define :

TRUE : vrai (booléen) = 1.
FALSE : faux (booléen) = 0.
INF : l'infinie.
PHP_VERSION : version de PHP du serveur exécutant le script.
PHP_OS : nom du système d'exploitation du serveur exécutant le script.
PHP_EOL : end of line = \n.
DIRECTORY_SEPARATOR : '/' sur Linux et MacOS, '\' sur Windows.

Constantes intégrées à valeur dynamique

Les constantes magiques^[4] :

__DIR__ : dossier courant.
__NAMESPACE__ : namespace courant.
__FILE__ : chemin complet du fichier qui est actuellement exécuté par le serveur (exemple : /la/ou/est/le/fichier.php).
__CLASS__ : nom de la classe dans laquelle on se trouve.
__TRAIT__ : trait courant.
__FUNCTION__ : nom de la fonction dans laquelle on se trouve.
__METHOD__ : nom de la méthode dans laquelle on se trouve.
__LINE__ : ligne du fichier qui est actuellement exécuté par le serveur.

Exemple d'utilisation :

<?php
echo 'Fichier: ' . __FILE__ . "\n";
echo 'Ligne: ' . __LINE__ . "\n";

class test
{
    function foo()
    {
        echo 'Fonction: ' . __FUNCTION__ . "\n";
        echo 'Classe: ' . __CLASS__ . "\n";
    }
}

test::foo();
// ou alors
$test = new test();
$test->foo();

Qui affichera :

Fichier: /home/ze/toto.php
Ligne: 3
Fonction: foo
Classe: test
Fonction: foo
Classe: test

L'affichage de la première ligne, par exemple, dépend d'où est situé le fichier dans l'arborescence des fichiers.

Références

Opérateurs

Les opérateurs sont des symboles qui permettent de manipuler les variables.

Opérateurs arithmétiques

= Opérateur d'affectation

<?php
$un_chiffre = 4; //affectation de l'entier 4 à la variable un_chiffre
$un_mot = 'je suis fan des pâtes'; //affectation de la chaîne de caractères à la variable "un_mot"

+ Opérateur d'addition

<?php
$mon_premier_chiffre = 3;                                 //affectation du premier chiffre
$mon_deuxieme_chiffre = 4;                                //affectation du deuxième chiffre
$resultat = $mon_premier_chiffre + $mon_deuxieme_chiffre; //affectation de l'addition des deux chiffres
echo $resultat; //affiche 3+4 soit 7

Si les opérandes sont des tableaux, "+" est l'opérateur union^[1].

- Opérateur de soustraction

<?php
$mon_premier_chiffre = 3;
$mon_deuxieme_chiffre = 4;
$resultat = $mon_premier_chiffre - $mon_deuxieme_chiffre;
echo $resultat; //affiche 3-4 soit -1

* Opérateur de multiplication

<?php
$mon_premier_chiffre = 3;
$mon_deuxieme_chiffre = 4;
$resultat = $mon_premier_chiffre * $mon_deuxieme_chiffre;
echo $resultat; //affiche 3*4 soit 12

** Opérateur d’exponentiation

<?php
$mon_premier_chiffre = 2;
$mon_deuxieme_chiffre = 3;
$resultat = $mon_premier_chiffre ** $mon_deuxieme_chiffre;
echo $resultat; //affiche 2^3 soit 8

/ Opérateur de division

<?php
$mon_premier_chiffre = 3;
$mon_deuxieme_chiffre = 4;
$resultat = $mon_premier_chiffre / $mon_deuxieme_chiffre;
echo $resultat; //affiche 3/4 soit 0,75

% Opérateur modulo

<?php
$mon_premier_chiffre = 3;
$mon_deuxieme_chiffre = 4;
$resultat = $mon_premier_chiffre % $mon_deuxieme_chiffre;
echo $resultat; //affiche 3 modulo 4 soit 3 (le modulo est le reste entier de la division euclidienne)

Il sert à tester si un nombre est le multiple d'un autre :

<?php
if ($nb % 3 == 0) { 
 // $nb est un multiple de trois
}

Le reste de la division peut être obtenu avec la fonction fmod()^[2].

Opérateurs logiques booléens

Les opérateurs logiques agissent sur les types booléens (true ou false).

! : négation. Transforme false en true et true en false.
&& : opérateur "et".
and : opérateur "et" de moindre priorité.
|| : opérateur "ou"
or : opérateur "ou" de moindre priorité.

Opérateurs logiques bit à bit

Les opérateurs logiques bit à bit agissent sur chaque bit des valeurs entières.

~ Négation : 0 -> 1 et 1 -> 0
& Opérateur et (and)
| Opérateur ou (or)
^ Opérateur ou exclusif (xor)
>> : décalage à droite (division par deux)
<< : décalage à gauche (multiplication par deux).

Opérateurs d'assignation

Ils permettent de simplifier l'écriture des assignations.

??= : opérateur de coalescence nul^[3]
+= additionne deux valeurs et stocke le résultat dans la variable ($x += 5 équivaut à $x = $x+5)
-= soustrait deux valeurs et stocke le résultat dans la variable ($x -= 5 équivaut à $x = $x-5)
*= multiplie deux valeurs et stocke le résultat dans la variable ($x *= 5 équivaut à $x = $x*5)
/= divise deux valeurs et stocke le résultat dans la variable ($x /= 5 équivaut à $x = $x/5)
%= donne le reste de la division de deux valeurs et stocke le résultat dans la variable ($x %=5 équivaut à $x = $x%5)
|= effectue un OU logique entre deux valeurs et stocke le résultat dans la variable ($x |=5 équivaut à $x = $x|5)
^= effectue un OU exclusif entre deux valeurs et stocke le résultat dans la variable ($x ^= 5 équivaut à $x = $x^5)
&= effectue un ET logique entre deux valeurs et stocke le résultat dans la variable ($x &= 5 équivaut à $x = $x&5)
.= concatène deux chaînes et stocke le résultat dans la variable ($x .= 'test' équivaut à $x = $x.'test')

Opérateurs d'incrémentation

++ : incrémente de 1 la valeur de la variable si "$x = 1 ", "$x++" vaut "++$x" qui vaut "2".
-- : décrémente de 1 la valeur de la variable si "$x = 2", "$x--" vaut "--$x" qui vaut "1".

Ces opérateurs sont très utiles dans les boucles (notamment for).

Opérateurs de comparaison

== renvoie un booléen pour indiquer l'égalité (ce n'est pas =) : $x == 1 teste si la valeur $x est égale à 1.
=== renvoie un booléen pour indiquer à l'identique, c'est-à-dire l'égalité à la fois de la valeur et du type.
!= (alias <>) renvoie un booléen pour indiquer la différence : $x != 1 teste si la valeur $x est différente de 1.
!== renvoie un booléen pour indiquer la différence ou de la valeur ou du type.
> renvoie un booléen pour indiquer la supériorité stricte si $x > 1 teste si la valeur $x est strictement supérieure à 1.
< renvoie un booléen pour indiquer l'infériorité stricte : $x < 1 teste si la valeur $x est strictement inférieure à 1.
>= renvoie un booléen pour indiquer la supériorité-égalité si $x >= 1 teste si la valeur $x est supérieure ou égale à 1.
<= renvoie un booléen pour indiquer l'infériorité-égalité si $x <= 1 teste si la valeur $x est inférieure ou égale à 1.
<=>^[4] renvoie 1 si le premier opérande est supérieur, 0 s'il est égal, et -1 s'il est inférieur au deuxième.

Si les opérandes sont des tableaux :

"==" est l'opérateur d'égalité (mêmes paires clés/valeurs).
"===" vérifie aussi le type et l'ordre des paires clés/valeurs.
"!=" (alias "<>") est l'opérateur d'inégalité.
"!==" est l'opérateur non identique.

Opérateurs divers

Opérateur ?

L'opérateur ? permet de renvoyer une valeur ou une autre en fonction d'un test.

?? (depuis PHP 7) ^[5] (Null Coalescing Operator) opérateur binaire qui renvoie l'opérande qui le précède s'il existe (isset), sinon l'opérande qui le suit.
?: (depuis PHP 7) opérateur ternaire qui renvoie l'opérande qui le précède s'il existe et est non vide (empty), sinon l'opérande qui le suit.

Par exemple :

$appreciation = ($note>10) ? "bon" : "mauvais";

qui est équivalent au bloc PHP suivant :

if ($note > 10) {
    $appreciation = "bon";
} else {
    $appreciation = "mauvais";
}

Toutefois il présente un autre avantage que sa concision : la stratégie d'évaluation de cet opérateur ne calcule pas le "else" si le script n'a pas besoin d'y aller. Il devient donc moins gourmand en ressources.

En l'absence de premier résultat, le ternaire renvoie l'expression comparée si non nulle ou vide. Exemple :

print 1 ?: 2;    // 1
print 0 ?: 2;    // 2
print null ?: 2; // 2

Il est généralement plus lisible de placer un retour chariot avant les ternaires. Ex :

print 'Un est plus ' . (1 > 2
    ? ' grand'
    : ' petit'
). ' que deux.';

-> Opérateur objet

L'opérateur objet -> permet d'accéder aux propriétés d'un objet (variables et méthodes de classe). Exemple :

print $voiture->couleur;
$voiture->repeindre('bleu');

Depuis PHP 8 il a une version qui renvoie null si l'objet est null :

$voiture = null;
print $voiture?->couleur;

:: Opérateur de résolution de portée

L'opérateur ::, également appelé en PHP Paamayim Nekudotayim, permet d'accéder aux membres statiques ou constants d'une classe. Exemple :

print $voiture::couleur;

@ Opérateur de contrôle d'erreur

L'arobase permet d'ignorer les erreurs de l'expression qui le suit. Ex :

print 1/0; //Warning: Division by zero, puis INF

print @(1/0); // INF

& Opérateur de référence

"&" accolé avant une variable désigne sa référence^[6], qui est en quelque sorte un pointeur en lecture seule. Elles sont utiles par exemple pour éviter copier un grand tableau en mémoire quand il est en paramètre d'une fonction. Exemple :

public function archive(&$db)
{
    var_dump($db);
}

Son utilisation pour les fonctions sera détaillée dans le chapitre sur les fonctions, mais on peut aussi l'utiliser dans les boucles.

... Opérateur de fonction variadique

Depuis PHP 5.6, "..." dans la liste des arguments d'une fonction indique que ceux-ci sont d'un nombre variable.

Exemple :

public function somme(...$nombres)
{
    $somme = 0;
    foreach ($nombres as $n) {
        $somme += $n;
    }
    return $somme;
}

echo somme(1, 2, 3);
echo somme(1, 2, 3, 4);

Précédence des opérateurs

Quand une opérande est entourée de deux opérateurs (ex : 1 + 2 * 3 = 7), des règles de priorités s'appliquent systématiquement pour résoudre les opérations^[7].

Voici du plus au moins prioritaire :

$$
$
->
clone, new
**
+ - ++ -- ~
instanceof
!
* / %
+ - .
<< >>
.
< <= > >=
== != === !== <> <=>
&
^
\|
&&
\|\|
??
? :
= ^= <<= >>= ??=
yield from
yield
print
and
xor
or

Références

Fonctions

Définition de fonction

Outre les dizaines de fonctions natives^[1], PHP permet bien entendu d'écrire ses propres fonctions. Pour en définir une, il suffit d’utiliser le mot-clef function. Comme le langage est faiblement typé, une fonction peut retourner n’importe quel type de valeur (chaîne, entier…) ou ne rien retourner du tout. Enfin, ses arguments peuvent avoir des valeurs par défaut, être nommés (depuis PHP8) et sont limités à 12 par fonction.

Principe

// foo retourne le résultat de la somme du deuxième paramètre et de 4.
// Si aucun second paramètre n'est donné, la fonction utilisera la valeur 0 par défaut.
function foo($arg1, $arg2 = 0)
{
    print 'Fonction foo(' . $arg1 . ',' . $arg2 . ') donne : ';
    return $arg2+4;
 // tout ce qui suit ne sera jamais exécuté
}

//appel à la fonction
print foo(1,3);  //affichera: Fonction foo(1,3) donne 7
print foo(5);    //affichera: Fonction foo(5,0) donne 4

Notez que lorsqu'une fonction arrive à un return, elle l'effectue puis se termine, même s'il y a d'autres instructions après.

Contrairement à PHP 8, PHP 7 et antérieur ne permet pas d'appeler certains arguments par leurs noms : si l'on souhaite appeler un des derniers arguments, il faut donc définir tous ceux avant lui, même les optionnels. Toutefois pour éviter ce désagrément, on peut utiliser la classe ReflectionMethod. NB : il existe aussi ReflectionClass^[2].

Generator

Par ailleurs, en cas de gros volume de données à retourner, on peut utiliser yield au lieu de return pour les décomposer à l'aide du générateur PHP^[3] (classe Generator).

Ne jamais faire de condition "yield" sinon "return" car PHP renverra toujours un Generator mais si elle est fausse (si besoin il faut les séparer dans deux fonctions).

Portée des variables

Le problème de portée des variables est assez réduit en PHP. Une fonction n'a accès qu’à ses arguments, ses propres variables et aux variables globales importées statiquement (mot clé global). De ce fait, il y a peu de confusion.

Toujours suivant le même principe, les variables utilisées dans une fonction sont toutes détruites à sa sortie (les variables globales non, bien entendu).

Exemple


$valeur1=10;
$valeur2=20;

function exemple($valeur)
{
    global $valeur1; // récupération de la valeur globale de $valeur1
    $valeur3=5;
    $calcul=$valeur1+$valeur2+$valeur3+$valeur; // 10 + 0 + 5 + le paramètre qui sera entre parenthèses.
    //$valeur2 n'ayant pas été définie comme valeur globale, la variable $valeur2 est donc vide.
    return $calcul;
}

echo exemple(2); // affiche 17

On peut aussi trouver un peu plus compliqué si vous utilisez deux fichiers. L'un pour les variables, l'autre pour les traitements.

Principe

<?php
//-- fichier 1 : les variables globales (mot clef '''global''')
global $var1 = "Salut";

Principe

<?php
//-- fichier 2 : les traitements
echo "J'utilise ma variable globale : ".$GLOBALS['var1']; //-- Récupération via $GLOBALS

Espaces de noms

Depuis PHP 5.3.0, des espaces de noms peuvent être définis pour cloisonner certains objets, à l'aide du mot clé namespace utilisé en début de fichier^[4]. Exemple de définition :

<?php
 namespace Projet1;
...

Soit un fichier TestNS.php suivant :

<?php
 namespace Projet1\SousProjet2;

function Fonction1()
{
    echo "Fonction exécutée.\n";
    echo __NAMESPACE__;
}

Le fichier doit être encodé en ANSI ou Unicode sans BOM, mais pas en Unicode seul, sous peine d’avoir l'erreur Namespace declaration statement has to be the very first statement in the script, et d'être obligé de coller le mot "namespace" à "?php").

Exemple d’utilisation :

<?php
 require 'TestNS.php';
 Projet1\SousProjet2\Fonction1();

Par convention, l'arborescence du système de fichiers correspond à celle des espaces de noms. Dans l'exemple ci-dessus, il faudrait donc placer le fichier dans Projet1\SousProjet2\TestNS.php et faire plutôt require 'Projet1\SousProjet2\TestNS.php';

Références de variables

Les références sont utiles lorsque l’on souhaite retourner plusieurs valeurs dans une fonction. On utilise alors le passage d'argument par référence, qui fait que quand une fonction modifie un argument, la valeur de la variable du programme principale change aussi.

Pour utiliser un argument en tant que référence, il suffit d'y mettre l'opérateur de référence, le symbole & devant, dans la déclaration de la fonction.

Un exemple concret devrait vous faire comprendre :

Exemple

function foo(&$arg1, &$arg2, $arg3)
{
    $arg1 = 4;
    $arg2 = 6;
    $arg3 = 8;
}

foo($var1, $var2, $var3);
print $var1;  //affichera 4
print $var2;  //affichera 6
print $var3;  //affichera NULL car $arg3 n'est pas une référence (pas de &)

Fonctions variables

On appelle "fonction variable" une fonction dont on ne peut prédire le nombre d'arguments. Ce genre de fonction pourra se révéler pratique pour exécuter certains codes répétitifs ou le programmeur n'a pas envie de recopier le nom de la fonction pour n valeurs.

Pour cela, il faut retenir deux fonctions importantes :

func_num_args : permet de compter le nombre d'arguments (retourne true ou false).
func_get_args : permet de récupérer la valeur d’un argument (retourne un tableau de valeur)^[5].

Ces deux fonctions ne peuvent s'utiliser qu’à l'intérieur d’une fonction; dans le cas contraire un message d'erreur s'affichera.

Exemple

function afficher_variables ()
{
    $nb_args = func_num_args();
    $list_args = func_get_args();

    for ($i = 0; $i < $nb_args; $i++) {
        echo $list_args[$i].' ';
    }
}
$var1 = 'programmeur';
afficher_variables('Je suis', $var1, ', c\'est utile', ', c\'est intéressant.'); // Et on peut en rajouter autant que nécessaire.

Le code se comprend de lui-même. Il affichera : Je suis programmeur, c’est utile, c’est intéressant.

Fonctions de rappel

Pour passer une fonction en argument d'une autre, il faut utiliser call_user_func(). Ex :

    function fonctionAppelante(string $nomDeFonctionAppelee)
    {
        return call_user_func($nomDeFonctionAppelee);
    }

Fonctions anonymes

Une fonction sans nom peut être stockée dans une variable permettant de l'appeler. Le mot clé use permet d'injecter des variables globales dedans. Ex :

$variableGlobale = 'Hello';
$fonctionAnonyme = function ($argument) use ($variableGlobale) {
    return $variableGlobale.' '.$argument.PHP_EOL;
};
echo $fonctionAnonyme('World'); // Hello World
echo $fonctionAnonyme('You');   // Hello You

Fonctions fléchées

Depuis PHP7.4, on peut définir une fonction anonyme avec l'opérateur "=>" et le mot réservé fn. Ex :

$fonctionFlechee = fn($argument) => $variableGlobale.' '.$argument.PHP_EOL;
echo $fonctionFlechee('World'); // Hello World
echo $fonctionFlechee('You');   // Hello You

Fonctions prédéfinies

Voici une liste des fonctions globales prédéfinies en PHP les plus usuelles.

print() (alias echo) : affiche le contenu de la variable placée en paramètre.
printf() et dérivés (ex : sprintf) : print formaté, affiche un texte dont on remplace les marqueurs, numérotables, par les variables en paramètre^[6]. Exemple :

printf('Compteur : %s. ', 1);                     // Compteur : 1.
printf('Compteur : %s. ', 2);                     // Compteur : 2.

printf('Compteur : %s, taille : %s. ', 3, 1);     // Compteur : 3, taille : 1.
printf('Compteur : %2$s, taille : %1$d. ', 1, 4); // Compteur : 4, taille : 1.
printf('Compteur : %1$d, taille : %1$d. ', 5);    // Compteur : 5, taille : 5.

echo vsprintf('Tailles : %d, %d, %d, %d', [1, 2, 3, 4]); // Tailles : 1, 2, 3, 4

Les types suivants sont généralement utilisés :

d : digit
f : float
s : string

Pour échapper les "%" pour sont interprétés par ces fonctions, ce n'est pas "\" mais "%".
Ne pas utiliser les doubles quotes sous peine de Undefined variable: d.

sleep($secondes) : attend un certain nombre de secondes (utilisation déconseillée quand un humain doit attendre un résultat).
call_user_func_array('maFonction', 'mesArguments') : exécute une fonction à partir de son nom en chaîne de caractères.
getenv() : affiche toutes les variables d'environnement, ou celle demandée en paramètre.
ignore_user_abort(true) : ("false" par défaut) continue l'exécution d'un script lancé par un utilisateur, même s'il change de page ou clique annule le chargement.
header() : ajoute une clé dans l'en-tête HTTP de la réponse.
ini_get() : lit le php.ini.
ini_set() : modifie le php.ini le temps de l'instance.
set_time_limit() : redéfinit la limite de temps du php.ini.
require() : importe le code PHP d'un autre fichier, avec une erreur si c'est impossible^[7].
require()_once : idem en garantissant que chaque fichier n'est ajouté qu'une fois.
include() : importe le code PHP d'un autre fichier, sans erreur si c'est impossible.
include_once() : idem en garantissant que chaque fichier n'est ajouté qu'une fois.
getmypid() : retourne l'ID du processus courant dans l'OS.

Sur les chaînes

trim($string) : supprimer les espaces et retours chariots en début et fin de chaîne par défaut. Son second paramètre permet de remplacer les symboles à retirer.
strip_tags() : supprime les balises HTML de la chaîne mentionnée en paramètre 1, en conservant ceux en paramètre 2 (sous la forme d'une chaine comme '<p><br>').
ucfirst() : met une majuscule en début de chaîne.
lcfirst() : met une minuscule en début de chaîne.
strtoupper() : met en lettres capitales toute la chaîne.
strtolower() : met en bas de casse toute la chaîne.
strlen() : compte la taille d'une chaîne en octets. Pour avoir le nombre de caractères, utiliser mb_strlen() (pour multibyte).
str_contains($chaine, $cle) : cherche si une chaîne contient une sous-chaîne.
<codestr_starts_with($chaine, $cle) : vérifie si une chaîne commence par une sous-chaîne.
str_replace($ancien, $nouveau, $texte) : remplace des caractères par d'autres dans un texte ou un tableau^[8].
str_ireplace($ancien, $nouveau, $texte) : fait la même chose en ignorant la casse.
strtr($texte, $ancien, $nouveau) (string translate) : réputée plus rapide que str_replace^[9].
strpos($meubleDeFoin, $aiguille)^[10] : première position d'une sous-chaine. Attention : ne jamais utiliser comme si elle renvoyait un booléen (~~if (strpos())~~) car si la recherche est en première position (0) elle sera considérée comme fausse avec le typage faible. Il faut tester l'existence avec if (false !== strpos()).
stripos($meubleDeFoin, $aiguille) : fait la même chose en ignorant la casse.
strrpos($meubleDeFoin, $aiguille) : dernière position d'une sous-chaine.
substr($texte, $debut , $fin) : tronque un texte en sous-chaine. Utiliser mb_substr en Unicode.
Pour accéder à un seul caractère d'une chaine, PHP peut la considérer comme un tableau (ex : $chaine[0]).

Ex :

echo substr('Hello World', 0, 2); // "He" : les deux premiers caractères
echo substr('Hello World', -2);   // "ld" : les deux derniers caractères
echo substr('Hello World', 0, -1);   // "Hello Worl" : tout sauf le dernier caractère

substr_count($chaine, $sous-chaine) : compte le nombre de sous-chaine dans une chaine.
str_pad() : complète une chaine avec un caractère pour qu'elle atteigne la taille demandée si ce n'était pas le cas. Ex :

echo str_pad(10, 2, '0');               // 10
echo str_pad(9, 2, '0');                // 90
echo str_pad(9, 2, '0', STR_PAD_LEFT);  // 09

eval($chaine) : exécute une chaine comme un script PHP.
count_chars($chaine) : renvoie un tableau avec en clés chaque caractère de la chaine, et en valeur son nombre d'occurrences. Pratique pour détecter les anagrammes.
strcspn($chaine, $caracteres) : (complementary span) renvoie la taille de la sous-chaine située avant les caractères mentionnés^[11].

Encodage

Pour plus de détails voir : Coder avec Unicode/Conversion#PHP.

utf8_encode($chaine) et utf8_decode($chaine) sont dépréciée en PHP 8.2, il faut utiliser à la place mb_convert_encoding($chaine, 'UTF-8') et mb_convert_encoding($chaine, 'ISO-8859-1').

URLs

parse_url() : découpe une chaîne en partie d'une adresse URL (protocole, domaine et chemin d'accès).
http_build_query() : crée une URL à partir d'un tableau d'arguments GET. Par défaut le séparateur est "&" (3e argument). Cette fonction échappe les séparateurs. Ex :

php -r "var_dump(http_build_query(['x' => 1, 'y' => 2]));"
string(7) "x=1&y=2"

php -r "var_dump(http_build_query(['x' => '1/', 'y' => '2&'], '/', '/'));"
string(13) "x=1%2F/y=2%26"

Sur les nombres

pow($nombre, $exposant) (power) : élève un nombre à la puissance de l'exposant donné.
sqrt($nombre) (square root) : racine carrée.
max($nombre1, $nombre2, ...)^[12] : affiche le plus grand nombre parmi ceux en paramètres.
min($nombre1, $nombre2, ...) : affiche le plus petit nombre d'une liste.
round($nombre) : arrondit un nombre à l'entier le plus proche, ou selon une précision en deuxième paramètre s'il est renseigné^[13]. Exemple :

 echo round(5.49);  // 5
 echo round(5.50);  // 6
 echo round(5.555, 2);  // 5.56

number_format($nombre, 2, ',', ' ') : formate un nombre donné, où "2" représente le nombre de chiffres après la virgule, "," le séparateur décimal et " " le séparateur de milliers.

Ne jamais comparer des nombres issus du number_format() car les séparateurs faussent les calculs. Exemple : -1000.00 < -1000.02 // false -1,000.00 < -1,000.02 // -1

Bufferisation de sortie

La bufferisation de sortie bloque l'envoie de données au client HTTP pour les mettre dans une mémoire tampon à la place^[14].

ob_start() : démarre l'utilisation du tampon.
ob_get_contents : affiche le contenu du tampon.
ob_clean() : efface le tampon sans l'envoyer.
ob_flush() : envoie le tampon au client.

Références

Tableaux

Création de tableau

Un tableau (en anglais array) est une collection d'objet. En PHP, ces objets n'ont pas forcément le même type (cohabitation entre des entiers, des chaines…). Chaque objet est identifié par une clé appelée indice, que l'on met entre crochets (ex : $tableau[indice]).

Il existe trois manières de déclarer un tableau vide :

    $tab = [];       // depuis PHP 5.4
    $tab = {};       // moins permissif aux concaténations
    $tab = array();  // déconseillé depuis PHP 7

Pour créer un tableau non vide :

Manipuler les JWT

Pour décrypter le JWT :

use Lexik\Bundle\JWTAuthenticationBundle\Encoder\JWTEncoderInterface;
...
    public function __construct(
        private readonly JWTEncoderInterface $jwtEncoder,
    ) {
    }

    public function decodeJwt(string $jwt): array
    {
        return $this->jwtEncoder->decode($jwt):
    }

Résultat minimum :

array:6 [
  "iat" => 1724677672
  "exp" => 1724764072
  "roles" => array:1 [
    0 => "ROLE_INACTIF"
  ]
  "username" => "test"
]

Si on n'a pas besoin de vérifier le JWT (validité, expiration et signature modifiée par un pirate), on peut se passer de Lexik ainsi :

    private function decodeJwt(string $jwt): array|bool|null
    {
        $tokenParts = explode('.', $jwt);
        if (empty($tokenParts[1])) {
            return [];
        }

        $tokenPayload = base64_decode($tokenParts[1]);

        return json_decode($tokenPayload, true);
    }

Test

Pour tester en shell :

TOKEN=123
curl -H 'Accept: application/json' -H "Authorization: Bearer ${TOKEN}" http://localhost

Références

PHPUnit

PHPUnit est utilisé dans un certain nombre de frameworks connus pour réaliser des tests unitaires. Sa documentation en anglais est disponible au format PDF^[1].

Installation

Via composer

    composer require --dev phpunit/phpunit ^8

Via wget

Une fois le .phar téléchargé depuis le site officiel^[2], le copier dans le dossier où il sera toujours exécuté. Exemple :

Unix-like

    wget https://phar.phpunit.de/phpunit-8.phar
    mv phpunit.phar /usr/local/bin/phpunit
    chmod +x phpunit.phar

Windows

Ajouter à la variable d'environnement PATH, le dossier où se trouve le fichier (ex : ;C:\bin).
Créer un fichier exécutable à côté (ex : C:\bin\phpunit.cmd) contenant le code : @php "%~dp0phpunit.phar" %*.

Par ailleurs, le code source de cet exécutable est sur GitHub^[3].

Test

Test de l'installation :

    phpunit --version

Utilisation

Il faut indiquer au programme les dossiers contenant des tests dans le fichier phpunit.xml.dist. Exemple sur Symfony^[4] :

    <?xml version="1.0" encoding="UTF-8"?>

    <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/9.0/phpunit.xsd"
             backupGlobals="false"
             colors="true"
             bootstrap="vendor/autoload.php"
    >
        <php>
            <ini name="error_reporting" value="-1" />
            <server name="KERNEL_CLASS" value="AppKernel" />
            <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" />
        </php>

        <testsuites>
            <testsuite name="Project Test Suite">
                <directory suffix=".php">./tests</directory>
                <exclude>tests/FunctionalTests/*</exclude>
            </testsuite>
        </testsuites>

        <listeners>
            <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener" />
        </listeners>

    </phpunit>

Si on a plusieurs dossiers à exclure, mieux vaut sélectionner plutôt ceux à traiter :

    <directory suffix=".php">tests/UnitTests</directory>
    <directory suffix=".php">tests/FunctionalTests/QuickTests</directory>

Ensuite, pour tester tous les fichiers du dossier /test et ignorer ceux de /src, il suffit de lancer :

    ./bin/phpunit

Pour exclure un seul fichier ou une seule méthode des tests, lui mettre $this->markTestIncomplete('This test has to be fixed.');

Options

Ce .xml donne des options par défaut qui peuvent être modifiées dans les commandes. Par exemple stopOnFailure="true" dans la balise <phpunit> peut être par défaut, et phpunit --stop-on-failure seulement pour ce lancement.

Choisir les tests à lancer

Si les tests sont longs et qu'on ne travaille que sur un seul fichier, une seule classe ou une seule méthode, on peut demander à ne tester qu'elle en précisant son nom (ce qui évite d'afficher des dumps que l'on ne souhaite pas voir lors des autres tests) :

    bin/phpunit tests/MaClasseTest.php
    bin/phpunit --filter=MaClasseTest
    bin/phpunit --filter=MaMethodeTest

Si une méthode dépend d'une autre, on ne n'appeler que ces deux-là (peu importe l'ordre) :

    bin/phpunit --filter='test1|test2'

Détails de chaque test

Pour afficher les noms des tests et le temps qu'ils prennent, utiliser : --testdox

Rapports

Outre les résultats des tests, on peut avoir besoin de mesurer et suivre leur complétude, via le taux de couverture de code. PhpUnit permet d'afficher ce taux en installant Xdebug et en activant son option xdebug.mode = coverage.

Le calcul du taux de couverture peut ensuite être obtenu avec : bin/phpunit --coverage-text

Certains fichiers ne peuvent en aucun cas être testés, et doivent donc être exclus du calcul du taux de couverture dans phpunit.xml.dist. Par exemple pour les migrations et fixtures :

    <exclude>
        <directory suffix=".php">src/Migrations/</directory>
        <file>src/DataFixtures/AppFixtures.php</file>
    </exclude>

Dans un fichier

Le résultat des tests peut être sauvegardé dans un fichier de rapport XML avec l'option --log-junit phpunit.logfile.xml.

L'ajout de l'option --coverage-html reports/ générera un rapport du taux de couverture des tests en HTML (mais d'autres formats sont disponibles tels que l'XML ou le PHP), dans le dossier "reports" (créé automatiquement).

Exemple récupérable par l'outil d'analyse de code SonarQube : phpunit --coverage-clover phpunit.coverage.xml --log-junit phpunit.logfile.xml

Écriture des tests

    use PHPUnit\Framework\MockObject\MockObject;
    use PHPUnit\Framework\TestCase;

    class SuiteDeTests1 extends TestCase
    {
    /** @var MockObject */
    private $monMock1;

    protected function setUp(): void
    {
    // Création des mocks et instanciation de la classe à tester...
    $this->monMock1 = $this->getMockBuilder(maMockInterface::class)->getMock();
    }

    protected function tearDown(): void
    {
    // Libération des ressources après les tests...
    }

    public static function setUpBeforeClass(): void
    {
    // Pour réinitialiser une connexion déclarée dans setUp()
    }

    public static function tearDownAfterClass(): void
    {
    // Pour fermer une connexion déclarée dans setUp()
    }

    protected function test1()
    {
    // Lancement du premier test...
    $this->assertTrue($condition);
    }
    }

La classe de test PHPUnit propose des dizaines d'assertions différentes.

$this->fail()

PhpUnit distingue pour chaque test, les erreurs (ex : division par zéro) des échecs (assertion fausse). Dans le cas où on on souhaiterait transformer les erreurs en échecs, on peut utiliser $this->fail() :

    try {
    $response = $this->MonTestEnErreur();
    } catch (\Throwable $e) {
    $this->fail($e->getMessage());
    }

MockObject

Les mocks sont des objets PhpUnit qui permettent de simuler des résultats de classes existantes^[5].

certaines classes n'ont pas besoin de mock PhpUnit, comme Psr\Log\NullLogger qui peut être instancié depuis les tests des classes utilisant Psr\Log\LoggerInterface.

willReturn()

Par exemple, pour simuler le résultat de deux classes imbriquées (en appelant la méthode d'une méthode), on leur crée une méthode de test chacune :

    public function mainTest()
    {
    $this->monMock1
    ->expects($this->once())
    ->method('MaMéthode1')
    ->willReturn($this->mockProvider())
    ;

    $this->assertEquals(null, $this->monMock1->MaMéthode1()->MaMéthode2());
    }

    private function mockProvider()
    {
    $monMock = $this
    ->getMockBuilder('MaClasse1')
    ->getMock()
    ;
    $monMock->method('MaMéthode2')
    ->willReturn('MonRésultat1')
    ;

    return $monMock;
    }

Pour qu'une méthode de mock réalise un "set" quand elle est appelée, il ne faut pas le faire directement dans le willReturn, auquel cas il s'effectue lors de sa définition, mais dans un callback. Ex :

    $monMock->method('MaMéthode3')
    ->will($this->returnCallback(function($item) use ($quantity) {
    return $item->setQuantity($quantity);
    }))
    ;

willReturnArgument()

Renvoie l'argument dont le numéro est en paramètre.

willThrowException()

Pour qu'un mock simule une erreur. Ex :

    $monMock->method('MaMéthode3')->willThrowException(new Exception());

expects()

Dans l'exemple précédent, expects() est un espion qui compte le nombre de passage dans la méthode, et le test échoue si ce résultat n'est pas 1. Ses valeurs possibles sont :

$this->never() : 0.
$this->once() : 1.
$this->exactly(x) : x.
$this->any().

De plus, on trouve $this->at() pour définir un comportement dépendant du passage.

onConsecutiveCalls

Si la valeur retournée par le mock doit changer à chaque appel, il faut remplacer willReturn() par onConsecutiveCalls().

Exemple :

    $this->enumProvider->method('getEnumFromVariable')
    ->will($this->onConsecutiveCalls(
    ProductStatusEnum::ON_LINE,
    OrderStatusEnum::VALIDATED
    ));
    ;

with()

Cette méthode permet de définir les paramètres avec lesquels doit être lancé une méthode mock. Ex :

    $this->enumProvider->method('getEnumFromVariable')
    ->with($this->equalTo('variable 1'))

disableOriginalConstructor()

Cette méthode s'emploie quand il est inutile de passer par le constructeur du mock.

expectException()

S'utilise quand le test unitaire doit provoquer une exception dans le code testé (ex : s'il contient un throw).

    $this->expectException(Exception::class);
    $monObjetTesté->method('MaMéthodeQuiPète');

Si au contraire on veut vérifier que le code testé ne renvoie pas d'exception, on peut le lancer suivi d'une incrémentation des assertions :

    $monObjetTesté->method('MaMéthodeSansErreur');
    $this->addToAssertionCount(1);

Attributs

PHPUnit depuis sa version 10 offre plusieurs attributs pour influencer les tests. Exemples :

#[DataProvider()] : indique un tableau d'entrées et de sorties attendues lors d'un test^[6].
#[Depends()] : spécifie qu'une méthode récupère le résultat d'une autre (son return) dans ses arguments.

Annotations

PHPUnit offre plusieurs annotations pour influencer les tests^[7]. Exemples :

@covers : renseigne la méthode testée par une méthode de test afin de calculer le taux de couverture du programme par les tests.
@uses : indique les classes instanciées par le test.
@dataProvider : indique un tableau d'entrées et de sorties attendues lors d'un test^[8].
@depends : spécifie qu'une méthode récupère le résultat d'une autre (son return) dans ses arguments. Si elle appartient à un autre fichier, il faut renseigner son namespace : @depends App\Tests\FirstTest::testOne. Et comme PhpUnit exécute les tests dans l'ordre alphabétique des fichiers, il faut que le test se trouve après celui dont il dépend.

JavaScript

En PHP, Selenium peut s'interfacer avec PHPUnit^[9] pour tester du JavaScript.

Avec Symfony, il existe aussi Panther^[10].

Symfony

Pour récupérer une variable d'environnement ou un service dans un test unitaire Symfony, il faut passer par setUpBeforeClass() pour booter le kernel du framework :

    /** @var string */
    private static $maVariableYaml;
    /** @var Translator */
    private static $translator;

    public static function setUpBeforeClass(): void
    {
    $kernel = static::createKernel();
    $kernel->boot();

    self::$maVariableYaml = $kernel->getContainer()->getParameter('ma_variable');
    self::$translator = $kernel->getContainer()->get('translator');
    }

Seuls les services publics seront accessibles. Mais il est possible de créer des alias publics des services accessibles uniquement en environnement de test grâce au fichier de config services_test.yaml.

Test fonctionnel :

    public function testPost(): void
    {
    $route = '/api/test';
    $body = [
    'data' =>
    ['post_parameter_1' => 'value 1'],
    ];

    static::$client->request('POST', $route, [], [], [], json_encode($body));
    $response = static::$client->getResponse();
    $this->assertInstanceOf(JsonResponse::class, $response);
    $this->assertTrue($response->isSuccessful(), $response);

    $content = json_decode($response->getContent(), true);
    $this->assertNotEmpty($content['message'], json_encode($content));
    }

SimpleTest

SimpleTest est un framework de test open source en PHP qui possède une documentation en français sur http://www.simpletest.org/fr/.

Une fois le .gz téléchargé depuis le site officiel, le décompresser dans un répertoire lisible par Apache.

Il existe également sous la forme d'un plugin Eclipse^[1].

HelloWorld

Soit le fichier HelloWorld.php situé dans le répertoire du framework :

<?php
require_once('autorun.php');
class TestHelloWorld extends UnitTestCase
{
    function TestExitenceFichiers()
    {
        $this->assertTrue(file_exists($_SERVER['SCRIPT_FILENAME']));
        $this->assertFalse(file_exists('HelloWikibooks.php'));
    }
}

En exécutant ce script dans un navigateur, toutes les méthodes des classes de test sont exécutées séquentiellement. Il devrait donc comme prévu, se trouver lui-même, puis ne pas trouver un fichier HelloWikibooks avec succès.

Les nombres de tests réussis et échoués sont comptabilisés en bas de page, mais seuls les noms des fonctions en échec sont affichés.

Test d'un formulaire web

Plusieurs méthodes sont disponibles pour interagir avec les formulaires^[2]. Voici un exemple qui recherche certains mots sur un célèbre site, tente de s'y authentifier, et d'écrire dedans :

<?php
require_once('autorun.php');
require_once('web_tester.php');
class TestWikibooks extends WebTestCase
{   
    function TestTextesSurPage()
    {
        $this->assertTrue($this->get('http://fr.wikibooks.org/wiki/Accueil'));
        $this->assertTitle('Wikilivres');
        $this->assertText('licence');
        $this->assertPattern('/Bienvenue/i');
        $this->authenticate('MonLogin', 'MonMDP');
        $this->assertField('search', 'test');
        $this->clickSubmit('Lire');
        $this->assertText('Introduction au test logiciel');
    }
}

Sous réserve que le site possède bien un champ "name=search".

HTTPS n'est pas supporté par le framework : Error reading socket. Unable to find the socket transport "tls". SimpleTest ne semble plus maintenu depuis le 28 mai 2013, mais il existe un dépôt sur GitHub^[3].

Références

Behat

Behat est un framework de test pour faire du behavior-driven development. Cela consiste à rédiger plusieurs scénarios en langage Gherkin, proche de l'anglais naturel, avec indentation comme syntaxe, dans des fichiers .feature. Ces tests peuvent également tester du JavaScript.

Installation

http://behat.org/en/latest/

Lancer les tests avec en ligne de commande.

Syntaxe

Feature: Function to test description

    Texte libre

    Scenario: Scenario 1
        Given preconditions
        When actions
        Then results

    Scenario: Scenario 2
        ...

Les préconditions après "Given" correspondent au nom de la méthode PHP à exécuter.

Exemples

use Behat\Behat\Context\Context;

class Context1 implements Context
{
    public function iAmOnTheHomePage()
    {
        echo 'ok';
        throw new PendingException();
    }
}

Feature: Visit the homepage

Scenario: Click a link from the homepage
    Given I am on the homepage

Cette section est vide, pas assez détaillée ou incomplète. Votre aide est la bienvenue !

Catégorie:À faire

Compléments

Mink^[1] est une bibliothèque PHP permettant de simuler un navigateur Web, ce qui permet à Behat de tester du JavaScript avec Selenium^[2].

Références

↑ http://mink.behat.org/en/latest/
↑ (en) Junade Ali, Mastering PHP Design Patterns, Packt Publishing Ltd, 28 septembre 2016 (lire en ligne)

Logiciels métier

PHP propose de nombreuses solutions clés en mains pour construire des blogs, forums, e-commerces, etc.

CMS

Parmi les CMS les plus connus on peut citer Wordpress, SPIP, Joomla ou encore Drupal.

Certains moins connus sont e107.

Moteur de blog

Il en existe principalement Dotclear et Wordpress, même si ce dernier s'est étendu à un usage plus généraliste.

E-commerce

Parmi les solutions les plus éprouvées on peut utiliser Wordpress avec le plugin WooCommerce, Prestashop, osCommerce ou encore Magento.

Forums

Bien que passés de mode, PHP a accompagné la mode des forums. Les plus célèbres sont phpBB, IPB, Vbulletin ou encore Simple machines forum. Des alternatives plus légères comme punBB, FluxBB ou myBB existent.

Flarum est une solution moderne.

Problèmes connus

Le processus de débogage est relativement le même d'un bug à l'autre :

En cas d'erreur 400, regarder d'abord les logs les plus spécifiques (ex : le var/log de l'application), puis les logs des serveurs Web (ex : /var/log/nginx), puis ceux du système (/var/log).
En cas d'erreur 500 ou de non réponse, passer directement aux logs des serveurs.
En cas d'absence de log, localiser le problème avec :
- Des ajouts de logs supplémentaires.
- Xdebug.

La liste suivante doit permettre de gagner du temps pour solutionner les erreurs que l'on peut trouver dans les logs.

Erreurs sans message PHP

IIS tourne dans le vide après la mise à jour de PHP

Vérifier que les dépendances sont bien installées (ex : Visual C++)^[1].

Les modifications du fichier php.ini ne sont pas prises en compte dans phpinfo

Sur Wamp, redémarrer PHP et Apache ne suffit pas car Apache contient une copie du fichier php.ini dans C:\wamp64\bin\apache\apache2.4.54.2\bin, créée lors de la sélection de la version de PHP (au clic sur PHP/Version).

La connexion a été réinitialisée

Erreur sous Firefox provenant d'un mysql_close() ou d'une directive Apache.

La page n'est pas redirigée correctement

Un header revient en boucle après une suite de conditions. S'il est local, le remplacer par chdir().

Le code PHP n'est pas interprété (et est affiché)

Si a2enmod php7.4 indique que le module est déjà installé, c'est peut-être lié à a2enmod userdir. Cela peut se régler avec :

    vim /etc/apache2/mods-enabled/php7.4.conf

Commenter les lignes :

    <IfModule mod_userdir.c>
        ...
    </IfModule>

Et relancer Apache.

Sinon c'est peut-être le vhost utilisé qui n'est pas le bon (voir /var/log/apache2) ou qu'il ne contient pas :

    ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
    <Directory "/usr/lib/cgi-bin">
    Require all granted
    AllowOverride None
    Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
    Allow from all
    </Directory>

Les dernières lignes d'un POST sont ignorées

Il faut soit augmenter la variable PHP max_input_vars (ce qui ne peut pas être fait avec ini_set()^[2]), soit il faut fragmenter en plusieurs requêtes, par exemple toutes les 300 lignes.

Une expression régulière (regex) marche sur https://regex101.com/ mais pas en local

Si la machine est Windows, tenir compte de la différence de retour chariot : \r\n au lieu de \n.

Une addition ou soustraction de dates ajoute ou retire un jour

Cela survient quand on part d'un mois à 31 jours pour arriver à un mois qui en a moins.

Par exemple :

 var_dump((new DateTime('2024-12-31'))->add(new DateInterval("P6M"))); // 2025-07-01 00:00:00
 var_dump((new DateTime('2024-12-31'))->add(new DateInterval("P12M"))); // 2025-12-31 00:00:00

Pour avoir un calcul juste, on peut ajuster le jour du résultat ainsi :

            $startDate = new DateTime('2024-12-31');
            $originalDay = $startDate->format('d');
            $startDate->add(new DateInterval('P6M'));
            if ($startDate->format('d') !== $originalDay) {
                // Ajuster au dernier jour du mois précédent
                $startDate->modify('last day of previous month');
            }

            var_dump($startDate); // 2025-06-30 00:00:00

Une addition ou soustraction de dates ajoute ou retire une heure

C'est à cause des changements d'heure d'hiver et heure été.

Par exemple :

 var_dump((new DateTime('2024-12-31'))->add(new DateInterval("PT4320H"))); // 2025-06-29 01:00:00
 var_dump((new DateTime('2024-12-31'))->add(new DateInterval("PT8640H"))); // 2025-12-26 00:00:00

Pour avoir un calcul juste, on peut changer de fuseau horaire le temps du calcul, vers un qui n'est pas soumis aux changements d'heures^[3] :

 var_dump((new DateTime('2024-12-31 UTC'))->add(new DateInterval("PT4320H"))); // 2025-06-29 00:00:00
 var_dump((new DateTime('2024-12-31 UTC'))->add(new DateInterval("PT8640H"))); // 2025-12-26 00:00:00

ou à l'échelle du serveur :

$timeZone = date_default_timezone_get();
date_default_timezone_set('UTC');
// calcul
date_default_timezone_set($timeZone);

PHP natif

Connect Error, 2002: Aucune connexion n'a pu être établie car l'ordinateur cible l'a expressément refusée.

Relancer le serveur de base de données.

Connect Error, 2002: Une tentative de connexion a échoué car le parti connecté n'a pas répondu convenablement au-delà d'une certaine durée ou une connexion établie a échoué car l'hôte de connexion n'a pas répondu.

Ouvrir les pare-feux.

Invalid body indentation level (expecting an indentation level of at least 8)

En PHP7.3, la syntaxe heredoc impose de supprimer l'indentation de la balise fermante : elle soit suivre "\n".

json_decode renvoie NULL (aléatoirement)

Ajouter le paramètre 4 : JSON_THROW_ON_ERROR.

json_decode throw "Control character error, possibly incorrectly encoded"

La string à décoder est trop longue.

Malformed UTF-8 characters, possibly incorrectly encoded

Changer l'encodage de la chaine avant son encodage en JSON, avec^[4] : $chaine = mb_convert_encoding($chaine, 'UTF-8', 'auto');

MySQL server has gone away

La limite des 61 jointures a peut-être été atteinte dans une requête. Sinon vérifier les limites des ressources (du .ini) : par défaut default_socket_timeout égal 60 s.

This extension requires the Microsoft ODBC Driver 11 for SQL Server

Installer le pilote depuis https://www.microsoft.com/en-us/download/details.aspx?id=36434.

Unable to initialize module. Module compiled with module API=x. PHP compiled with module API=y. These options need to match

Se procurer une autre DLL à renseigner dans le fichier php.ini.

You can only iterate a generator by-reference if it declared that it yields by-reference

Se produit quand on itère sur la référence d'un générateur PHP :

    foreach ($generator as &$item) {
    ...
    }

Il faut donc retirer l'opérateur de référence (&) de l'itération...

Cannot traverse an already closed generator

Un iterator_to_array($generator) le ferme en le convertissant en tableau.

child exited on signal 7 (SIGBUS)

Modifier le fichier php.ini^[5] :

    pm.max_children = 80
    pm.max_spare_servers = 20
    pm.max_requests = 200
    apc.stat = 0

max_children est calculé en divisant la RAM par la taille des processus^[6].

Invalid resource type: unknown type

Le paramètre n°2 de fopen() ne permet pas la lecture^[7].

Each stream must be readable

On essaie de lire un fichier fermé : déplacer le fclose() après s'il y en a un avant.

fclose(): supplied resource is not a valid stream resource

On essaie de fermer un fichier fermé : utiliser if (is_resource($f)) avant.

SSL peer certificate or SSH remote key was not OK

Lors d'un curl_exec, ajouter :

    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

ou :

    $options['verify_host'] = false;
    $options['verify_peer'] = false;

Fatal error

[] operator not supported for strings

    // On récupère une variable dont on ne connait pas le type pour en faire un tableau
    if (!isset($tableau1)) {
    $tableau1 = array();
    } elseif (is_string($tableau1)) {
    $tableau1 = array($tableau1);
    }
    $tableau1[] = 'paramètre suivant';

Allowed memory size of x bytes exhausted

Modifier le fichier php.ini ou bien ajouter une autre limite dans le programme :

    ini_set('memory_limit', '100M');

Pour faire sauter la limitation :

    ini_set('memory_limit', '-1');

Si c'est dans une commande : php -d memory_limit=-1 ma_commande

Si c'est Composer : COMPOSER_MEMORY_LIMIT=-1 ./composer.phar update

Sinon, utiliser Xdebug en mode pas à pas pour visualiser les variables à supprimer (avec unset()).

Call to a member function ... on a non-object

La méthode est invoquée sur une variable qui n'est pas une classe.

Call to undefined function

Si une fonction est définie mais qu'on ne peut pas l'invoquer dans une méthode de classe, il faut préalablement l'importer en tenant compte du polymorphisme.

Call to undefined function sqlsrv_connect()

Installer le pilote correspondant à la version de PHP du serveur Web :

Télécharger sur https://www.microsoft.com/en-us/download/details.aspx?id=20098.
Copier dans le dossier PHP (ex : C:\Program Files (x86)\EasyPHP\binaries\php\php_runningversion\ext).
Ajouter au fichier php.ini.
Redémarrer le serveur Web.

Call to undefined method

La méthode est invoquée sur une classe qui ne l'a pas.

Si elle est censée l'avoir c'est qu'elle n'est pas récupérée, ce qui peut arriver avec les jointures entre entités d'ORM.

Cannot access empty property

Une variable non définie ne peut pas fournir de propriété. Si elle était définie ailleurs c'est qu'elle est inaccessible, et donc qu'il faut la récupérer (ex : avec global).

Error connecting to the ODBC database: [Microsoft][SQL Server Native Client 10.0][SQL Server]échec de l'ouverture de session de l'utilisateur

La précédente connexion n'a pas dû être fermée proprement avant une tentative de reconnexion. Essayer au choix :

    mysql_close($conn); // MySQL
    sqlsrv_close($conn); // MS-SQL
    odbc_close($conn); // ODBC

Out of memory

Éditer le fichier php.ini pour augmenter la limite mémoire : memory_limit = 256M Si cela ne suffit pas, vérifier la taille des structures et tableaux alloués, probablement par une boucle avec trop d'itérations ou une boucle infinie, ou le chargement d'une ressource trop volumineuse en mémoire.

pdo_sqlsrv_db_handle_factory: Unknown exception caught

Installer et configurer le paquet suivant :

    apt-get install -y locales
    echo "en_US.UTF-8 UTF-8" > /etc/locale.gen && locale-gen

Uncaught exception 'com_exception' with message 'Failed to create COM object `xxx.application': Accès refusé.

Sur le serveur Web Windows, dans démarrer, exécuter dcomcnfg (sinon y aller dans Outils d'administration, Service de composants), puis Ordinateurs, Poste de travail, Configuration DCOM, aller dans les propriétés de l'application mentionnée, puis dans l'onglet Sécurité, définir la première permission (Autorisations d'exécution et d'activation à Personnaliser et ajouter le compte du serveur ou site qui exécute le script (ex pour ISS : IIS_IUSRS ou IUSR).

Par exemple pour Word l'application se prénomme "Document Microsoft Office Word", et Excel "Microsoft Excel Application".

Uncaught exception 'com_exception' with message 'Source: Microsoft Office Excel Description: Mémoire insuffisante.

Il faut certainement rerégler la Configuration DCOM voire le serveur Web.

Uncaught exception 'PDOException' with message

could not find driver

Se référer à la liste des pilotes connus dans Programmation PHP/PDO.

SQLSTATE[HY000]: General error

PDO ne gère pas le code SQL "set @ma_variable" ou "if". Donc il faut plutôt faire ces calculs en PHP.

SQLSTATE[28000] [1045] Access denied for user

Si l'utilisateur existe avec les privilèges nécessaires, y compris depuis toute localisation (@%), il faut quand-même créer un deuxième compte homonyme pour l'emplacement distant (ex : 'username'@'example.com'). Par exemple dans phpMyAdmin, remplir la provenance mentionnée en erreur ('example.com') dans le champ "Client".

SQLSTATE[28000] SQLConnect: 18456 [Microsoft][ODBC SQL Server Driver][SQL Server] Échec de l'ouverture de session de l'utilisateur

Se référer à Programmation PHP/PDO : la source de données ODBC doit être suivie du compte pour y accéder.

SQLSTATE[IM002] SQLConnect: 0 [Microsoft][Gestionnaire de pilotes ODBC] Source de données introuvable et nom de pilote non spécifié

Se référer à Programmation PHP/PDO : la source de données ODBC doit être créée dans C:\Windows\SysWOW64\odbcad32.exe.

SQLSTATE[IMSSP]: An invalid keyword 'host' was specified in the DSN string

Se référer à Programmation PHP/PDO : le paramètre 'host' est valide pour MySQL mais pas pour MS-SQL.

SQLSTATE[IMSSP]: The DSN string ended unexpectedly

Se référer à Programmation PHP/PDO : les virgules et points-virgules changent d'un pilote à l'autre.

SQLSTATE[IMSSP]: This extension requires the Microsoft SQL Server 2012 Native Client ODBC Driver to communicate with SQL Server

Se référer à Programmation PHP/PDO : utiliser la syntaxe ODBC.

Notice

Undefined property

La propriété de la variable n'est pas déclarée.

Undefined index: SERVER_NAME in ...php

Certaines versions de PHP utilisent $_SERVER['HTTP_HOST'] au lieu de $_SERVER['SERVER_NAME'].

Undefined variable

La variable n'est pas déclarée.

Use of undefined constant

La constante n'est pas déclarée.

Parse error

syntax error, unexpected '(', expecting variable (T_VARIABLE) or '$' in...

Séparer le $ dans la chaine (ex : {$ -> { $).

syntax error, unexpected '' (T_ENCAPSED_AND_WHITESPACE), expecting identifier (T_STRING) or variable (T_VARIABLE) or number (T_NUM_STRING)

Remplacer les variables incluses dans des chaines. Ex :

    $query="select $contact['member']"; // pas bien
    $query="select ".$contact['member']; // bien

syntax error, unexpected '$Variable' (T_VARIABLE), expecting function (T_FUNCTION)

Dans une classe en dehors des méthodes, il faut déclarer les variables avec leur portée :

    private $Variable;

Strict Standards

Declaration of extFunctions::logs() should be compatible with functions::logs($chaine)

La fonction (logs() dans l'exemple) existe déjà, peut-être avec des majuscules (peu importe les arguments).

Only variables should be passed by reference

Il faut appliquer la fonction end() sur une variable au lieu du résultat d'une opération^[8]. Ex :

    // $extension = end(explode('.', $fichier));
    $ext = explode('.', $fichier);
    $extension = end($ext);

Warning

Cannot use a scalar value as an array

Un tableau de valeurs ne peut pas être redéfini en tableau de tableaux si elles existent. Remplacer les cas ainsi :

    $tab['1'] = 1;
    //$tab['1']['un'] = 'un';
    $tab['un']['un'] = 'un';

Creating default object from empty value

Se produit quand on appelle l'attribut d'un objet NULL.

date_diff() expects parameter 1 to be DateTimeInterface

La classe native DateTime() est plus pratique que la fonction date_diff() :

    $Avant = new DateTime('20140101');
    $Apres = new DateTime();
    print $Avant->diff($Apres)->format("%d");

Illegal string offset

On invoque une entrée inexistante dans un tableau associatif. Lever l'exception avec Try ou if (!isset(.

mkdir(): File exists

Sous Docker Desktop pour Windows, mkdir() appelle file_exists(), et ce dernier renvoie true si le dossier a existé.

PHP Startup: Unable to load dynamic library 'memcached.so'

sudo pecl install memcached

Si cela persiste : sudo apt-get install php-igbinary sudo apt-get install php-msgpack sudo service php7.2-fpm reload

PHP Startup: Unable to load dynamic library 'redis.so'

sudo pecl install redis

Erreurs SMTP

La connexion a échoué

Vérifier le serveur HTTP qui interprète le fichier .php.

SMTP Error: Could not connect to SMTP host

Changer de SMTP, ex : http://www.commentcamarche.net/faq/893-parametres-de-serveurs-pop-imap-et-smtp-des-principaux-fai

Si les mails partent sans arriver

Vérifier que l'IP de l'expéditeur n'est pas blacklistée : http://whatismyipaddress.com/blacklist-check
Définir un reverse DNS si absent
Veiller à ce que le mail ne soit pas présumé spam, en évitant les sujets vides par exemple, ou les pièces jointes exécutables non compressées (.exe, .cmd, .vbs...).

Composer

1 package has known vulnerabilities

Exemple avec un guzzlehttp/guzzle (7.4.3) absent du composer.json : composer depends guzzlehttp/guzzle puis composer update du résultat.

Si cela ne suffit pas, installer Guzzle puis le désinstaller pour mettre à jour sa dépendance indirecte : composer require guzzlehttp/guzzle && composer remove guzzlehttp/guzzle

"./composer.json" does not contain valid JSON

Lors d'un composer install, si ce message survient à tort, c'est qu'un autre fichier .json du projet contient le problème.

Si cela persiste malgré la correction, il se peut qu'il faille redémarrer Docker Desktop sur Windows.

Conclusion: don't install xxx

Lors d'un composer require, spécifier une version inférieure du paquet requis.

No driver found to handle VCS repository

VCS fonctionne en protocole git, vérifier que l'URL est bien au format "git@repo:bundle.git".

Sinon il y a deux alternatives :

Pour HTTPS, remplacer la dépendance de type "vcs" par une de type "package"^[9].
Pour décompresser un .zip, utiliser le type "artifact".

no matching package found

Ajouter le paramètre suivant : composer require mon_paquet --update-with-all-dependencies

Permission denied (public key)

Si le dépôt privé se clone bien sans passer par "composer" : voir la page Programmation PHP/Composer.

You must be using the interactive console to authenticate

Pour installer cette bibliothèque, il faut que Composer puisse se loguer. Pour ce faire, il utilise auth.json qui peut se trouver dans^[10] :

$HOME/.composer/auth.json
ou à côté du composer.json

Exemple de auth.json^[11] :

    {
    "github-oauth": {
    "github.com": "<snip>"
        },
        "http-basic": {
        "repo.magento.com": {
        "username": "<snip>",
            "password": "<snip>"
                }
                }
                }

Your Composer dependencies require a PHP version ">= 8.0.0".

Ajouter au paragraphe "config" :

    "platform-check": false

Puis relancer composer install pour que cela soit pris en compte.

Your requirements could not be resolved to an installable set of packages

Si deux dépendances s'empêchent mutuellement de se mettre à jour, les demander dans la même commande :

    composer require mon-bundle ^1.0 symfony/http-client 5.3.* -W

Timeout sur composer install

Désactiver Xdebug et relancer.

PHPUnit

Les tests ne se lancent pas

Si phpunit.xml.dist utiliser un bootstrap.php, y ajouter error_reporting(E_ALL);.

Sinon, si un var_dump() fonctionne dans le setUp() du test unitaire mais pas dans ses méthodes de test, c'est peut-être une exception qui se lance dans un trait ou dans le vendor PHPUnit. Pour la trouver, lancer l'application et regarder les logs (par exemple depuis un contrôleur).

Sinon, si ça fonctionne en commentant le "extends", tester la classe mère pour y trouver l'exception.

Sinon, dans Symfony, tail var/log/test/mon_log.log.

Sinon, lancer Xdebug pour comprendre.

et echo() ou var_dump() dans les tests n'affiche rien

Lancer le test en mode le plus verbeux :

Avec le paramètre : -vvv
Modifier phpunit.xml.dist avec :
- <server name="SHELL_VERBOSITY" value="3" />^[12]
- <ini name="error_reporting" value="true" />

Les tests fonctionnels renvoient toujours 404

Sur Symfony, self::createClient() appelle directement l'API sans serveur HTTP. Si on utilise phpunit dans symfony/phpunit-bridge, il va chercher sur example.com.

Sinon il manque peut-être un trailing slash dans la route appelée.

Les tests se lancent mais s'arrêtent sans explication, en renvoyant "killed"

Un var_dump() sature la mémoire.

Did you forget a "use" statement for MaClasse ou Class 'MaClasse' not found

Si des classes existent mais que PHPUnit n'arrive pas à les charger :

Vérifier les namespaces racines définis dans composer.json par autoload et autoload-dev.
Retirer suffix=".php" du phpunit.xml utilisé.

The .git directory is missing from...

Supprimer vendor/ et relancer composer.

THE ERROR HANDLER HAS CHANGED!

Plusieurs solutions possibles :

phpunit --self-update
Dans Symfony, changer phpunit.xml.dist avec SYMFONY_DEPRECATIONS_HELPER = weak_vendors
set_error_handler(array(&$this, 'handleGeoError'));
Si le projet Symfony a Sentry, on peut le retirer des tests dans bundles.php.

Trying to configure method "get" which cannot be configured because it does not exist, has not been specified, is final, or is static

Un mock ne récupère aucune méthode de sa classe car elle n'a pas pu être instanciée.

La casse du nom de la classe ou du namespace de son use n'est probablement pas exacte.
Sinon c'est la portée de la méthode mockée qui n'a pas publique. Si un dump du mock montre les attributs mais pas les méthodes, remplacer ->getMockForAbstractClass() par ->getMock().
S'il s'agit d'une méthode finale, il faut la définir lors de l'instanciation du mock. Ex :

    $this->serializerMock = $this
    ->getMockBuilder(SerializerInterface::class)
    ->setMethods(['serialize', 'deserialize', 'decode'])
    ->getMock()
    ;

    $this->serializerMock
    ->method('decode')
    ->willReturn('')
    ;

Trying to @cover or @use not existing method

Si la méthode existe bien, c'est que la classe testée n'a pas été définie en annotation (avec son namespace) :

    /**
    * @coversDefaultClass App\Service\MyService
    */
    class MyServiceTest extends TestCase
    {
    ...
    }

TypeError: Argument 1 passed to PHPUnit\Framework\TestCase::registerMockObjectsFromTestArguments() must be of the type array, null given

Si cela survient dans tous les tests qui invoquent un trait, retirer le constructeur de ce trait.

Warning No tests found in class "Xxx".

Si les méthodes de tests contiennent des assertions invisibles de PHPUnit, leur ajouter /** @test */ pour afficher pourquoi ils ne se lancent pas. Par exemple, il peut s'agir d'un mock qui demande un constructeur.

Si c'est normal de ne pas lancer de test dans une classe mère, la rendre abstraite ou statique.

Symfony

En cas d'erreur, un composant de débogage appelé "Profiler", est accessible en bas à gauche de la page d'erreur, avec des logs et mesures de performances. Installation :

composer require --dev symfony/profiler-pack

On peut par exemple accéder au phpinfo() via l'URL .../_profiler/phpinfo.

Le profiler fonctionne pour les contrôleurs mais pas pour les commandes.

La première soumission d'un formulaire ne marche pas, mais les suivantes oui

Retirer le :

$uow = $em->getUnitOfWork();
$uow->computeChangeSets();

Le contrôle de formulaire avec name=‘xxx’ ne peut recevoir le focus.

Il s'agit généralement d'un champ caché : le passer en required=false ou faire en sorte qu'il soit toujours rempli même caché.

Un champ de formulaire ChoiceType n'affiche pas sa valeur par défaut, qui est pourtant dans la liste

La liste contient une clé d'un type different. Exemple de solution :

'data' => (string) $myInteger,

Une route de contrôleur fonctionne dans un client HTTP mais pas dans un autre

Si $request est vide avec certains clients HTTP :

Utiliser HTTPS au lieu de HTTP.
Vérifier les paramètres d'en-tête HTTP (Accept: 'application/json' et Content-Type: 'application/json').
Utiliser $request->getContent() ou ou $request->toArray() au lieu de $request->request^[13] (ça ne marche pas à la place de $request->query).

Une route de contrôleur fonctionne dans un client HTTP mais pas en PhpUnit, ex : No matching accepted Response format could be determined (406 Not Acceptable)

    composer remove friendsofsymfony/rest-bundle

Attempted to load class "WebProfilerBundle" from namespace "Symfony\Bundle\WebProfilerBundle"

Si cela fonctionne avec "composer install" mais pas avec " composer install --no-dev", il faut définir APP_ENV=prod dans le .env.

Attribute "autowire" on service "xxx" cannot be inherited from "_defaults" when a "parent" is set. Move your child definitions to a separate file or define this attribute explicitly.

Lors d'utilisation de service abstrait, on ne peut pas utiliser l'autowiring. On peut alors transformer ce service abstrait en dépendance à injecter plutôt qu'à hériter.

Cannot autowire service... alors qu'il existe

Peut se produire :

quand le dossier de la classe est dans "App\.exclude" du services.yaml.
quand il n'est pas exclus et qu'on le déclare dans un .yaml importé dans services.yaml (donc en doublon de l'autowiring). Il faut alors soit le désactiver, soit exclure les namespaces concernés, soit déplacer ces déclarations dans services.yaml.
dans un bundle, si $loader->load('services.yaml'); est bien effectué^[14], alors le déclarer dans le services.yaml du bundle. Sinon, vérifier qu'il n'y a pas un chemin erroné dans l'extension prepend().
Depuis Symfony 6.1 on peut utiliser l'attribut #[Autowire]^[15].

    #[AsEventListener(event: KernelEvents::CONTROLLER)]
    class MyListener
    {
    public function __construct(
    private readonly Security $security,  // exemple
    private readonly ControllerResolverInterface $controllerResolver
    ) {
    }
    }

L'erreur est :

Cannot autowire service "App\EventListener\MyListener": argument "$controllerResolver" of method "__construct()" references interface "Symfony\Component\HttpKernel\Controller\ControllerResolverInterface" but no such service exists. You should maybe alias this interface to one of these existing services: "debug.controller_resolver", "debug.controller_resolver.inner".

La solution est d'écrire :

    #[AsEventListener(event: KernelEvents::CONTROLLER)]
    class MyListener
    {
    public function __construct(
    private readonly Security $security,  // exemple
    #[Autowire(service: 'controller_resolver')] private readonly ControllerResolverInterface $controllerResolver
    ) {
    }
    }

Cannot load resource "../../src/Controller/". Make sure to use PHP 8+ or that annotations are installed and enabled.

    composer require sensio/framework-extra-bundle

Circular reference detected

L'autoloader se heurte à un argument du constructeur d'une classe : il faut le sortir de la méthode __construct() pour le définir dans une méthode portant son nom. Exemple de déclaration en YAML :

    app.ma_classe:
    class: App\MaClasse
    arguments:
    - '@service.sans.probleme'
    calls:
    -   method: setServiceAvecProbleme
    arguments:
    - '@service.avec.probleme'
    tags:
    - { name: doctrine.event_subscriber }

A circular reference has been detected when serializing the object

Idem en fetch="EXTRA_LAZY" dans l'entité.

Pour résoudre cela sans changer de relation entre les entités, il y a plusieurs solutions :

Dans l'entité, use Symfony\Component\Serializer\Annotation\Ignore; et annotation /** @Ignore() */ au dessus de l'attribut en erreur.
Dans le contrôleur, éviter de renvoyer la réponse brute, mais filtrer les attributs avec use Symfony\Component\Serializer\SerializerInterface; et $this->serializer->serialize($data, 'json', $context).

curl error 6 while downloading https://flex.symfony.com/versions.json: Could not resolve host: flex.symfony.com

    composer update symfony/flex --no-plugins --no-scripts

CURLPIPE_HTTP1 is no longer supported

Si cela se produit sur un projet Symfony avec composer, il faut juste :

    composer global require symfony/flex ^1.5
    rm -Rf vendor/symfony/flex

Environment variables "xxx" are never used. Please, check your container's configuration.

Pazsser par des variables intermédiaires dans services.yaml :

    yyy: '%env(xxx)%'

Error 400 Bad Request Your browser sent a request that this server could not understand.

Les règles de réécriture d'URL Apache sont erronées (voir ci-dessous).

Error 404 Not Found The requested URL /xxx was not found on this server.

Si la page d'accueil fonctionne mais pas les sous-pages (alors qu'un nom de domaine est déjà dédié au site dans le vhost), les règles de réécriture d'URL de la configuration Apache sont manquantes ou erronées. Il faut donc créer public/.htaccess :

    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^(.*)$ index.php [QSA,L]
    </IfModule>

Invalid header: CR/LF/NUL found

Un JSON envoyé en POST dans symfony/http-client contient des retours chariots inattendus : les retirer. Ex :

    $json = preg_replace("(\r?\n)", '', $json);

manifest.json does not exist

yarn install && yarn add --dev @symfony/webpack-encore && yarn build

Maximum function nesting level of '6000' reached

Si cela se produit par exemple en vidant le cache, c'est que deux services se renvoient la balle (même indirectement) depuis leurs constructeurs.

NetworkError when attempting to fetch resource (Firefox) / Failed to fetch (Chrome)

Dans l'API avec Swagger UI : violation du CQRS empêchant l'affichage du résultat de l'API dans /api/doc, à causes des domaines. Sur un domaine local, cela peut être résolu en changeant l'URL avant /api/doc pour qu'elle soit valide (ex : passer de wikibooks/api/doc à wikibooks.org/api/doc).

Sinon réessayer en HTTP au lieu de HTTPS.

Sinon c'est la clé renseignée (du .env) qui est différente de celle en BDD.

Si le serveur Web est Nginx, retirer du vhost "add_header Access-Control-Allow-Origin *;" et "limit_exept".

request->request et request->query sont vides à tort

Utiliser $request->getContent() ou $request->toArray() à la place^[16].

SQLSTATE[HY000] [2002] php_network_getaddresses: getaddrinfo failed: Name or service not known

Un service inexistant ou avec des paramètres en erreur est appelé. Cela peut être provoqué par une variable d'environnement d'URL manquante ou erronée (ex : retirer le protocole, ou ajouter la version du SGBD).

SSL certificate problem: unable to get local issuer certificate

Utiliser l'installation avec "Composer.phar" plutôt que "Symfony.phar".

InvalidArgumentException Invalid env(bool:xxx) name: only "word" characters are allowed

Soit retirer la résolution "bool:" sur la variable d'environnement concernée, soit la renommer si elle contient des symboles autres que des lettres, des nombres ou underscore (ex : "=", "%", ":", etc.).

The autoloader expected class "App\MaClasse" to be defined in file "/var/www/.../MaClasse.php". The file was found but the class was not in it, the class name or namespace probably has a typo.

Revérifier que :

le fichier a bien l'extension .php
la balise ouvrante <?php
comporte bien la classe du même nom à la majuscule prêt
avec le bon namespace et qui correspond aux dossiers (vérifiable dans la déclaration avec CTRL + clic dans PhpStorm).

Uncaught ReflectionException

Si c'est lors du passage de PHP 7 à 8, essayer de lancer le script sans Symfony pour avoir le détail (ex : utiliser PhpUnit directement au lieu de PhpUnit bridge). Cela peut par exemple provenir de return type différents entre une interface (ex : ArrayAccess) et son implémentation.

You have requested a non-existent parameter "kernel.secret". Did you mean this: "kernel.charset"?

À l'installation d'une dépendance, si les champs sont renseignés dans config/packages, alors c'est qu'ils ne sont pas chargé dans le bundle par Kernel.php.

Peut se traduire aussi par des erreurs de chargement de bundle du type : The child config "x" under "y" must be configured.

"The controller for URI \"/api/ma_route/123\" is not callable: Controller \"MonController\" does neither exist a service nor as class."

Si bin/console debug:autowiring --all montre le service et bin/console debug:route la route, renseigner routes.yaml et vider le cache. Ex :

index:
    methods: DELETE
    path: /api/ma_route/{id}
    controller: App\Controller\MonController::__invoke

Si ça ne fonctionne pas, passer par un évènement sur la méthode générique.

Doctrine

Le champ ne se sauvegarde pas en base

Est-ce qu'il y a le flush après la modification du champ ?
Le cache Doctrine a-t-il bien été vidé depuis l'ajout du champ ?
Est-il bien dans la variable, sinon est-il mappé dans un formulaire ?
Est-il en annotation PHP alors que Symfony est configuré pour les attributs ?
Est-il qu'il y a eu un clear() avant le flush(), ce qui aurait détaché l'entité à sauvegarder ?

Le champ sauvegardé en base est toujours 0

Se produit quand on utilise l'annotation @ORM\GeneratedValue(strategy="IDENTITY") sur un champ qui n'est pas AUTOINCREMENT en base de données.

A new entity was found through the relationship 'X' that was not configured to cascade persist operations for entity: X. To solve this issue: Either explicitly call EntityManager#persist() on this unknown entity or configure cascade persist this association in the mapping for example @ManyToOne(..,cascade={"persist"})

Dans le cas d'un Doctrine\ORM\ORMInvalidArgumentException:
- Si on est en train de suppriemr une entité, il manque son retrait d'une collection au préalable (ex : $entityToKeep->removeEntityToDelete($entityToDelete));
- Un service a un tag et un argument constructeur incompatible. Ce service en argument fait un $em->clear() au lieu de clear(object), ou persist(object) au lieu de merge(object).
Dans le cas "Multiple non-persisted new entities were found through the given association graph"
- Ajouter un persist dans l'entité ou avant le flush.
- Sinon, on tente de flusher une entité récupérée, ou dont une de ses entités liées a été récupérée, par l’entityManager d'un replica SQL (potentiellement non répliqué). Utiliser la base de données maitresee à la place.
- Sinon c'est que le même flush est réalisé plusieurs fois : ajouter du cache d'instance pour ne pas ré-exécuter ce code.

Binding an entity with a composite primary key to a query is not supported

Se produit quand on utilise la méthode magique find() d'un repository sur une entité qui a une clé composite (au moins deux attributs avec @ORM\Id). Il faut alors utiliser findBy(['id' => xxx]).

Call to undefined function Closure at EventDispatcher.php:299

Ajouter dans composer.json :

    "conflict": {
        "symfony/symfony": "*",
        "doctrine/common": ">=3.0",
        "doctrine/persistence": "<1.3"
    },

Puis lancer "composer update".

Cannot autowire service "App\Components\CRM\Repository\MonRepository": argument "$class" of method "Doctrine\ORM\EntityRepository::__construct()" references class "Doctrine\ORM\Mapping\ClassMetadata" but no such service exists.

Se produit avec l'autowiring, quand on ajoute l'annotation vers un repo dans une entité. Ex :

@ORM\Entity(repositoryClass="App\MonRepository")

En fait depuis Doctrine 1.8^[17], le repository doit étendre "ServiceEntityRepository" au lieu de "EntityRepository", et avoir un constructeur. Par exemple :

use App\Entity\MonEntite;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Symfony\Bridge\Doctrine\ManagerRegistry; // anciennement Doctrine\Persistence\ManagerRegistry;

class MonEntiteRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, MonEntite::class);
    }

Cannot select entity through identification variables without choosing at least one root entity alias

Retirer les ->addSelect() du queryBuilder, ou utiliser ->from().

Class "App\Entity\X" seems not to be a managed Doctrine entity. Did you forget to map it?

On fait appel à une classe PHP comme si c'était une entité Doctrine : il faut simplement ajouter les annotations Doctrine à la classe, ou bien recréer la table à partir du code PHP.

Column not found: 1054 Unknown column 't0.xxx_id' in 'field list'

Il faut juse ajouter la colonne de jointure sous l'annotation *To*. Ex :

@ORM\JoinColumn(name="id", referencedColumnName="id_personne")

Could not find the entity manager for class '...'

Dans doctrine.yaml, retirer type: annotation.

Entity has to be managed or scheduled for removal for single computation

Si remove : retirer le ON CASCADE DELETE de l’entité supprimée.
Si update : faire le add avant.

Entity of type 'App\\MonEntite' for IDs id(1) was not found

S'il s'agit de l'ID d'une entité jointe, le rendre nullable (@ORM\JoinColumn(nullable=true))^[18].

S'il s'agit d'une entité dont la clé primaire est une clé étrangère, lui ajouter :

 @ORM\GeneratedValue(strategy="NONE")

Entity of type App\\MonEntite is missing an assigned ID for field 'id'.

Une entité n'arrive pas à être sauvegardée avec un ID null (non auto-incrémenté). Il faut donc le générer (par exemple avec un new UuidV4()).

Sinon vérifier que l'erreur ne vient pas d'un listener en sur Doctrine\ORM\Events::prePersist qui tente de persister l'entité récupérée via $eventArgs->getEntity().

Invalid PathExpression. Must be a StateFieldPathExpression

Cela peut arriver quand on ajoute une clé étrangère dans un select sans sa jointure :

$this->createQueryBuilder('user')
    ->select(['user.id', 'user.company'])

On peut donc le remplacer par :

$this->createQueryBuilder('user')
    ->select('user.id')
    ->leftJoin('user.company', 'u')

Par contre, si on ne veut pas la jointure, utiliser "identity" :

$this->createQueryBuilder('user')
    ->select(['user.id', 'identity(user.company) company'])

No alias was set before invoking getRootAlias()

Se produit soit :

Lors d'un $qb = $this->entityManager->getEntityManager()->createQueryBuilder(); (sans alias comme dans : $this->createQueryBuilder('me') hérité de EntityRepository).

Il faut alors rajouter un alias pour l'entité courante ainsi :

$em->createQueryBuilder()
    ->select('me')
    ->from(MonEntite::class, 'me')

Ou pour un update où on répète à tort l'alias ('me') dans update() (ce qui peut aussi donner Error: Class 'pn' is not defined quand il n'y a pas de jointure) :

$this->createQueryBuilder('me')
    ->update()
    ->set('me.isDeleted', 1)

Property \"metadata\" on resource \"App\\MonEntite\" is declared as a subresource, but its type could not be determined in

Survient quand une entité étend une autre sans discriminator^[19].

The association mon_entité1#entité2 refers to the owning side field mon_entité2#id which does not exist

Si l'entité 2 ne fait pas référence à l'entité 1, supprimer dans l'entité 1, champ entité2, le mappedBy=.

The class 'Doctrine\Common\Collections\ArrayCollection' was not found in the chain configured namespaces App\Entity

Il peut y avoir une entité avec une relation ManyToMany dans laquelle on met un ArrayCollection au lieu de l'entité demandée^[20].

Sinon vérifier qu'on attend pas un PersistentCollection au lieu d'un ArrayCollection (ou vice-versa avec ->unwrap()).

The EntityManager is closed

Cela survient quand l'EntityManager rencontre une exception. On peut^[21] :

la lever avec :

if ($this->em->isOpen()) {
$this->em->persist($entity);
$this->em->flush($entity);
}

recréer l'entityManager :

        if (!$this->em->isOpen()) {
            $this->em = $this->em->create(
                $this->em->getConnection(),
                $this->em->getConfiguration()
            );
        }

The field xxx has the property type 'bool' that differs from the metadata field type 'int' returned by the 'integer' DBAL type

Se produit avec :

 bin/console doctrine:schema:validate

Quand il trouve par exemple une option par défaut manquante. Ex :

    #[ORM\Column(type: 'boolean', nullable: true, options: ['default' => null])]

The identifier id is missing for a query

Se produit lors d'un repository->find(null).

The metadata storage is not up to date, please run the sync-metadata-storage command to fix this issue

Si le paramètre "server_version" est présent dans le DSN "DATABASE_URL", l'ajouter, sinon le retirer.

The referenced column name 'xxx' has to be a primary key column on the target entity class

S'il n'est pas possible d'utiliser la clé étrangère comme clé primaire, retirer simplement la ligne :

 #[ORM\JoinColumn(name: 'my_id', referencedColumnName: 'my_id')]

Mais ça peut provoquer un problème N+1...

The table with name 'xxx' already exists

Si cela survient lors du bin/console doctrine:schema:validate, create ou update sur une base vide, et qu'il n'y a pas de doublon dans le dossier "Entity"^[22] :

Chercher les doublons dans d'autres namespaces.
Retirer les appels directs à la table de l'entité mal placés (#[ORM\JoinTable(name: xxx)).
Forcer la version du SGBD dans DATABASE_URL, en l'ajoutant dans ?serverVersion=.
Dans le cas du validate, on peut ajouter --skip-sync pour bypasser cette partie du test.

Transaction commit failed because the transaction has been marked for rollback only

Se produit quand un flush() rencontre une erreur SQLSTATE (ex : colonne manquante, même d'une autre table, ou locks à cause d'UPDATE du même champ qui se répètent).

Le commenter pour la voir apparaitre.
Si elle n'apparait pas (ex : timeout), regarder directement dans les logs de la base de données.

Cela peut être dû à la présence de deux attributs dans une entité, pointant vers la même colonne de sa table (ex : un ID de clé étrangère et son objet correspondant).

Uncaught PHP Exception Doctrine\Common\Proxy\Exception\UnexpectedValueException: "Your proxy directory "var/cache/prod/doctrine/orm/Proxies" must be writable"

Si cela se produit avec APP_ENV=prod et pas dev dans le .env :

rm -Rf var/cache/ var/log

Uncaught Symfony\Component\Debug\Exception\UndefinedFunctionException: Attempted to call function "apc_fetch"

    sudo pecl install apcu
 sudo pecl install apcu_bc
 sudo apt-get install -y php7.2-apcu php7.2-apcu-bc

Unexpected non-iterable value for to-many relation

Modifier la déclaration du champ en erreur avec un itérable. Ex :

public $mesObjets = new ArrayCollection();

S'il n'y a pas de champ en erreur, il faut le retrouver avec dd($type) dans AbstractItemNormalizer.

Unknown database

Lancer doctrine:database:create :

    bin/console d:d:c

Puis rajouter les éventuelles tables :

    bin/console doctrine:schema:update --force

Unrecognized field (ORMException)

Se produit quand un findBy de repository ne trouve pas un champ de son entité. Cela peut être résolu avec :

bin/console cache:clear
Vérifier si on ne recherche pas à tort une valeur sans sa clé (si Unrecognized field: 0).
Passer par un QueryBuilder plutôt que par un find.
Ne pas faire hériter le repo de ServiceEntityRepository.

WARNING [cache] Failed to save key... "cache-adapter" => "Symfony\Component\Cache\Adapter\ApcuAdapter"

Ajouter apc.enable_cli=1 dans le fichier php.ini.

DoctrineMigrations

S'il n'exécute pas tout (sans logs même en -vvv)

Séparer en plusieurs migrations, notamment les créations de tables et de fonctions.

The schema provider is not available

Remplacer "connection" par "em" dans doctrine_migrations.yaml :

    doctrine_migrations:
    em: default

Syntax error or access violation

Il faut probablement échapper des caractères, par exemple avec la syntaxe heredoc ou $this->connection->quote().

API Platform

Invalid IRI

Ajouter le getId() dans l'entité récupérée par IRI.

InvalidArgumentException: "No item route associated with the type xxx

Se produit quand on a pas une route POST sans route GET^[23], ou si le GET n'a pas d'ID pour créer des URI. Il faut donc en créer une, mais pas forcément besoin de créer un contrôleur :

 * @ApiResource(
 *     itemOperations={
 *         "get"={
 *             "method"="GET",
 *             "controller"=NotFoundAction::class,
 *             "read"=false,
 *             "output"=false,
 *         },
 *     },
 * )

No identifiers defined for resource of type

 /**
  * @ApiProperty(identifier=true)
 */
 private $id;

Si aucun ID n'est possible, en renvoyer "1" par exemple.

Unable to generate an IRI for

En général, rajouter un getId() dans l'entité.

The total number of joined relations has exceeded the specified maximum. Raise the limit if necessary with the \"api_platform.eager_loading.max_joins\" configuration key, or limit the maximum serialization depth using the \"enable_max_depth\" option of the Symfony serializer

Sur MySQL (ou MariaDB) il existe un maximum de 64 jointures. Donc s'il n'est pas possible d'augmenter max_joins, il faut limiter les jointures par les deux annotations suivantes :

 * @API\ApiSubresource(maxDepth=1)
* @ORM\OneToMany(targetEntity="MonEntité", mappedBy="monChamp", fetch="EXTRA_LAZY")

Twig

Un template Twig ne se rafraichit pas dans la navigateur

En local, dans .env, passer de APP_ENV=prod à APP_ENV=dev.

Sinon vider le cache Symfony.

A hash key must be followed by a colon (:)

Il faut probablement mettre des parenthèses autour des variables dans un merge de tableau. Ex :

myArray|merge([{(myKey): (myValue)}])

Array to string conversion

Plusieurs solutions sont possibles pour afficher un tableau dans un template JSON.

Pour avoir un tableau, ajouter (et retirer les guillemets autour de la valeur si besoin) :

    "my_key": {{ my_value |json_encode(constant('JSON_PRETTY_PRINT'))|raw }},

voire :

    "my_key": {{ my_value |join(', ') }},

Pour avoir un objet en chaine de caractères, faire le json_encode en amont puis laisser les guillemets :

    "my_key": "{{ my_value }}",

double quoted property

Une virgule de trop après une clé.

key \"id\" for array with keys \"0\" does not exist.

Appel d'une clé absente d'un tableau.

The CSRF token is invalid. Please try to resubmit the form

Cela peut arriver quand la session expire pendant qu'un formulaire est rempli, ou bien qu'un formulaire soit particulièrement long à être rempli.

Sur Symfony on peut changer la durée des sessions avec framework.session.cookie_lifetime:
Sinon dans php.ini : session.cookie_lifetime
Mais pour éviter ça dans un seul formulaire, on peut lui ajouter la ligne :

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            ...
            'csrf_protection' => false,
        ]);
    }

unexpected token "punctuation" of value "{"

Au choix :

Ajouter les apostrophes aux clés du tableau concerné.
Ajouter des parenthèses à ses expressions.
Remplacer les accolades par des crochets pour le premier niveau.

xmlParseEntityRef: no name

Un "&" n'est pas échappé en XML. Il faut ajouter un filtre "| escape" en Twig pour le faire.

PhpStorm

Les logs sont accessibles par :

tail -f ~/.PhpStorm2019.2/system/log/idea.log

Certains dossiers sont rouges (exclus) dans la navigation et l'indexation, alors qu'ils ne sont pas censés l'être

Fermer le projet, supprimer le .idea, et le rouvrir.

Impossible de CTRL + clic dans un .twig (chemin introuvable)

Vérifier que le plugin Symfony de PhpStorm est bien installé et activé.

Si cela persiste, dans File\Settings\PHP\Symfony\Twig \ Template, ajouter le chemin vers les .twig importés du bundle concerné.

L'historique Git d'un dossier est tronqué

Si git log . montre plus de commits que le clic droit / Git / Show history, alors cliquer sur Files / Invalidate Caches, et tout cocher.

Si cela ne fonctionne pas après redémarrage, et que le projet fait partie d'un groupe de projets ouverts, le fermer (clic droit dessus et "Remove from project view"), puis le rouvrir.

Dans l'onglet Git, on ne voit pas la liste des fichiers modifiés

Dans Settings, Version Control, Commit, décocher "Use non-modal commit interface".

Un fichier a disparu des onglets, a un icône de point d'interrogation, et ne peut être rouvert

Il n'est pas ou plus associé à un type de fichier, aller dans File\Associate with File Type.

incoming connection from xdebug

Lors d'une erreur au remplissage de cette pop-up, on peut la corriger dans .idea/workspace.xml.

No differences files that files have differences only in line separators

Les scripts lancés depuis PhpStorm sous Windows modifient les retours à la ligne (CLRF to LF).

Changer l'option dans Settings/Preferences | Editor | Code Style | Line separator^[24] vers "System dependent".

Sinon, configurer git :

git config --global core.autocrlf true

Undefined class xxx

Une classe existe mais PhpStorm ne la voit pas : ajouter son dossier dans File\Settings\Directories, retirer l'exclusion (rouge) du dossier concerné.

Xdebug

Des logs Xdebug sont ajoutables dans le fichier php.ini :

xdebug.remote_log = /var/www/xdebug.log
xdebug.show_error_trace = 1
; Profiling (enable via cookie or GET/POST variable: XDEBUG_PROFILE=1).
xdebug.profiler_enable = 1
xdebug.profiler_enable_trigger = 0
xdebug.profiler_output_dir = /tmp/
; var_dump() settings.
xdebug.overload_var_dump = 1
xdebug.cli_color = 1

En CLI, la console s'ouvre sur default_prepend.php et on ne voit pas l'exécution de la commande

Cela se produit quand plusieurs projets sont ouverts dans PhpStorm et que la commande n'appartient pas au principal.

Le navigateur déclenche bien le débogage pas à pas, mais on ne voit pas le fichier PHP dans l'IDE

Il manque le mapping (par exemple avec les routes du conteneur). Par exemple dans PhpStorm, Servers, cocher "Use path mappings" et le renseigner.

Messages d'erreur

Cannot find file '/usr/local/php/php/auto_prepends/default_prepend.php' locally

Sous PhpStorm avec Docker, cliquer sous l'erreur pour modifier le path mapping.

Code coverage needs to be enabled in php.ini by setting 'xdebug.mode' to 'coverage'

Pour éviter d'éditer le .ini, on peut remplacer :

bin/phpunit --coverage-text

par :

php -dxdebug.mode=coverage bin/phpunit --coverage-text

Could not connect to client

Le serveur est introuvable, changer :

En V2, xdebug.remote_host ou remote_port.
En V3, xdebug.client_host ou xdebug.client_port.

Gateway Timeout

Cette erreur du navigateur généralement due au serveur Web.

Sur Apache, dans httpd.conf augmenter le nombre de secondes par défaut dans Timeout 60^[25].
Sur Nginx, augmenter fastcgi_read_timeout 60s;^[26].
Sur IIS, étendre la valeur du paramètre Activity Timeout des FastCGI Settings^[27].
Cela peut aussi provenir d'un load balancer en amont du serveur HTTP.

De plus, on peut aussi revoir les variables du fichier php.ini. Ex :

max_execution_time=30  # 30 s par défaut
max_input_time=-1      # Utilisera "max_execution_time" si -1, sinon la valeur indiquée

Failed to read FastCGI header

Si le log Apache affiche cela lors d'un Gateway Timeout, il faut ajouter à httpd.conf^[28] :

    ProxyTimeout 6000
    <IfModule mod_fcgi.c>
        FcgidProcessLifeTime 6000
        FcgidBusyTimeout 6000
        FcgidConnectTimeout 6000
        FcgidIdleTimeout 6000
        FcgidInitialEnv 6000
        FcgidIOTimeout 6000
        IdleTimeout 6000
        IPCConnectTimeout 6000
        IPCCommTimeout 6000
        IdleScanInterval 6000
    </IfModule>

Parfois il convient aussi de modifier le fichier php.ini^[29] :

opcache.optimization_level=0xFFFFFBFF
xdebug.remote_cookie_expire_time=6000

Enfin, sur PhpStorm on rencontre cela dans le cas de sous-requêtes qui dépassent la valeur du paramètre "Max. simultaneous connections".

No code coverage driver is available

Installer ou activer Xdebug. Il doit apparaitre ensuite dans php -v.

Remote file path 'default_prepend.php' is not mapped to any file path in project

Sous PhpStorm il faut décocher dans les settings, debug, les deux cases Force break..., puis de redémarrer l'IDE^[30].

Time-out connecting to client

Changer xdebug.remote_host ou xdebug.remote_port car le serveur existe mais n'écoute pas le port spécifié.

Si le navigateur ne déclenche plus le débogage sur l'IDE, alors que ce dernier écoute et que la clé du navigateur est bien définie, c'est peut-être le pare-feu qui bloque. Exemple de reset sur Linux avec iptables^[31] :

   iptables --policy INPUT   ACCEPT;
   iptables --policy OUTPUT  ACCEPT;
   iptables --policy FORWARD ACCEPT;
   iptables -Z; # zero counters
   iptables -F; # flush rules
   iptables -X; # delete all extra chains

Waiting for incoming connection with ide key 'xxx'

Xdebug peut marcher pour certains sites, sauf un qui ne déclenche rien dans l'IDE. Ce message apparait alors dans PhpStorm si on clique sur "Debug".

Vérifier le serveur et son port) associé à l'URL^[32].
Voir la page Programmation PHP/Xdebug.

GraphQL

Fields "maRoute" conflict because they have differing arguments. Use different aliases on the fields to fetch both if this was intentional.

Si on appelle plusieurs fois la même route dans la même requête, il faut définir des alias. Ex :

mutation {
    maRoute(...)
    aliasMaRoute: maRoute(...)
}

Le résultat de la requête sera donc un tableau avec ['data' => [[maRoute => ...], [aliasMaRoute => ...]].

Windows

imagecreatefromstring(): gd-png: libpng warning: Interlace handling should be turned on when using png_read_image

Remplacer le php_gd2.dll du PHP 7.4.33 par celui du 7.4.2 téléchargé depuis https://www.pconlife.com/viewfileinfo/php-gd2-dll/.

Exemple du chemin par défaut :

C:\wamp64\bin\php\php7.4.33\ext\

Références

GFDL

Vous avez la permission de copier, distribuer et/ou modifier ce document selon les termes de la licence de documentation libre GNU, version 1.2 ou plus récente publiée par la Free Software Foundation ; sans sections inaltérables, sans texte de première page de couverture et sans texte de dernière page de couverture.

[1] ttps://w3techs.com/technologies/details/pl-php

[2] ttps://www.web24.com.au/tutorials/features-of-php5

[3] ttps://www.php.net/manual/fr/migration70.new-features.php

[4] ttps://kinsta.com/fr/blog/php-8/

[5] ttps://php.developpez.com/actu/335682/PHP-8-2-est-disponible-en-beta-2-Cette-version-propose-null-true-et-false-en-tant-que-types-autonomes-ainsi-que-des-constantes-dans-les-traits/

[6] ttps://thecodingmachine.com/php-8-nouveautes-compatibilites-migration/

[7] ttps://stitcher.io/blog/new-in-php-82

[8] ttps://www.phparch.com/2023/08/whats-new-and-exciting-in-php-8-3/

[9] ttps://les-tilleuls.coop/blog/ce-quil-faut-retenir-des-nouveautes-de-php-8-4

[10] ttps://fr.siteground.com/blog/php-8-4/

[11] ttps://www.tecmint.com/connect-nginx-to-php-fpm/

[12] ttps://technet.microsoft.com/fr-fr/library/cc753077(v=ws.10).aspx

[13] ttp://blog.bobbyallen.me/2016/05/02/installing-php7-on-windows-server-2012-r2-and-iis-8/

[14] ttps://phpmanager.codeplex.com/

[15] ttps://www.microsoft.com/fr-fr/download/details.aspx?id=48145

[16] ttps://hub.docker.com/_/php

[17] ttps://itecnote.com/tecnote/php-installing-gd-extension-in-docker/

[18] ttps://www.octopuce.fr/debugger-php-en-cli-avec-xdebug-vim/

[19] ttps://curl.haxx.se/download.html

[20] ttps://getcomposer.org/doc/articles/versions.md

[21] ttps://igor.io/2013/02/07/composer-stability-flags.html

[22] ttps://getcomposer.org/doc/06-config.md

[23] ttps://coopernet.fr/formation/php/autoload

[24] ttps://getcomposer.org/doc/articles/scripts.md

[25] ttps://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/core/+/master/composer.json

[26] ttps://gist.github.com/chadrien/c90927ec2d160ffea9c4#gistcomment-2398281

[27] ttps://plugins.jetbrains.com/plugin/7294-editorconfig

[28] ttps://github.com/editorconfig/editorconfig/wiki/Projects-Using-EditorConfig

[29] ttps://plugins.jetbrains.com/plugin/7219-symfony-support

[30] ttp://wiki.netbeans.org

[31] ttps://eclipse.org/cdt/

[32] (anglais) http://pydev.org/

[33] ttps://code.visualstudio.com/docs/editor/versioncontrol

[34] ttps://marketplace.visualstudio.com/vscode

[35] ttp://php.net/manual/fr/control-structures.declare.php

[36] ttp://pear.php.net/manual/en/standards.sample.php

[37] ttp://www.phpascal.com/programmation-web/PHP/commentaire-php.html

[38] ttps://www.php.net/manual/fr/language.attributes.overview.php

[39] ttps://php.watch/versions/8.1/ReturnTypeWillChange

[40] ttp://php.net/manual/fr/features.commandline.options.php

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[1]

[2]

[3]

[4]

[1]

[1]

[2]

[1]

[2]

[1]

[1]

[2]

[3]

[4]

[1]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[1]

[2]

[3]

[1]

[2]

[3]

[4]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

[14]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[1]

[2]

[3]

[1]

[2]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

Wikimore

Programmation PHP/Version imprimable

Introduction

Historique

PHP 5

PHP 7

PHP 8

8.1

8.2

8.3

8.4

Sites Web statiques ou dynamiques

Possibilités

Références

Installer PHP

Principe

Unix / Linux

LAMP

Installation manuelle

Apache sur Debian / Ubuntu

Installer PHP

Mise à jour

Bibliothèques

Désinstaller PHP

Apache sur Gentoo

MySQL seul

APT

Variante

Sur Gentoo

Modules

Sites

Problème d'encodage d'Apache2

Encodage par défaut en Latin1 (ISO-8859-1)

Aucun encodage par défaut

Windows

Tout-en-un

Message d'erreur relatif à SSL

Installation manuelle

Installer Apache

Installer PHP

MySQL

Apache CGI ou module ?

IIS

Docker

PHP 7.4 FPM

IDE

vim

Références

Composer

Installation

Utilisation

init

create-project

require

Paramètres

install

update

show

depends

clear-cache

Syntaxe du composer.json

name

require

Stability Flag

require-dev

config

autoload

scripts

extra

conflict

repositories

Exemple complet

Changer de version de PHP

Références

PhpStorm

Installation

Configuration

Exclure les fichiers minifiés de l'indexation

Fonctionnalités

Refactorisation