Visibilité et encapsulation

Le problème : tout est ouvert

À la leçon 1, $solde était public. Donc n'importe où dans le code : $compte->solde = 999999;, on contourne deposer() et ses règles. C'est précisément l'encapsulation (vue dans le cours POO) qu'il faut appliquer ici, avec les mots-clés de visibilité de PHP.

public, private, protected

• public : accessible de partout (l'interface de l'objet).
• private : accessible uniquement à l'intérieur de la classe. C'est le coffre-fort.
• protected : comme private, mais aussi accessible dans les classes filles (utile avec l'héritage, prochaine leçon).

On met les données en private par défaut, et on n'expose en public que les méthodes nécessaires.

class Compte {
    private float $solde = 0;          // verrouillé

    public function deposer(float $m): void {
        if ($m > 0) $this->solde += $m;  // la règle vit ici
    }
    public function getSolde(): float {  // accesseur en lecture seule
        return $this->solde;
    }
}

$c = new Compte();
$c->deposer(50);
echo $c->getSolde();   // 50
// $c->solde = 999999;  // ❌ Fatal error: Cannot access private property

Tenter $c->solde depuis l'extérieur déclenche une erreur fatale : PHP refuse. La seule voie, c'est deposer(), qui impose ses règles. Un solde incohérent devient impossible.

Getters et setters

Pour exposer une donnée privée de façon contrôlée : un getter (lire) et, si besoin, un setter (écrire avec validation). Le setter est l'occasion de refuser une valeur invalide.

class Produit {
    private float $prix = 0;

    public function getPrix(): float { return $this->prix; }

    public function setPrix(float $prix): void {
        if ($prix < 0) {
            throw new InvalidArgumentException("Prix négatif interdit");
        }
        $this->prix = $prix;
    }
}

La capsule en vrai (exécute)

Un compte qui protège son solde. La voie normale marche ; la règle (pas de retrait à découvert) est imposée par la méthode.

<?php
class Compte {
    private float $solde = 0;

    public function deposer(float $m): void {
        if ($m > 0) $this->solde += $m;
    }
    public function retirer(float $m): bool {
        if ($m > 0 && $m <= $this->solde) {
            $this->solde -= $m;
            return true;
        }
        return false;   // règle : pas de découvert
    }
    public function getSolde(): float { return $this->solde; }
}

$c = new Compte();
$c->deposer(100);
var_dump($c->retirer(30));    // bool(true)  → solde 70
var_dump($c->retirer(99999)); // bool(false) → refusé
echo "Solde final : " . $c->getSolde() . " €\n";
?>

Les propriétés readonly : verrouiller après création

Parfois une valeur ne doit jamais changer après la création de l'objet : un identifiant de commande, une date de création, un montant figé. Avec une propriété public classique, n'importe qui peut la réécrire ; même avec un getter, l'objet pourrait se modifier lui-même par erreur. private protège de l'extérieur, mais pas d'une affectation accidentelle dans une autre méthode interne.

PHP 8.1 introduit le mot-clé readonly. Une propriété public readonly string $id ne peut être affectée qu'une seule fois (typiquement dans le constructeur). Toute tentative de modification ultérieure provoque une Error : Cannot modify readonly property. Cela vaut de l'extérieur comme de l'intérieur de la classe.

Deux précisions importantes :

• readonly exige que la propriété soit typée (ex. string, int, float).
• Elle se marie parfaitement avec la promotion de constructeur : public function __construct(public readonly string $id) {} déclare et fige la propriété en une seule ligne. C'est la base des value objects immuables.

<?php
class Commande {
    public readonly string $id;
    public readonly string $createdAt;
    private float $montant;

    public function __construct(string $id, float $montant) {
        $this->id        = $id;
        $this->createdAt = date("Y-m-d");
        $this->montant   = $montant;
    }

    public function getMontant(): float {
        return $this->montant;
    }
}

$cmd = new Commande("ORD-001", 49.90);
echo $cmd->id . "\n";           // ORD-001 (lecture OK)
echo $cmd->createdAt . "\n";   // date du jour
echo $cmd->getMontant() . "\n"; // 49.9

// $cmd->id = "ORD-HACK"; // Error: Cannot modify readonly property
echo "Propriete readonly : lecture seule apres construction.\n";
?>