Proprietà readonly (PHP 8.1)

Fa parte della sezione Programmazione orientata agli oggetti del percorso PHP di Coddy. Lezione 19 di 91.

PHP 8.1 ha introdotto le proprietà readonly, a cui è possibile assegnare un valore una sola volta e che non possono essere modificate successivamente. A differenza delle costanti, le proprietà readonly vengono impostate durante l'inizializzazione dell'oggetto e non al momento della definizione della classe.

Dichiari una proprietà di sola lettura aggiungendo la parola chiave readonly prima della dichiarazione del tipo:

<?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;

Output:

U001
Alice

Una volta assegnata, provare a modificare una proprietà di sola lettura causerà un errore. Questo le rende perfette per valori che dovrebbero rimanere costanti per tutta la durata di un oggetto, come gli ID o i timestamp di creazione.

Le proprietà di sola lettura devono avere una dichiarazione di tipo e possono essere assegnate solo una volta, dall'interno della classe che le dichiara (in genere nel costruttore). A differenza delle proprietà normali, non possono ricevere un valore predefinito al momento della dichiarazione. Funzionano con qualsiasi modificatore di 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;

Output:

ABC123

Punto chiave: Le proprietà di sola lettura garantiscono l'immutabilità a livello di proprietà. Sono ideali per i dati che identificano un oggetto o che non dovrebbero cambiare dopo la creazione, combinando la flessibilità dell'inizializzazione a runtime con la sicurezza di impedire modifiche accidentali.

Sfida

Facile

Creiamo un sistema di configurazione immutabile che utilizza proprietà readonly per garantire che le impostazioni critiche non possano essere modificate accidentalmente dopo l'inizializzazione.

Creerai due file che collaborano per gestire la configurazione dell'applicazione:

Config.php: definisci una classe Config che rappresenta la configurazione dell'applicazione con impostazioni immutabili. La classe dovrebbe avere tre proprietà pubbliche readonly: string $appName, string $version e int $maxConnections. Usa la promozione del costruttore per dichiarare e inizializzare tutte e tre le proprietà readonly in un'unica definizione di costruttore concisa. Aggiungi un metodo getInfo() che restituisca una stringa nel formato "[appName] v[version] (max: [maxConnections] connections)".
main.php: includi il file della classe Config. Riceverai tre input: il nome dell'app, la versione e il numero massimo di connessioni (come stringa da convertire in un intero). Crea un oggetto Config usando questi valori. Stampa il risultato di getInfo() sulla prima riga. Poi stampa ogni proprietà readonly sulla propria riga, accedendovi direttamente: il nome dell'app, la versione e il numero massimo di connessioni.

Le proprietà readonly garantiscono che, una volta creata una configurazione, i suoi valori rimangano bloccati: sono perfette per impostazioni che dovrebbero restare costanti durante l'esecuzione dell'applicazione. Nota come la promozione del costruttore, combinata con readonly, permetta di definire oggetti valore immutabili in modo molto conciso.

L'output dovrebbe mostrare la stringa informativa formattata, seguita dal valore di ogni singola proprietà, dimostrando che è comunque possibile leggere le proprietà readonly dall'esterno della classe.

Provalo tu

<?php

require_once 'Config.php';

// Leggi i dati in input
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));

// TODO: Crea un oggetto Config usando i valori di input

// TODO: Stampa il risultato di getInfo()

// TODO: Stampa ogni proprietà readonly su una riga separata:
// - nome dell'app
// - versione
// - numero massimo di connessioni

?>