Introducción a los métodos mágicos

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

Los métodos mágicos son métodos especiales en PHP que comienzan con dos guiones bajos (__) y PHP los llama automáticamente en respuesta a determinados eventos o acciones. Ya has usado dos de ellos: __construct() y __destruct().

Estos métodos te permiten conectarte al comportamiento interno de PHP y personalizar cómo responden tus objetos a las operaciones habituales.

Por ejemplo, ¿qué sucede cuando intentas imprimir un objeto? ¿O acceder a una propiedad que no existe? Los métodos mágicos te dan control sobre estas situaciones.

Aquí tienes un resumen rápido de los métodos mágicos más utilizados:

Método	Se activa cuando
`__construct()`	Se crea el objeto
`__destruct()`	Se destruye el objeto
`__toString()`	El objeto se utiliza como una cadena
`__get()`	Se accede a una propiedad no definida
`__set()`	Se establece una propiedad no definida
`__call()`	Se llama a un método no definido
`__clone()`	Se clona el objeto

<?php
class Book {
    public function __construct(
        private string $title
    ) {}
    
    public function __toString(): string {
        return "Book: " . $this->title;
    }
}

$book = new Book("PHP Mastery");
echo $book;

Salida:

Book: PHP Mastery

Sin __toString(), intentar mostrar un objeto con echo provocaría un error. El método mágico intercepta esta acción y devuelve en su lugar una representación en forma de cadena. En las próximas lecciones, exploraremos cada método mágico en detalle.

Desafío

Fácil

Construyamos un sistema de catálogo de películas que te introduzca a los métodos mágicos. Crearás una clase Movie que utiliza __construct() para inicializar los datos de la película y __toString() para proporcionar una representación de cadena limpia cuando se imprime el objeto.

Organizarás tu código en dos archivos:

Movie.php: Crea una clase Movie que represente las películas de tu catálogo. Usa la promoción del constructor para definir propiedades privadas para $title (cadena), $director (cadena) y $year (entero). Implementa el método mágico __toString() para devolver una cadena formateada: "[title] ([year]) - Directed by [director]". Esto permite que tus objetos de película se impriman directamente sin llamar a un método separado.
main.php: Incluye el archivo Movie. Recibirás tres entradas: el título de una película, el nombre de un director y un año de estreno. Crea una instancia de Movie usando estos valores (convierte el año en un entero). Después, simplemente imprime directamente el objeto de película: el método __toString() se llamará automáticamente para producir la salida.

La magia de __toString() es que PHP lo llama automáticamente cada vez que tu objeto se utiliza en un contexto de cadena. En lugar de escribir echo $movie->getInfo();, puedes escribir simplemente echo $movie; y PHP se encarga de la conversión por ti. Esto hace que trabajar con tus objetos sea más intuitivo.

Pruébalo tú mismo

<?php

require_once 'Movie.php';

// Leer entrada
$title = trim(fgets(STDIN));
$director = trim(fgets(STDIN));
$year = intval(fgets(STDIN));

// TODO: Crea una instancia de Movie usando los valores de entrada

// TODO: Haz echo del objeto movie directamente (el método __toString() se llamará automáticamente)

?>