Fork me on GitHub

    Copying Persisted Objects

    Propel provides the copy() method to perform copies of mapped row in the database. Note that Propel does not override the __clone() method; this allows you to create local duplicates of objects that map to the same persisted database row (should you need to do this).

    The copy() method by default performs shallow copies, meaning that any foreign key references will remain the same.

    <?php

$a = new Author();
$a->setFirstName("Aldous");
$a->setLastName("Huxley");

$p = new Publisher();
$p->setName("Harper");

$b = new Book();
$b->setTitle("Brave New World");
$b->setPublisher($p);
$b->setAuthor($a);

$b->save(); // so that auto-increment IDs are created

$bcopy = $b->copy();
var_export($bcopy->getId() == $b->getId()); // FALSE
var_export($bcopy->getAuthorId() == $b->getAuthorId()); // TRUE
var_export($bcopy->getAuthor() == $b->getAuthor()); // TRUE

    Deep Copies

    By calling copy() with a TRUE parameter, Propel will create a deep copy of the object; this means that any related objects will also be copied.

    To continue with example from above:

    <?php

$bdeep = $b->copy(true);
var_export($bcopy->getId() == $b->getId()); // FALSE
var_export($bcopy->getAuthorId() == $b->getAuthorId()); // FALSE
var_export($bcopy->getAuthor() == $b->getAuthor()); // FALSE

    Found a typo ? Something is wrong in this documentation ? Just fork and edit it !