umbrellio/php-table-sync

PHP's implementation of the library providing data synchronization between microservices
50,321 5
Install
composer require umbrellio/php-table-sync
Latest Version:4.0.0
PHP:^8.1
License:MIT
Last Updated:May 26, 2026
Links: GitHub  ·  Packagist
Maintainer: Zlob

PHP TableSync

PHP's implementation of the library providing data synchronization between microservices

Github Status Coverage Status Latest Stable Version Total Downloads Code Intelligence Status Build Status Code Coverage Scrutinizer Code Quality

Installation

composer require umbrellio/php-table-sync
php artisan vendor:publish --tag=config-table-sync

Usage

Let's describe the model that needs to be synchronized using an example User.php

...
User extends Model implements SyncableModel
{
    use TableSyncable;

...

    public function routingKey(): string
    {
        return 'users';
    }

    public function getTableSyncableAttributes(): array
    {
        return [
            'id' => $this->external_id,
            'login' => $this->name,
            'email' => $this->email,
        ];
    }
...

When the model changes, the data will be sent according to the rules of TableSyncObserver, to get the data you need to run the command table_sync:work

Logging

Logging based on the Monolog package and contains some extensions for it.

  • specify the logging channel in config/table_sync.php
...
'log' => [
    'channel' => 'table_sync',
],
...
  • and describe this channel in config/logging.php
...
'table_sync' => [
    'driver' => 'stack',
    'channels' => ['table_sync_daily', 'influxdb'],
],
'table_sync_daily' => [
    'driver' => 'daily',
    'formatter' => LineTableSyncFormatter::class,
    'formatter_with' => [
        'format' => '[%datetime%] %message% - %model% %event%',
    ],
    'path' => storage_path('logs/table_sync/daily.log'),
],
'influxdb' => [
    'driver' => 'influxdb',
    'measurement' => 'table_sync',
],
...
You can use the built-in LineTableSyncFormatter::class with the available parameters: %datetime% %message% %direction% %model% %event% %routing% %attributes% %exception%
Driver influxdb is an additional option and is not required to add in config
...
'table_sync' => [
    'driver' => 'daily',
],
...

Authors

Created by Korben Dallas.

Related Packages

awssat/laravel-sync-migration

Developer tool helps to sync migrations without refreshing the database

23,725 108
joshcirre/duo

Local-first IndexedDB syncing for Laravel and Livewire applications.

21 36
swayok/laravel-extended-errors

Extended laravel debug exceptions display (more info) and monolog's html emails...

1,370 1
bebbolus/edmrabbitpackage

Rabbit Entity Management Package for Laravel PHP Framework

42 0
umbrellio/rollback-missing-migrations

Laravel package for rolling back migrations between different releases

45,432 2