s3lp/piece-data

Pseudo replication Eloquent models via HTTP

0.9.4 2025-06-04 12:05 UTC

Requires

• ext-curl: *
• ext-json: *

Requires (Dev)

• orchestra/testbench: ^3.1

MIT

• sync
• laravel
• eloquent
• replication
• s3lp

README

Pseudo replication Laravel Eloquent models via HTTP

Master install

1. composer require s3lp/piece-data:dev-master
2. artisan vendor:publish --provider="S3lp\PieceData\ServiceProvider"
3. configure slaves:
   ['slave_name' => 'http://slave/api/unique/import_route']
4. configure export_models:
   ['model_name' => App\Models\Model]
5. configure access_token
6. artisan migrate --path=vendor/s3lp/piece-data/database/migrations
7. implements Syncable interface
8. sheduler include console command
   S3lp\PieceData\Console\SyncModelsExport

Slave install

1. composer require s3lp/piece-data:dev-master
2. artisan vendor:publish --provider="S3lp\PieceData\ServiceProvider"
3. configure import_models
['model_name' => App\Models\Model]
4. configure access allowed_ips and/or access_token
5. setup models $fillable attribute
6. include API routes map:
   Route::any('/unique/import_route', '\\S3lp\\PieceData\\Controllers\\SyncImportController@syncImport');

Manual master use

artisan sync:models --status – show queue status and main settings.

artisan sync:models – start sync.

artisan sync:models --reset – sync all exportable models.

Options:

--models=name1,name2 – exportable models names for sync.

--post-chunk=1000 – max models objects for one post-request.

--reset-chunk=3000 – all exportable models query chunk for refill queue.

Tricks

public function getSyncSlaves(): array
{
    if (true) {
        return ['slave_name' => 'remove']; // force remove
    } elseif (true) {
        return array_filter(array_keys(config('sync_models.slaves')), 'callback');
    } else {
        return array_keys(config('sync_models.slaves'));
    }
}