conserto/pomm-model-manager

PHP Object Model Manager for Postgresql

3.4.0 2024-04-10 09:04 UTC

README

Latest Stable Version CI Status Monthly Downloads License

This as fork of ModelManager, a Pomm project package. It makes developers able to manage entities upon the database through model classes. It is not an ORM, it grants developers with the ability to perform native queries using all of Postgres’SQL and use almost all its types. This makes model layer to meet with performances while staying lean.

This package will provide:

  • Model classes with all common built-in queries (CRUD but also, count and exists).
  • Flexible entities
  • Embedded entities converter
  • Model Layer to group model computations in transactions.

The model layer also proposes methods to leverage Postgres nice transaction settings (constraint deferring, isolation levels, read / write access modes etc.).

Installation

Pomm components are available on packagist using composer. To install and use Pomm's model manager, add a require line to "conserto/pomm-model-manager" in your composer.json file. It is advised to install the CLI package as well.

In order to load the model manager's poolers at startup, it is possible to use the provided SessionBuilder in Pomm's configuration:

$pomm = new Pomm([
    'project_name' => [
        'dsn' => …,
        'class:session_builder' => '\PommProject\ModelManager\SessionBuilder',
    ],
    …
]);

It is better to provide dedicated session builders with your project.

Documentation

The model manager’s documentation is available either online or directly in the documentation folder.

Tests

This package uses Atoum as unit test framework. The tests are located in sources/tests. This package also provides a ModelSessionAtoum class so the test classes can directly get sessions with the model and model layer poolers loaded.