La creación de una copia de un objeto con exactamente las mismas propiedades no siempre es el comportamiento deseado. Un buen ejemplo para ilustrar la necesidad de un constructor de copia: si se tiene un objeto que representa una ventana GTK y el objeto contiene el recurso que representa esa ventana GTK, al crear una copia, se puede desear crear una nueva ventana con las mismas propiedades, pero que el nuevo objeto contenga un recurso que represente la nueva ventana.
Una copia de objeto se crea utilizando la palabra clave clone
(que invoca al método __clone()
del objeto, si ha sido definido).
<?php
$copy_of_object = clone $object;
?>
Cuando un objeto es clonado, PHP realiza una copia superficial de todas las propiedades del objeto. Todas las propiedades que son referencias a otras variables permanecerán como referencias.
Una vez realizada la clonación, si se ha definido un método __clone(), el método __clone() del nuevo objeto será llamado, para permitir que cada propiedad que deba ser modificada lo sea.
Ejemplo #1 Ejemplo de duplicación de objetos
<?php
class SubObject
{
static $instances = 0;
public $instance;
public function __construct() {
$this->instance = ++self::$instances;
}
public function __clone() {
$this->instance = ++self::$instances;
}
}
class MyCloneable
{
public $objet1;
public $objet2;
function __clone()
{
// Fuerza la copia de this->object, de lo contrario
// apuntará al mismo objeto.
$this->object1 = clone $this->object1;
}
}
$obj = new MyCloneable();
$obj->object1 = new SubObject();
$obj->object2 = new SubObject();
$obj2 = clone $obj;
print "Objeto original :\n";
print_r($obj);
print "Objeto clonado :\n";
print_r($obj2);
?>
El resultado del ejemplo sería:
Objeto original : MyCloneable Object ( [object1] => SubObject Object ( [instance] => 1 ) [object2] => SubObject Object ( [instance] => 2 ) ) Objeto clonado : MyCloneable Object ( [object1] => SubObject Object ( [instance] => 3 ) [object2] => SubObject Object ( [instance] => 2 ) )
Es posible acceder a un miembro de un objeto recién clonado en una sola expresión:
Ejemplo #2 Acceso a un miembro de un objeto recién clonado
<?php
$dateTime = new DateTime();
echo (clone $dateTime)->format('Y');
?>
El resultado del ejemplo sería algo similar a:
2016