PHPackages                             mulertech/database - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. mulertech/database

ActiveLibrary[Database & ORM](/categories/database)

mulertech/database
==================

This package manage database and is composed by orm and dbal components

v1.0.0(9mo ago)00MITPHPPHP ^8.4CI passing

Since Mar 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/mulertech/database)[ Packagist](https://packagist.org/packages/mulertech/database)[ RSS](/packages/mulertech-database/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (12)Versions (5)Used By (0)

MulerTech Database
==================

[](#mulertech-database)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1240b5fd7547c057d2080d5908075d0a7d47889f2732e589f94221c5d7b86a7d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d756c6572746563682f64617461626173652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mulertech/database)[![GitHub Tests Action Status](https://camo.githubusercontent.com/9eddd94866d901cc5a03c382854718ef27f58b7fb8b2a03a2205359ad3498c03/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d756c6572746563682f64617461626173652f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/mulertech/database/actions/workflows/tests.yml)[![GitHub PHPStan Action Status](https://camo.githubusercontent.com/dd746ed95392f72a9c861672ab99d45499bddc69a7c3c5d8d6b83505969dd069/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d756c6572746563682f64617461626173652f7068707374616e2e796d6c3f6272616e63683d6d61696e266c6162656c3d7068707374616e267374796c653d666c61742d737175617265)](https://github.com/mulertech/database/actions/workflows/phpstan.yml)[![Total Downloads](https://camo.githubusercontent.com/66337804d5b2bdb54954175e2aba0cc113f3abc40e7c6bb8369a69c4a1119316/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d756c6572746563682f64617461626173652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mulertech/database)[![Test Coverage](https://raw.githubusercontent.com/mulertech/database/badge/badge-coverage.svg)](https://packagist.org/packages/mulertech/database)

🌍 **Languages:** [🇫🇷 Français](README.md) | [🇬🇧 English](README.en.md)

---

Un package PHP moderne pour la **gestion de base de données** combinant une **couche d'abstraction (DBAL)** et un **mapping objet-relationnel (ORM)** performant. Conçu pour PHP 8.4+ avec un focus sur la simplicité, la performance et la maintenabilité.

---

📋 Table des Matières
--------------------

[](#-table-des-matières)

- [✨ Fonctionnalités](#-fonctionnalit%C3%A9s)
- [🚀 Installation Rapide](#-installation-rapide)
- [🎯 Premier Exemple](#-premier-exemple)
- [📚 Documentation](#-documentation)
- [🧪 Tests et Qualité](#-tests-et-qualit%C3%A9)
- [🤝 Contribution](#-contribution)
- [📄 Licence](#-licence)

---

✨ Fonctionnalités
-----------------

[](#-fonctionnalités)

### 🗄️ **ORM Moderne**

[](#️-orm-moderne)

- **Mapping par attributs PHP 8** (`#[MtEntity]`, `#[MtColumn]`, etc.)
- **Relations complètes** (OneToOne, OneToMany, ManyToMany)
- **Entity Manager** avec suivi automatique des modifications
- **Repositories personnalisés** avec requêtes typées
- **Système d'événements** (PrePersist, PostUpdate, etc.)
- **Cache intelligent** pour les métadonnées et requêtes

### 🔧 **Query Builder Expressif**

[](#-query-builder-expressif)

- **API fluide** pour construire des requêtes complexes
- **Requêtes typées** avec autocomplétion IDE
- **Jointures avancées** et sous-requêtes
- **Support SQL brut** quand nécessaire
- **Optimisation automatique** des requêtes

### 🛠️ **Gestion de Schéma**

[](#️-gestion-de-schéma)

- **Migrations automatiques** avec détection des changements
- **Commandes CLI** intégrées (`migration:run`, `migration:rollback`)
- **Comparaison de schémas** et génération de diff
- **Support multi-environnements**

### 🎯 **Performance et Fiabilité**

[](#-performance-et-fiabilité)

- **Lazy loading** des relations
- **Connection pooling** et gestion des transactions
- **Cache multi-niveaux** (métadonnées, requêtes, résultats)
- **Tests complets** (100% de couverture)
- **Analyse statique** PHPStan niveau 9

---

🚀 Installation Rapide
---------------------

[](#-installation-rapide)

### Prérequis

[](#prérequis)

- **PHP 8.4+**
- **PDO** avec driver MySQL/PostgreSQL/SQLite
- **Composer**

### Installation

[](#installation)

```
composer require mulertech/database "^1.0"
```

### Configuration Minimale

[](#configuration-minimale)

```