Promotion des constructeurs (8.0)

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 42 sur 91.

PHP 8.0 a introduit la promotion des propriétés dans le constructeur, une fonctionnalité qui réduit considérablement le code répétitif lors de la définition des classes. Au lieu de déclarer les propriétés séparément, puis de leur affecter des valeurs dans le constructeur, vous pouvez effectuer les deux opérations en une seule étape.

Voici l’approche traditionnelle que tu as utilisée :

<?php
class Product {
    private string $name;
    private float $price;
    
    public function __construct(string $name, float $price) {
        $this->name = $name;
        $this->price = $price;
    }
    
    public function getInfo(): string {
        return $this->name . ": $" . $this->price;
    }
}

Avec la promotion du constructeur, vous ajoutez le modificateur d’accès directement aux paramètres du constructeur :

<?php
class Product {
    public function __construct(
        private string $name,
        private float $price
    ) {}
    
    public function getInfo(): string {
        return $this->name . ": $" . $this->price;
    }
}

$product = new Product("Laptop", 999.99);
echo $product->getInfo();

Sortie :

Laptop: $999.99

En ajoutant private, protected ou public avant un paramètre du constructeur, PHP crée automatiquement la propriété et lui attribue la valeur. Tu peux mélanger des paramètres promus et réguliers dans le même constructeur, et tu peux toujours ajouter de la logique dans le corps du constructeur si nécessaire.

Point clé : La promotion des constructeurs élimine les déclarations et affectations de propriétés répétitives, ce qui rend vos classes plus propres et plus faciles à lire tout en conservant un contrôle total de l’encapsulation.

Défi

Facile

Construisons un système de gestion des contacts qui met en valeur l’élégance de la promotion du constructeur. Tu vas créer une classe PHP propre et moderne qui élimine le code répétitif tout en maintenant un encapsulation appropriée.

Tu organiseras ton code sur deux fichiers :

Contact.php : crée une classe Contact en utilisant la promotion du constructeur pour définir toutes les propriétés directement dans la signature du constructeur. Ton contact doit avoir :
- une propriété privée $name (chaîne de caractères)
- une propriété privée $email (chaîne de caractères)
- une propriété privée $phone (chaîne de caractères) avec la valeur par défaut "Not provided"
Utilise la syntaxe de promotion du constructeur : aucune déclaration de propriété séparée n’est nécessaire ! Ajoute une méthode publique getFullDetails() qui renvoie "[name] | [email] | [phone]". Ajoute également une méthode getSummary() qui renvoie "Contact: [name]".
main.php : inclus le fichier Contact. Tu recevras trois entrées : un nom, une adresse e-mail et un numéro de téléphone. Crée deux instances de Contact :
- le premier contact doit utiliser les trois valeurs (nom, adresse e-mail et téléphone)
- le deuxième contact doit utiliser uniquement le nom et l’adresse e-mail (en utilisant la valeur de téléphone par défaut)
Affiche quatre lignes :
- les détails complets du premier contact
- le résumé du premier contact
- les détails complets du deuxième contact
- le résumé du deuxième contact

Remarque comment la promotion du constructeur te permet de définir les propriétés, de définir leur visibilité, de déclarer leurs types et d’attribuer des valeurs : le tout dans une seule signature de constructeur lisible. Le paramètre de téléphone facultatif avec une valeur par défaut montre que les paramètres promus fonctionnent parfaitement avec les valeurs par défaut, tout comme les paramètres ordinaires.

Essayez vous-même

<?php

require_once 'Contact.php';

// Lire l'entrée
$name = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$phone = trim(fgets(STDIN));

// TODO: Créer le premier contact avec les trois valeurs (name, email, phone)

// TODO: Créer le second contact avec seulement name et email (utiliser phone par défaut)

// TODO: Afficher les détails complets du premier contact

// TODO: Afficher le résumé du premier contact

// TODO: Afficher les détails complets du second contact

// TODO: Afficher le résumé du second contact

?>