🌍 Languages: 🇫🇷 Français | 🇬🇧 English
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é.
- ✨ Fonctionnalités
- 🚀 Installation Rapide
- 🎯 Premier Exemple
- 📚 Documentation
- 🧪 Tests et Qualité
- 🤝 Contribution
- 📄 Licence
- 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
- 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
- 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
- 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
- PHP 8.4+
- PDO avec driver MySQL/PostgreSQL/SQLite
- Composer
composer require mulertech/database "^1.0"<?php
use MulerTech\Database\Database\Interface\PhpDatabaseManager;
use MulerTech\Database\ORM\EntityManager;
use MulerTech\Database\Mapping\MetadataRegistry;
// Configuration de la base de données
$config = [
'host' => 'localhost',
'port' => 3306,
'database' => 'my_app',
'username' => 'user',
'password' => 'password'
];
// Initialisation
$pdm = new PhpDatabaseManager($config);
$metadataRegistry = new MetadataRegistry();
$entityManager = new EntityManager($pdm, $metadataRegistry);<?php
use MulerTech\Database\Mapping\Attributes\{MtEntity, MtColumn};
use MulerTech\Database\Mapping\Types\{ColumnType, ColumnKey};
#[MtEntity(tableName: 'users')]
class User
{
#[MtColumn(
columnType: ColumnType::INT,
columnKey: ColumnKey::PRIMARY_KEY,
extra: 'auto_increment'
)]
private ?int $id = null;
#[MtColumn(columnType: ColumnType::VARCHAR, length: 100)]
private string $name;
#[MtColumn(columnType: ColumnType::VARCHAR, length: 255)]
private string $email;
#[MtColumn(columnType: ColumnType::DATETIME)]
private DateTime $createdAt;
// Getters et Setters...
public function getId(): ?int { return $this->id; }
public function getName(): string { return $this->name; }
public function setName(string $name): void { $this->name = $name; }
// ...
}// Créer un utilisateur
$user = new User();
$user->setName('John Doe');
$user->setEmail('john@example.com');
$user->setCreatedAt(new DateTime());
$entityManager->persist($user);
$entityManager->flush(); // L'ID est automatiquement assigné
// Rechercher des utilisateurs
$users = $entityManager->getRepository(User::class)->findAll();
$user = $entityManager->getRepository(User::class)->find(1);
$users = $entityManager->getRepository(User::class)->findBy(['name' => 'John']);
// Modifier un utilisateur
$user->setEmail('john.doe@example.com');
$entityManager->flush(); // Modification automatiquement détectée
// Supprimer un utilisateur
$entityManager->remove($user);
$entityManager->flush();$queryBuilder = new QueryBuilder($entityManager->getEmEngine());
// Requête simple
$users = $queryBuilder
->select('u.name', 'u.email')
->from('users', 'u')
->where('u.name', 'LIKE', '%John%')
->orderBy('u.createdAt', 'DESC')
->limit(10)
->getResult();
// Requête avec jointure
$results = $queryBuilder
->select('u.name', 'p.title')
->from('users', 'u')
->join('posts', 'p', 'u.id = p.user_id')
->where('p.published', '=', true)
->getResult();# Générer une migration
./vendor/bin/console migration:generate
# Exécuter les migrations
./vendor/bin/console migration:run
# Rollback
./vendor/bin/console migration:rollback- Entity Manager
- Repositories
- Suivi des Modifications
- Système d'Événements
- Query Builder
- Requêtes SQL Brutes
# Tests unitaires
./vendor/bin/phpunit
# Tests avec couverture
XDEBUG_MODE=coverage ./vendor/bin/phpunit --coverage-html coverage
# Analyse statique
./vendor/bin/phpstan analyze
# Style de code
./vendor/bin/php-cs-fixer fix- ✅ 100% de couverture de tests
- ✅ PHPStan niveau 9 (analyse statique maximale)
- ✅ PHP CS Fixer (style de code cohérent)
- ✅ Zéro vulnérabilité (audit sécurité automatique)
# Démarrer l'environnement de test
./vendor/bin/mtdocker up
# Exécuter les tests dans Docker
./vendor/bin/mtdocker test
# Tests avec couverture
./vendor/bin/mtdocker test-coverage- Fork le repository
- Créer une branche feature (
git checkout -b feature/ma-fonctionnalite) - Commit les modifications (
git commit -am 'Ajouter ma fonctionnalité') - Push vers la branche (
git push origin feature/ma-fonctionnalite) - Créer une Pull Request
- PSR-12 pour le style de code
- PHPStan niveau 9 obligatoire
- Tests unitaires pour toute nouvelle fonctionnalité
- Documentation mise à jour
# Cloner le repository
git clone https://github.com/mulertech/database.git
cd database
# Installer les dépendances
composer install
# Configurer l'environnement
cp .env.example .env
# Démarrer Docker (optionnel)
./vendor/bin/mtdocker upCe projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.
- 📦 Packagist : mulertech/database
- 🐛 Issues : GitHub Issues
- 📧 Support : sebastien.muler@mulertech.net
- 🌐 Site Web : mulertech.net
- v1.0.x : Version stable actuelle
- Voir CHANGELOG.md pour l'historique complet
Développé avec ❤️ par MulerTech