PHP · FICHE DE RÉVISION
7 · Propriétés promues et hooks
Réduire le code répétitif sans perdre la validation ni oublier les versions de PHP.
Promotion : déclarer et initialiser ensemble
Depuis PHP 8.0, un paramètre du constructeur précédé de public, protected ou private devient une propriété. PHP déclare cette propriété et y affecte l’argument. Sans visibilité, il reste un paramètre ordinaire.
<?php
declare(strict_types=1);
class Auteur
{
public function __construct(private string $nom) {}
public function getNom(): string
{
return $this->nom;
}
}
echo (new Auteur('Camille'))->getNom(), PHP_EOL;La promotion remplace la déclaration du champ et l’affectation dans le constructeur ; elle n’ajoute aucune validation automatique. Ne pas redéclarer ailleurs une propriété du même nom.
Hooks : contrôler lecture et écriture
PHP 8.4 minimum. Un hook get personnalise la lecture ; un hook set personnalise l’affectation. Cela peut préserver une règle métier même si l’accès s’écrit comme une propriété publique. Sur PHP 8.2 ou 8.3, conserver des getters et méthodes de modification classiques.
<?php
declare(strict_types=1);
class Etiquette
{
public string $nom {
get => $this->nom;
set(string $value) {
$nom = trim($value);
if ($nom === '') {
throw new InvalidArgumentException('Nom obligatoire');
}
$this->nom = $nom;
}
}
public function __construct(string $nom)
{
$this->nom = $nom;
}
}
$etiquette = new Etiquette(' POO ');
echo $etiquette->nom, PHP_EOL;
try {
$etiquette->nom = ' ';
} catch (InvalidArgumentException $erreur) {
echo $erreur->getMessage(), PHP_EOL;
}L’écriture du constructeur déclenche aussi le hook. Dans le hook associé à nom, l’accès direct à $this->nom vise la valeur stockée sans rappeler ce même hook indéfiniment. L’objet ne conserve que le nom validé et nettoyé.
Stockage, calcul et encapsulation
Une propriété stockée utilise sa propre valeur dans un hook. Une propriété virtuelle calcule son résultat à partir d’autre chose et n’a pas de stockage propre. Une propriété virtuelle avec seulement un get n’accepte pas l’écriture.
On peut écrire les hooks sur une propriété promue dans le constructeur, mais cela peut alourdir sa signature : préférer ici une déclaration séparée pour lire plus facilement la validation. Les hooks ne se combinent pas avec readonly ; la visibilité asymétrique est un autre outil lorsque lecture et écriture doivent avoir des accès distincts.
Pièges et entraînement
La version requise concerne les exemples à exécuter, pas le simple affichage de la fiche : le code présenté reste du texte dans le site.
Une propriété publique avec un set validant un nom vide casse-t-elle forcément l’encapsulation ?
Non. L’encapsulation consiste à préserver les règles de l’objet. Le hook peut contrôler chaque affectation, comme une méthode de modification.
La promotion est-elle disponible seulement à partir de PHP 8.4 ?
Non : promotion depuis PHP 8.0 ; hooks depuis PHP 8.4. Ce sont deux fonctionnalités différentes qui peuvent se combiner.