Patchlevel ODM

Patchlevel ODM is a lightweight Object Document Mapper for PHP. It maps plain PHP objects to document storage and runs on both MongoDB and PostgreSQL (through patchlevel/rango), exposing the same API for both. It is built on top of patchlevel/hydrator, which gives you fast attribute-based mapping and enterprise features like encryption out of the box.

Unlike Doctrine ODM, Patchlevel ODM has no Unit of Work. Repositories control persistence explicitly, so every write is deliberate and easy to reason about, which makes the library a good fit for long-running worker processes.

Features

• MongoDB and PostgreSQL support with a single, consistent API
• Attribute-based document mapping with #[Document] and #[Id]
• Repositories without a Unit of Work for predictable writes
• Querying with filters, sorting and pagination
• Indexes defined with #[Index], including unique constraints
• Field mapping and normalization for nested objects and custom field names
• Encryption and crypto shredding for sensitive data

Installation

Install the library with Composer. Depending on your database, you also need the matching driver package.

For PostgreSQL via Rango:

composer require patchlevel/odm patchlevel/rango

For MongoDB:

composer require patchlevel/odm mongodb/mongodb

Integration

• patchlevel/hydrator powers the object mapping and normalization
• patchlevel/rango is the PostgreSQL document layer