Menu
CoddyTech

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, a las que solo se puede asignar un valor una vez y que no se pueden modificar después. A diferencia de las constantes, las propiedades de solo lectura se establecen durante la inicialización del objeto, no al definir la clase.

Declaras una propiedad de solo lectura añadiendo 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 asignado, intentar cambiar una propiedad de solo lectura provocará un error. Esto las hace perfectas para valores que deberían permanecer constantes durante toda la vida útil de un objeto, como los identificadores o las marcas de tiempo de creación.

Las propiedades de solo lectura deben tener una declaración de tipo y solo se les puede asignar un valor una vez, desde dentro de la clase que las declara (normalmente en el constructor). A diferencia de las propiedades 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 propiedades de solo lectura proporcionan inmutabilidad a nivel de propiedad. Son ideales para datos que identifican un objeto o que no deberían cambiar después de su creación, ya que combinan la flexibilidad de la inicialización en tiempo de ejecución con la seguridad de evitar modificaciones accidentales.

challenge icon

Desafío

Fácil

Vamos a crear un sistema de configuración inmutable que utilice propiedades de solo lectura para garantizar que los ajustes críticos no se puedan cambiar 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 representa la configuración de la aplicación con ajustes inmutables. La clase debe tener tres propiedades públicas de solo lectura: string $appName, string $version e int $maxConnections. Usa la promoción del constructor para declarar e inicializar las tres propiedades de solo lectura en una única definición de constructor clara. 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 con estos valores. Imprime el resultado de getInfo() en la primera línea. Después, imprime cada propiedad de solo lectura 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 de solo lectura garantizan que, una vez creada una configuración, sus valores queden fijados, lo que es perfecto para los ajustes que deben permanecer constantes durante todo el tiempo de ejecución de tu aplicación. Observa cómo la promoción del constructor, combinada con las propiedades de solo lectura, permite definir objetos de valor inmutables de forma muy concisa.

Tu salida debe mostrar la cadena de información con formato, seguida de cada valor de propiedad individual, lo que demuestra que las propiedades de solo lectura se pueden seguir leyendo desde fuera de la clase.

Pruébalo tú mismo

<?php

require_once 'Config.php';

// Leer las 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 readonly en su propia línea:
// - nombre de la aplicación
// - versión
// - conexiones máximas

?>
quiz iconPonte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Todas las lecciones de Programación Orientada a Objetos

Practica por tu cuenta: Compilador de PHP online