Getters y Setters

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy — lección 40 de 91.

Ahora que entiendes los modificadores de acceso, ¿cómo interactúas de forma segura con las propiedades privadas desde fuera de la clase? La respuesta son los getters y setters: métodos públicos que proporcionan un acceso controlado a los datos privados.

Un getter obtiene el valor de una propiedad, mientras que un setter lo modifica. Este patrón le permite añadir validación o lógica cuando se accede a los datos o se cambian:

<?php
class User {
    private string $email;
    private int $age;
    
    public function getEmail(): string {
        return $this->email;
    }
    
    public function setEmail(string $email): void {
        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
            $this->email = $email;
        }
    }
    
    public function getAge(): int {
        return $this->age;
    }
    
    public function setAge(int $age): void {
        if ($age >= 0 && $age <= 150) {
            $this->age = $age;
        }
    }
}

$user = new User();
$user->setEmail("john@example.com");
$user->setAge(25);

echo $user->getEmail() . "\n";
echo $user->getAge();

Salida:

john@example.com
25

El setter valida el formato del correo electrónico y asegura que la edad sea razonable antes de almacenar los valores. Sin setters, cualquiera podría asignar datos inválidos directamente. También puedes crear propiedades de solo lectura proporcionando solo un getter, o propiedades de solo escritura con solo un setter.

Punto clave: Los getters y setters te dan control sobre cómo se accede y se modifican los datos privados, permitiendo la validación, el formateo o cualquier lógica personalizada.

Desafío

Fácil

Vamos a construir un sistema de inventario de productos que utiliza getters y setters para proteger y validar los datos del producto. Crearás una clase Product que asegure que los precios sean siempre positivos y las cantidades de stock nunca sean negativas — demostrando cómo los setters pueden imponer reglas de negocio.

Organizarás tu código en dos archivos:

Product.php — Crea una clase Product con tres propiedades privadas: $name (string), $price (float), y $stock (integer). Implementa getters y setters para cada propiedad con las siguientes reglas de validación:
- setName() solo debe aceptar cadenas no vacías — si la cadena está vacía después de recortar los espacios (trimming), no actualices la propiedad
- setPrice() solo debe aceptar valores mayores que 0 — rechaza precios de cero o negativos
- setStock() solo debe aceptar valores de 0 o mayores — rechaza cantidades de stock negativas
Cada getter debe simplemente devolver el valor de la propiedad correspondiente. Añade un método público getInfo() que devuelva "[name]: $[price] ([stock] in stock)" con el precio formateado a 2 decimales.
main.php — Incluye el archivo Product. Recibirás cuatro entradas: un nombre de producto, un precio, una cantidad de stock y un nuevo precio para actualizar. Crea una instancia de Product y usa los setters para asignar el nombre inicial, el precio (convertido a float) y el stock (convertido a integer). Imprime el resultado de getInfo(). Luego intenta actualizar el precio con el nuevo valor de precio (convertido a float) e imprime getInfo() de nuevo. Finalmente, intenta establecer el stock a -5 (un valor inválido) e imprime getInfo() una vez más para confirmar que el stock no fue cambiado.

Tus setters actúan como guardianes — validan los datos entrantes antes de permitir cambios en las propiedades privadas. Cuando se pasan datos inválidos (como un stock negativo), el setter simplemente los ignora, manteniendo intacto el valor válido existente. Este es el poder de la encapsulación: tu objeto mantiene su integridad independientemente de lo que el código externo intente hacer.

Hoja de referencia

Usa getters y setters para proporcionar un acceso controlado a las propiedades privadas. Un getter recupera un valor, mientras que un setter lo modifica con una validación opcional:

<?php
class User {
    private string $email;
    private int $age;
    
    public function getEmail(): string {
        return $this->email;
    }
    
    public function setEmail(string $email): void {
        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
            $this->email = $email;
        }
    }
    
    public function getAge(): int {
        return $this->age;
    }
    
    public function setAge(int $age): void {
        if ($age >= 0 && $age <= 150) {
            $this->age = $age;
        }
    }
}

$user = new User();
$user->setEmail("john@example.com");
$user->setAge(25);

echo $user->getEmail(); // john@example.com
echo $user->getAge(); // 25

Los setters pueden validar los datos antes de almacenarlos. Si la validación falla, el setter puede ignorar la actualización, manteniendo intacto el valor existente. Puedes crear propiedades de solo lectura proporcionando únicamente un getter, o propiedades de solo escritura con solo un setter.

Pruébalo tú mismo

<?php
require_once 'Product.php';

// Leer entradas
$name = trim(fgets(STDIN));
$price = trim(fgets(STDIN));
$stock = trim(fgets(STDIN));
$newPrice = trim(fgets(STDIN));

// TODO: Crear una nueva instancia de Product

// TODO: Usar setters para asignar el nombre inicial, el precio (como float) y el stock (como entero)

// TODO: Imprimir el resultado de getInfo()

// TODO: Actualizar el precio con newPrice (como float) e imprimir getInfo() de nuevo

// TODO: Intentar establecer el stock a -5 (inválido) e imprimir getInfo() para confirmar que el stock no cambió

?>