auditor-doctrine-provider 1.2.0

What's Changed

Bug fixes

• fix: audit all inverse-side OneToMany associations when multiple entities are flushed together by @DamienHarper in #2

  Doctrine's UoW does not reliably schedule inverse-side (OneToMany/mappedBy) collections for update when the FK is changed through the owning-side ManyToOne field. When multiple entities sharing the same target are flushed together, only some ASSOCIATE entries were emitted on the inverse side's audit table.

  Note: This bug also affects the deprecated DoctrineProvider embedded in auditor (≤ 4.x). It will not be backported there — users are encouraged to migrate to auditor-doctrine-provider.

Documentation

• docs: add CONTRIBUTING.md with code quality checks guidance

References

• auditor core library
• auditor-bundle
• Official documentation

Full Changelog: https://github.com/DamienHarper/auditor-doctrine-provider/compare/1.1.0...1.2.0

auditor-doctrine-provider 1.1.0

✨ What's new

Support for long-running processes (Symfony Messenger workers)

When using auditor inside Symfony Messenger workers, only the first message was audited correctly. Subsequent messages silently failed because the DoctrineSubscriber held a stale EntityManager reference after reset, and DoctrineProvider reused cached PreparedStatement objects bound to a closed connection.

DoctrineProvider now implements Symfony\Contracts\Service\ResetInterface. Its reset() method clears the prepared statement cache and resets all subscriber transaction caches, ensuring clean state between messages.

DoctrineSubscriber now retrieves the EntityManager directly from event arguments (OnFlushEventArgs, LifecycleEventArgs) instead of relying on a constructor-injected reference that could become stale.

Wiring kernel.reset in Symfony

Tag DoctrineProvider with kernel.reset so that Symfony's services_resetter calls reset() automatically between messages:

# config/services.yaml
services:
    DH\Auditor\Provider\Doctrine\DoctrineProvider:
        tags:
            - { name: kernel.reset, method: reset }

If your service definition uses autoconfigure: true, Symfony detects ResetInterface and registers the tag automatically — no additional config needed.

What's Changed

Bug fixes

• fix: support long-running processes (Messenger workers) by @Spomky

Documentation

• docs: document ResetInterface and kernel.reset for Messenger workers

CI

• ci: fix invalid artifact name by sanitizing Symfony version
• ci: add workflow_dispatch trigger to sync-docs workflow

References

• auditor core library
• auditor-bundle
• Official documentation

Full Changelog: https://github.com/DamienHarper/auditor-doctrine-provider/compare/1.0.0...1.1.0

auditor-doctrine-provider 1.0.0

The standalone Doctrine ORM provider for auditor. This is the first release of auditor-doctrine-provider — previously shipped as the built-in DoctrineProvider inside damienharper/auditor, it is now a dedicated, independently versioned package.

What is auditor-doctrine-provider?

auditor-doctrine-provider implements the auditor provider interface for Doctrine ORM. It tracks all entity lifecycle changes and persists them as structured audit entries:

• inserts and updates, including field-level diffs
• many-to-many relationship changes (association and dissociation)
• user identity and IP address of the actor, when available
• audit entries written within the same database transaction as the originating flush

Supported databases: MySQL, MariaDB, PostgreSQL, SQLite — and any other RDBMS supported by Doctrine DBAL.

Note: bulk operations via DQL ($em->createQuery('UPDATE ...')) or raw DBAL queries bypass Doctrine's UnitOfWork and are not tracked.

✨ Features

All features from damienharper/auditor 4.x are available in this release.

Extra data — attach any context to audit entries

Audit entries carry arbitrary supplementary data through a nullable JSON extra_data column. Wire up a LifecycleEvent listener to populate whatever context matters — HTTP request, user roles, business workflow step, anything.

#[AsEventListener]
public function onAudit(LifecycleEvent $event): void
{
    $event->getPayload()['extra_data'] = [
        'ip'   => $this->requestStack->getCurrentRequest()?->getClientIp(),
        'role' => $this->security->getUser()?->getRoles(),
    ];
}

Extra data provider — global context for every audit entry

A extra_data_provider callable on Configuration attaches context to every audit entry automatically, without a per-entity listener.

$configuration->setExtraDataProvider(function (): ?array {
    return ['ip' => $this->requestStack->getCurrentRequest()?->getClientIp()];
});

JsonFilter — query extra data with JSON paths

$filter = new JsonFilter('extra_data', 'role', '=', 'ROLE_ADMIN');

Native JSON indexing on MySQL, MariaDB, PostgreSQL, and SQLite.

NullFilter — IS NULL / IS NOT NULL queries

$filter = new NullFilter('blame_id');       // blame_id IS NULL
$filter = new NullFilter('blame_id', true); // blame_id IS NOT NULL

Multi-database support

Configure a storage_mapper callable to route audit rows to the correct storage EM when using multiple Entity Managers. See docs/providers/doctrine/multi-database.md.

🔨 Requirements

🚀 Installation

composer require damienharper/auditor-doctrine-provider

See docs/getting-started/installation.md for the full setup guide.

🔁 Migrating from the built-in DoctrineProvider

If you were using DoctrineProvider directly from damienharper/auditor (without auditor-bundle), migration is straightforward:

composer require damienharper/auditor-doctrine-provider

Update your import statements:

// Before (auditor 4.x, deprecated)
use DH\Auditor\Provider\Doctrine\DoctrineProvider;

// After
use DH\AuditorDoctrineProvider\DoctrineProvider;

The deprecated classes in damienharper/auditor still exist as aliases through 4.x and will be removed in v5.0.

Users of auditor-bundle do not need to do anything — the bundle pulls in this package automatically since 8.0.

🛠 Developer experience

• Documentation in-repo — all docs live in docs/ and are versioned alongside the code.
• CI matrix — PHP 8.4 and 8.5 × SQLite / MySQL / PostgreSQL / MariaDB.
• PHPStan at level max, Rector 2.x, PHPUnit 12.x.

References

• Official documentation
• auditor core library
• auditor-bundle

Full Changelog: https://github.com/DamienHarper/auditor-doctrine-provider/commits/1.0.0