Propiedades de solo lectura (PHP 8.1)

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy. Lección 19 de 91.

PHP 8.1 introdujo las propiedades readonly, que solo pueden asignarse una vez y no pueden modificarse después. A diferencia de las constantes, las propiedades readonly se establecen durante la inicialización del objeto en lugar de hacerlo en el momento de la definición de la clase.

Declaras una propiedad readonly agregando la palabra clave readonly antes de la declaración 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;

Salida:

U001
Alice

Una vez asignada, intentar cambiar una propiedad readonly provocará un error. Esto las hace perfectas para values que deberían permanecer constantes durante toda la vida útil de un object, como los identificadores o las marcas de tiempo de creación.

Las properties readonly deben tener una declaración de tipo y solo pueden asignarse una vez, desde dentro de la class que las declara (normalmente en el constructor). A diferencia de las properties normales, no se les puede asignar un valor predeterminado en la declaración. Funcionan con cualquier modificador de visibilidad:

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

Salida:

ABC123

Punto clave: Las properties de solo lectura proporcionan inmutabilidad a nivel de la propiedad. Son ideales para datos que identifican un object o que no deberían cambiar después de su creación, combinando la flexibilidad de la inicialización en tiempo de ejecución con la seguridad de evitar modificaciones accidentales.

Desafío

Fácil

Construyamos un sistema de configuración inmutable que use propiedades readonly para garantizar que las configuraciones críticas no puedan cambiarse accidentalmente después de la inicialización.

Crearás dos archivos que trabajarán juntos para gestionar la configuración de la aplicación:

Config.php: Define una clase Config que represente la configuración de la aplicación con ajustes inmutables. La clase debe tener tres propiedades public readonly: string $appName, string $version y int $maxConnections. Usa la promoción del constructor para declarar e inicializar las tres propiedades readonly en una única definición de constructor clara y concisa. Añade un método getInfo() que devuelva una cadena con el formato "[appName] v[version] (max: [maxConnections] connections)".
main.php: Incluye el archivo de la clase Config. Recibirás tres entradas: el nombre de la aplicación, la versión y el número máximo de conexiones (como una cadena que debe convertirse en un entero). Crea un objeto Config usando estos valores. Imprime el resultado de getInfo() en la primera línea. Después, imprime cada propiedad readonly en su propia línea accediendo directamente a ellas: el nombre de la aplicación, la versión y el número máximo de conexiones.

Las propiedades readonly garantizan que, una vez creada una configuración, sus valores queden fijados, lo que resulta perfecto para ajustes que deben permanecer constantes durante toda la ejecución de tu aplicación. Observa cómo la promoción del constructor, combinada con readonly, crea una forma muy concisa de definir objetos de valor inmutables.

Tu salida debe mostrar la cadena de información formateada seguida de cada valor de propiedad individual, demostrando que las propiedades readonly aún pueden leerse desde fuera de la clase.

FORMATO DE SALIDA REQUERIDO: [Tu contenido traducido aquí]

Pruébalo tú mismo

<?php

require_once 'Config.php';

// Leer entradas
$appName = trim(fgets(STDIN));
$version = trim(fgets(STDIN));
$maxConnections = intval(trim(fgets(STDIN)));

// TODO: Crear un objeto Config usando los valores de entrada

// TODO: Imprimir el resultado de getInfo()

// TODO: Imprimir cada propiedad de solo lectura en su propia línea:
// - nombre de la app
// - versión
// - conexiones máximas

?>