Análisis profundo de la clonación de objetos

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

Aprendiste sobre el método mágico __clone anteriormente en este curso. Ahora exploremos la diferencia fundamental entre la clonación superficial y la profunda cuando los objetos contienen otros objetos como propiedades.

De forma predeterminada, PHP realiza una copia superficial al clonar. Los valores escalares se duplican, pero las propiedades de los objetos permanecen como referencias a los mismos objetos:

<?php
class Address {
    public function __construct(public string $city) {}
}

class Person {
    public function __construct(
        public string $name,
        public Address $address
    ) {}
}

$original = new Person("Alice", new Address("Paris"));
$clone = clone $original;

$clone->name = "Bob";
$clone->address->city = "London";

echo $original->name . " - " . $original->address->city;

Salida:

Alice - London

Observa que cambiar $clone->name no afectó al original, ¡pero cambiar la ciudad de la dirección sí! Ambos objetos comparten la misma instancia de Address.

Para crear una copia profunda en la que los objetos anidados también se clonen, implementa __clone:

<?php
class Person {
    public function __construct(
        public string $name,
        public Address $address
    ) {}
    
    public function __clone(): void {
        $this->address = clone $this->address;
    }
}

$original = new Person("Alice", new Address("Paris"));
$clone = clone $original;
$clone->address->city = "London";

echo $original->address->city;

Salida:

Paris

Ahora cada Person tiene su propio Address independiente. Cuando tus objetos contienen varios objetos anidados, debes clonar cada uno en __clone para lograr una verdadera independencia entre el objeto original y la copia.

Desafío

Fácil

Construyamos un sistema de gestión de documentos que demuestre la diferencia entre la clonación superficial y la clonación profunda. Crearás documentos que contengan información del autor y te asegurarás de que clonar un documento cree una copia verdaderamente independiente.

Organizarás tu código en tres archivos:

Author.php: Crea una clase Author que represente al autor de un documento. Usa la promoción del constructor para definir un $name público (string) y un $email público (string).
Document.php: Crea una clase Document que contenga un autor. Incluye el archivo de Author. La clase debe:
- Usar la promoción del constructor para un $title público (string) y un $author público (Author)
- Implementar el método mágico __clone() para realizar una clonación profunda; cuando se clone un documento, su autor también debe clonarse, de modo que los cambios realizados en el autor de la copia no afecten al original
- Tener un método getInfo() que devuelva "[title] by [author name] ([author email])"
main.php: Incluye el archivo de Document. Recibirás tres entradas: el título de un documento, el nombre de un autor y el correo electrónico de un autor.
Crea un Document con un Author usando las entradas proporcionadas. Clona el documento, después modifica el nombre del autor de la copia añadiéndole " (Copy)" y cambia el título de la copia anteponiéndole "Copy of ".

Imprime dos líneas:
- La información del documento original
- La información del documento clonado
Si la clonación profunda está implementada correctamente, el autor del documento original debe permanecer sin cambios incluso después de modificar el autor de la copia.

Este desafío demuestra por qué es importante la clonación profunda: sin una implementación adecuada de __clone(), ambos documentos compartirían el mismo objeto Author y cambiar uno afectaría al otro.

Pruébalo tú mismo

<?php

require_once 'Document.php';

// Leer entradas
$title = trim(fgets(STDIN));
$authorName = trim(fgets(STDIN));
$authorEmail = trim(fgets(STDIN));

// TODO: Crear un Author con el nombre y el email proporcionados

// TODO: Crear un Document con el título proporcionado y el Author

// TODO: Clonar el documento

// TODO: Modificar el nombre del autor del clon añadiendo " (Copy)" a él

// TODO: Modificar el título del clon anteponiendo "Copy of " a él

// TODO: Imprimir la info del documento original

// TODO: Imprimir la info del documento clonado

?>