PHPackages                             fzed51/pdo-helper - 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. fzed51/pdo-helper

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

fzed51/pdo-helper
=================

Helper pour faciliter l'initialisation d'objet PDO

v2.1.0(3y ago)06201[1 PRs](https://github.com/fzed51/pdo-helper/pulls)2MITPHPPHP ^8.1CI failing

Since Dec 17Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/fzed51/pdo-helper)[ Packagist](https://packagist.org/packages/fzed51/pdo-helper)[ RSS](/packages/fzed51-pdo-helper/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (2)Dependencies (3)Versions (17)Used By (2)

PDO-HELPER
==========

[](#pdo-helper)

Librairie PHP 8.1+ d'aide à l'utilisation de PDO et au requêtage des bases de données.

Installation
------------

[](#installation)

```
composer require fzed51/pdo-helper
```

Utilisation
-----------

[](#utilisation)

### PDOFactory

[](#pdofactory)

Fabrique statique pour créer des connexions PDO préconfigurées (mode exception activé, casse et mode de fetch configurables).

```
use Helper\PDOFactory;

// MySQL
$pdo = PDOFactory::mysql('localhost', 'ma_base', 'user', 'password');
// avec port et charset personnalisés
$pdo = PDOFactory::mysql('localhost', 'ma_base', 'user', 'password', 3307, 'utf8mb4');

// SQLite (fichier ou mémoire)
$pdo = PDOFactory::sqlite(':memory:');
$pdo = PDOFactory::sqlite('/chemin/vers/base.db');

// PostgreSQL
$pdo = PDOFactory::pgsql('ma_base', 'localhost', 'user', 'password');

// Oracle (normalise automatiquement NLS_DATE_FORMAT et NLS_TIMESTAMP_FORMAT)
$pdo = PDOFactory::oci('MON_SID', 'user', 'password');
```

**Configuration globale** (à définir avant la création des connexions) :

```
PDOFactory::$case      = PDO::CASE_LOWER;   // défaut : PDO::CASE_UPPER
PDOFactory::$fetchMode = PDO::FETCH_ASSOC;  // défaut : PDO::FETCH_OBJ
```

---

### DbQuickUse

[](#dbquickuse)

Classe utilitaire pour les opérations CRUD courantes. S'instancie avec un objet PDO.

```
use Helper\DbQuickUse;

$db = new DbQuickUse($pdo);
```

**Lecture**

```
// Plusieurs enregistrements
$users = $db->select(['id', 'nom', 'email'], 'users', ['actif' => 1]);

// Avec alias : ['alias' => 'champ']
$users = $db->select(['identifiant' => 'id', 'nom'], 'users');

// Limite
$users = $db->select(['id', 'nom'], 'users', [], 10);

// Un seul enregistrement (retourne null si absent)
$user = $db->selectOne(['id', 'nom', 'email'], 'users', ['id' => 42]);

// Comptage
$nb = $db->countElement('users', ['actif' => 1]);
```

**Écriture**

```
// Insertion
$db->insertInto('users', ['nom' => 'Dupont', 'email' => 'dupont@example.com']);

// Mise à jour
$db->update('users', ['email' => 'nouveau@example.com'], ['id' => 42]);

// Suppression
$db->delete('users', ['id' => 42]);

// Dernier PK (MAX sur la colonne)
$lastId = $db->getLastPk('users', 'id');
```

**Format du tableau `$where`**

ÉcritureSQL généré`['champ' => 'valeur']``champ = ?``['champ' => null]``champ IS NULL``['age > 18']` (clé entière)clause brute verbatimSans clause WHERE, la condition `1 = 1` est utilisée.

---

### SqlRequest

[](#sqlrequest)

Générateur de requêtes SELECT avec une interface fluide (chaînable).

```
use Helper\SqlRequest;

$sql = (new SqlRequest())
    ->select(['id', 'email' => 'users.email', 'nom'])
    ->from('users')
    ->where(['actif = 1', 'age > 18'])
    ->sql();
// select id, users.email as email, nom from users where actif = 1 and age > 18

// Ajout progressif
$req = (new SqlRequest())
    ->select('id')
    ->addSelect('users.email', 'email')
    ->from('users LEFT JOIN roles ON users.role_id = roles.id')
    ->where('actif = 1')
    ->addWhere('roles.name = "admin"');

$sql = $req->sql();
```

`select()` et `from()` acceptent une chaîne ou un tableau. `where()` remplace les clauses existantes ; `addWhere()` en ajoute une.

---

### PdoQueryable

[](#pdoqueryable)

Trait à inclure dans vos classes repository/DAO pour bénéficier d'un accès PDO avec cache de requêtes et gestion automatique de l'encodage.

```
use Helper\PdoQueryable;

class UserRepository
{
    use PdoQueryable;

    public function __construct(\PDO $pdo)
    {
        $this->setPdo($pdo);
    }

    public function findAll(): array
    {
        $this->setReqSql('SELECT * FROM users');
        return $this->fetchAll();
    }

    public function findById(int $id): ?array
    {
        $this->setReqSql('SELECT * FROM users WHERE id = ?');
        return $this->fetchOne([$id]);
    }

    public function create(string $nom, string $email): void
    {
        $this->setReqSql('INSERT INTO users (nom, email) VALUES (?, ?)');
        $this->execute([$nom, $email]);
        echo $this->getRowsAffected(); // 1
    }
}
```

**Comportements clés**

- Les `PDOStatement` sont mis en cache par hash SHA-256 du SQL (évite les `prepare()` répétés).
- L'encodage des paramètres en entrée et des données en sortie est converti automatiquement. Les charsets supportés sont : `UTF-8`, `CP1252`, `ISO-8859-15`, `ISO-8859-1`, `ASCII`. La sortie est toujours ramenée en `UTF-8` ; l'encodage cible en entrée se configure via `setCharset()`.
- `getLastReqInfo()` retourne `['request' => string, 'params' => array]` pour le débogage.
- `getRowsAffected()` retourne le nombre de lignes affectées par le dernier `execute()`.

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance59

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~139 days

Recently: every ~166 days

Total

12

Last Release

1215d ago

Major Versions

v1.6.0 → v2.0.02022-09-29

PHP version history (3 changes)v1.0PHP ^7.1

v1.3PHP ^7.2

v2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b6a8b19c5e90c6de2bc25cb56516bc0bf6cd4fa8eee97ee3a762b11180a0362?d=identicon)[fzed51](/maintainers/fzed51)

---

Top Contributors

[![fzed51](https://avatars.githubusercontent.com/u/1201984?v=4)](https://github.com/fzed51 "fzed51 (29 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fzed51-pdo-helper/health.svg)

```
[![Health](https://phpackages.com/badges/fzed51-pdo-helper/health.svg)](https://phpackages.com/packages/fzed51-pdo-helper)
```

###  Alternatives

[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k116.5M113](/packages/jdorn-sql-formatter)[propel/propel1

Propel is an open-source Object-Relational Mapping (ORM) for PHP5.

8351.6M87](/packages/propel-propel1)[pgvector/pgvector

pgvector support for PHP

198628.3k10](/packages/pgvector-pgvector)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)