Approfondissement du clonage d’objets

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 61 sur 91.

Vous avez découvert la méthode magique __clone plus tôt dans ce cours. Explorons maintenant la différence cruciale entre le clonage superficiel et le clonage profond lorsque des objets contiennent d’autres objets en tant que propriétés.

Par défaut, PHP effectue une copie superficielle lors du clonage. Les valeurs scalaires sont dupliquées, mais les propriétés des objets restent des références vers les mêmes objets :

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

Sortie :

Alice - London

Notez que la modification de $clone->name n’a pas affecté l’original, mais que la modification de la ville de l’adresse, si ! Les deux objets partagent la même instance Address.

Pour créer une copie profonde où les objets imbriqués sont également clonés, implémentez __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;

Sortie :

Paris

Désormais, chaque Person possède sa propre Address indépendante. Lorsque vos objets contiennent plusieurs objets imbriqués, vous devez cloner chacun d’eux dans __clone afin d’obtenir une véritable indépendance entre l’original et la copie.

Défi

Facile

Construisons un système de gestion de documents qui démontre la différence entre le clonage superficiel et le clonage profond. Vous créerez des documents contenant des informations sur leur auteur et vous vous assurerez que le clonage d’un document crée une copie véritablement indépendante.

Vous organiserez votre code sur trois fichiers :

Author.php : créez une classe Author qui représente l’auteur d’un document. Utilisez la promotion des propriétés du constructeur pour définir une propriété publique $name (string) et une propriété publique $email (string).
Document.php : créez une classe Document qui contient un auteur. Incluez le fichier Author. La classe doit :
- utiliser la promotion des propriétés du constructeur pour une propriété publique $title (string) et une propriété publique $author (Author) ;
- implémenter la méthode magique __clone() afin d’effectuer un clonage profond : lorsqu’un document est cloné, son auteur doit également être cloné, afin que les modifications apportées à l’auteur du clone n’affectent pas l’original ;
- disposer d’une méthode getInfo() qui renvoie "[title] by [author name] ([author email])".
main.php : incluez le fichier Document. Vous recevrez trois entrées : le titre d’un document, le nom d’un auteur et l’adresse e-mail d’un auteur.
Créez un Document avec un Author en utilisant les entrées fournies. Clonez le document, puis modifiez le nom de l’auteur du clone en lui ajoutant " (Copy)" et modifiez le titre du clone en lui ajoutant "Copy of " au début.

Affichez deux lignes :
- les informations du document original ;
- les informations du document cloné.
Si votre clonage profond est correctement implémenté, l’auteur du document original doit rester inchangé, même après la modification de l’auteur du clone.

Ce défi démontre pourquoi le clonage profond est important : sans implémentation correcte de __clone(), les deux documents partageraient le même objet Author, et la modification de l’un affecterait l’autre.

Essayez vous-même

<?php

require_once 'Document.php';

// Lire les entrées
$title = trim(fgets(STDIN));
$authorName = trim(fgets(STDIN));
$authorEmail = trim(fgets(STDIN));

// TODO: Créer un Author avec le nom et l'email fournis

// TODO: Créer un Document avec le titre fourni et l'Author

// TODO: Cloner le document

// TODO: Modifier le nom de l'auteur du clone en y ajoutant " (Copy)"

// TODO: Modifier le titre du clone en y préfixant "Copy of "

// TODO: Afficher les infos du document original

// TODO: Afficher les infos du document cloné

?>