pharaonic / laravel-deep-replicate

13.0.0 2026-11-12 13:23 UTC

Requires

• php: >=8.3 <8.6
• illuminate/container: ^13.0
• illuminate/contracts: ^13.0
• illuminate/database: ^13.0
• illuminate/support: ^13.0

Requires (Dev)

• laravel/pint: ^1.20
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• phpstan/phpstan: ^2.1.33
• phpunit/phpunit: ^12.5.8

MIT

• Moamen Eltouny (Raggi)

• laravel
• Relationships
• eloquent
• clone
• duplicate
• replicate
• pharaonic
• deep replicate

Published on Packagist.org on 2026-11-12 13:26 UTC

README

Replicate a chosen Eloquent relationship graph into new records, with explicit copy, reuse and skip rules.

Installation

composer require pharaonic/laravel-deep-replicate

The service provider and the DeepReplicate facade are registered automatically. There is nothing to publish or migrate.

Usage

use Pharaonic\Laravel\DeepReplicate\Facades\DeepReplicate;

$result = DeepReplicate::for($order)
    ->copy('items', 'items.options')   // new items and options for the new order
    ->reuse('items.product', 'customer') // link to the existing products and customer
    ->skip('payments')
    ->with(['status' => 'draft'])
    ->replicate();                      // one transaction

$copy = $result->model();               // the new, persisted order
$result->map()->get($oldItem);          // the copy of an original item
$result->stats()->copiedModels();       // root + items + options

Or add the trait to the model and start from the model itself; it returns the same builder:

use Pharaonic\Laravel\DeepReplicate\Concerns\DeepReplicates;

class Order extends Model
{
    use DeepReplicates;
}

$result = $order->deepReplicate('items', 'items.options')
    ->reuse('items.product', 'customer')
    ->replicate();

Laravel's own replicate() is untouched. At least one relation must always be selected.

Documentation

Full documentation: Deep Replicate Documentation.

Support & Security

See SUPPORT.md and SECURITY.md. Contributions are welcome; see CONTRIBUTING.md.

License

MIT. See LICENSE.