gupalo/item-syncer

Item Syncer

1.3.0 2025-08-21 14:55 UTC

Requires

• php: ^8.1
• doctrine/orm: ^2.14|^3.0
• gupalo/dateutils: ^1.13
• phpspec/prophecy-phpunit: ^2.0

Requires (Dev)

• phpunit/phpunit: ^11.5

GPL-3.0-only

• sync
• doctrine

README

Sync remote to local items.

Install

composer require gupalo/item-syncer

How to use

Create 2 arrays with items implementing \Gupalo\ItemSyncer\SyncableEntityInterface:

• remoteItems: usually from external API - source of truth
• localItems: items from your DB

Update logic:

• remote item that is missing locally - create
• remote item that exists locally - update (you implement logic which properties should be updated)
• local item that is missing remotely - you decide by selecting sync method:
  • syncKeeping: don't do anything
  • syncArchiving: if local item has method archive then archive local item
  • syncRemoving: remove local items

If you use Doctrine and save diff to database then use DbItemSyncer. If you have your own logic of processing diff then use ItemSyncer and its diffKeeping, diffArchiving, diffRemoving methods.

Example

$remoteItems = array_map(
    static fn(array $a) => Country::createFromApi($a),
    $this->countryApiClient->getCountries()
);
$localItems = $this->countryRepository->findAll();
$diff = $this->dbItemSyncer->syncArchiving($remoteItems, $localItems);

print_r($diff->stat()); // something like ['created' => 2, 'updated' => 180]