OptimisticConcurrencyBundle 1.0.0

First stable release of OptimisticConcurrencyBundle.

The bundle provides HTTP optimistic concurrency control for Symfony and Doctrine ORM using strong ETags, If-Match, and Doctrine versioned entities.

Highlights

• Strong opaque ETag generation for Doctrine ORM versioned entities
• #[EntityTag] for read responses
• #[RequireIfMatch] for conditional writes
• RFC 9110 If-Match handling with strong comparison semantics
• 428 Precondition Required for missing write preconditions
• 412 Precondition Failed for stale validators
• Doctrine optimistic-lock race protection during flush()
• Representation-aware ETag scopes
• Custom EntityTagProviderInterface
• Symfony Security ordering coverage
• PHP 8.2–8.5 support
• Symfony 7.4 LTS and Symfony 8.1 support
• SQLite, PostgreSQL and MariaDB portability coverage
• PHPStan level-max analysis
• Full GitHub Actions CI matrix

Installation

composer require alkinbg/optimistic-concurrency-bundle

Symfony Flex registers the bundle automatically.

See the README and CHANGELOG for the complete API contract, guarantees and limitations.