Menu
CoddyTech

Propriétés en lecture seule (PHP 8.1)

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

PHP 8.1 a introduit les propriétés readonly, qui ne peuvent être assignées qu’une seule fois et ne peuvent pas être modifiées par la suite. Contrairement aux constantes, les propriétés en lecture seule sont définies lors de l’initialisation de l’objet plutôt qu’au moment de la définition de la classe.

Tu déclares une propriété en lecture seule en ajoutant le mot-clé readonly avant la déclaration du type :

<?php
class User {
    public readonly string $id;
    public readonly string $name;
    
    public function __construct(string $id, string $name) {
        $this->id = $id;
        $this->name = $name;
    }
}

$user = new User("U001", "Alice");
echo $user->id . "\n";
echo $user->name;

Sortie :

U001
Alice

Une fois attribuée, toute tentative de modification d’une propriété en lecture seule provoquera une erreur. Ces propriétés sont donc idéales pour les valeurs qui doivent rester constantes pendant toute la durée de vie d’un objet, comme les identifiants ou les horodatages de création.

Les propriétés en lecture seule doivent avoir une déclaration de type et ne peuvent être affectées qu’une seule fois, depuis la classe qui les déclare (généralement dans le constructeur). Contrairement aux propriétés normales, elles ne peuvent pas recevoir de valeur par défaut lors de leur déclaration. Elles fonctionnent avec n’importe quel modificateur de visibilité :

<?php
class Product {
    public function __construct(
        public readonly string $sku,
        private readonly float $cost
    ) {}
    
    public function getCost(): float {
        return $this->cost;
    }
}

$product = new Product("ABC123", 29.99);
echo $product->sku;

Résultat :

ABC123

Point clé : Les propriétés en lecture seule assurent l’immuabilité au niveau des propriétés. Elles sont idéales pour les données qui identifient un objet ou qui ne devraient pas changer après sa création, car elles combinent la flexibilité de l’initialisation à l’exécution et la sécurité offerte par la prévention des modifications accidentelles.

challenge icon

Défi

Facile

Construisons un système de configuration immuable qui utilise des propriétés en lecture seule pour garantir que les paramètres critiques ne peuvent pas être modifiés accidentellement après l’initialisation.

Tu vas créer deux fichiers qui fonctionnent ensemble pour gérer la configuration de l’application :

  • Config.php : définis une classe Config qui représente la configuration de l’application avec des paramètres immuables. La classe doit avoir trois propriétés publiques en lecture seule : string $appName, string $version et int $maxConnections. Utilise la promotion du constructeur pour déclarer et initialiser les trois propriétés en lecture seule dans une seule définition de constructeur concise. Ajoute une méthode getInfo() qui renvoie une chaîne au format "[appName] v[version] (max: [maxConnections] connections)".
  • main.php : inclus le fichier de la classe Config. Tu recevras trois entrées : le nom de l’application, la version et le nombre maximal de connexions (sous forme de chaîne à convertir en entier). Crée un objet Config à l’aide de ces valeurs. Affiche le résultat de getInfo() sur la première ligne. Affiche ensuite chaque propriété en lecture seule sur sa propre ligne en y accédant directement : le nom de l’application, la version et le nombre maximal de connexions.

Les propriétés en lecture seule garantissent qu’une fois la configuration créée, ses valeurs restent fixes ; elles sont donc parfaites pour les paramètres qui doivent rester constants pendant toute l’exécution de ton application. Remarque comme l’association de la promotion du constructeur et des propriétés en lecture seule permet de définir des objets-valeurs immuables de façon très concise.

Ta sortie doit afficher la chaîne d’information mise en forme, suivie de la valeur de chaque propriété, démontrant ainsi que les propriétés en lecture seule restent accessibles depuis l’extérieur de la classe.

Essayez vous-même

<?php

require_once 'Config.php';

// Lire les entrées
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));

// TODO: Créer un objet Config à partir des valeurs saisies

// TODO: Afficher le résultat de getInfo()

// TODO: Afficher chaque propriété readonly sur sa propre ligne :
// - nom de l’application
// - version
// - nombre maximal de connexions

?>
quiz iconTestez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

Toutes les leçons de Programmation Orientée Objet

Entraînez-vous par vous-même : Compilateur PHP en ligne