Doctrine DBAL PHP: पूर्ण गाइड उदाहरणों के साथ

1. यह क्या है और क्यों ज़रूरी है

Doctrine DBAL (Database Abstraction Layer) PHP के लिए एक शक्तिशाली लाइब्रेरी है जो विभिन्न रिलेशनल डेटाबेस के साथ काम करने के लिए एक समान इंटरफ़ेस प्रदान करती है। यह Doctrine इकोसिस्टम का हिस्सा है, लेकिन इसे एक स्वतंत्र कंपोनेंट के रूप में भी इस्तेमाल किया जा सकता है। DBAL का मुख्य उद्देश्य डेवलपर को किसी विशेष DBMS (MySQL, PostgreSQL, SQLite, Oracle, SQL Server आदि) की विशिष्टताओं से अलग रखना है, जिससे पोर्टेबल कोड लिखा जा सके।

Doctrine DBAL की ज़रूरत क्यों है? पहला, यह सामान्य ऑपरेशनों को बहुत आसान बनाता है: डेटाबेस से कनेक्शन, क्वेरी निष्पादन, ट्रांज़ैक्शन प्रबंधन। दूसरा, यह prepared statements और पैरामीटर के ऑटोमैटिक एस्केपिंग के ज़रिए सुरक्षा प्रदान करता है, जो SQL इंजेक्शन से बचाता है। तीसरा, DBAL में एक सुविधाजनक Query Builder है जो बिना रॉ SQL लिखे जटिल क्वेरी बनाने में मदद करता है। पूर्ण ORM (Object-Relational Mapper) के विपरीत, DBAL में ऑब्जेक्ट और एंटिटी मैपिंग की ज़रूरत नहीं होती, जो इसे उन प्रोजेक्ट्स के लिए आदर्श बनाता है जहाँ SQL पर सीधा नियंत्रण चाहिए लेकिन अतिरिक्त सुविधाएँ भी चाहिए।

यह लाइब्रेरी सक्रिय रूप से मेंटेन की जाती है, इसकी बेहतरीन डॉक्यूमेंटेशन है और यह इंडस्ट्रियल डेवलपमेंट में व्यापक रूप से उपयोग की जाती है। यह Doctrine ORM और कई लोकप्रिय PHP फ्रेमवर्क (Symfony, Laravel — इंटीग्रेशन के ज़रिए) का आधार है।

2. इंस्टॉलेशन

Doctrine DBAL की इंस्टॉलेशन Composer के ज़रिए की जाती है — जो PHP का मानक पैकेज मैनेजर है। अपने प्रोजेक्ट की रूट डायरेक्टरी में टर्मिनल में निम्न कमांड चलाएँ:

composer require doctrine/dbal

इंस्टॉलेशन के बाद प्रोजेक्ट में vendor/ फ़ोल्डर और composer.json फ़ाइल में डिपेंडेंसी जुड़ जाएगी। किसी विशेष DBMS के लिए संबंधित PDO ड्राइवर (जैसे MySQL के लिए ext-pdo_mysql) इंस्टॉल करना ज़रूरी हो सकता है।

3. त्वरित शुरुआत — न्यूनतम कार्यशील उदाहरण

एक test.php फ़ाइल बनाएँ और Composer ऑटोलोडर को शामिल करें। SQLite (बिल्ट-इन डेटाबेस, जिसे सर्वर इंस्टॉल करने की ज़रूरत नहीं) से कनेक्शन का उदाहरण:

<?php
require_once 'vendor/autoload.php';

use Doctrine\DBAL\DriverManager;

// कनेक्शन पैरामीटर
$connectionParams = [
    'dbname' => 'test.db',
    'driver' => 'pdo_sqlite',
];

// कनेक्शन बनाएँ
$conn = DriverManager::getConnection($connectionParams);

// टेबल बनाएँ
$conn->executeStatement('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, email TEXT)');

// डेटा इंसर्ट करें
$conn->insert('users', ['name' => 'Rahul Sharma', 'email' => 'rahul@example.com']);

// डेटा चुनें
$users = $conn->fetchAllAssociative('SELECT * FROM users');
print_r($users);

यह कोड SQLite डेटाबेस, users टेबल बनाता है, एक रिकॉर्ड इंसर्ट करता है और सभी पंक्तियाँ दिखाता है।

4. मुख्य तरीके/फ़ंक्शन/क्लास

4.1. DriverManager::getConnection()

सिग्नेचर: public static function getConnection(array $params, ?Configuration $config = null, ?EventManager $eventManager = null): Connection

कार्य: दिए गए पैरामीटर के आधार पर डेटाबेस कनेक्शन ऑब्जेक्ट बनाता और लौटाता है। यह DBAL में प्रवेश बिंदु है।

$connectionParams = [
    'dbname' => 'mydb',
    'user' => 'root',
    'password' => 'secret',
    'host' => 'localhost',
    'driver' => 'pdo_mysql',
];
$conn = DriverManager::getConnection($connectionParams);

4.2. Connection::executeStatement()

सिग्नेचर: public function executeStatement(string $sql, array $params = [], array $types = []): int

कार्य: SQL क्वेरी निष्पादित करता है जो रिकॉर्ड का सेट नहीं लौटाती (INSERT, UPDATE, DELETE, DDL)। प्रभावित पंक्तियों की संख्या लौटाता है।

$affectedRows = $conn->executeStatement('UPDATE users SET name = ? WHERE id = ?', ['New Name', 1]);
echo "अपडेट की गई पंक्तियाँ: " . $affectedRows;

4.3. Connection::fetchAllAssociative()

सिग्नेचर: public function fetchAllAssociative(string $sql, array $params = [], array $types = []): array

कार्य: SQL क्वेरी निष्पादित करता है और सभी परिणामी पंक्तियों को एसोसिएटिव ऐरे के रूप में लौटाता है।

$users = $conn->fetchAllAssociative('SELECT * FROM users WHERE active = ?', [1]);
foreach ($users as $user) {
    echo $user['name'] . ' - ' . $user['email'] . "\n";
}

4.4. Connection::insert()

सिग्नेचर: public function insert(string $tableName, array $data, array $types = []): int

कार्य: एक टेबल में नई पंक्ति इंसर्ट करता है। डेटा को एसोसिएटिव ऐरे के रूप में दिया जाता है जहाँ कुंजी कॉलम नाम और मान इंसर्ट किए जाने वाले मान होते हैं।

$conn->insert('users', [
    'name' => 'Priya Singh',
    'email' => 'priya@example.com',
    'created_at' => date('Y-m-d H:i:s')
]);

4.5. Connection::update()

सिग्नेचर: public function update(string $tableName, array $data, array $where, array $types = []): int

कार्य: टेबल में मौजूदा रिकॉर्ड अपडेट करता है। $data में अपडेट किए जाने वाले कॉलम और मान होते हैं, $where में WHERE शर्तें होती हैं।

$conn->update('users', 
    ['email' => 'newemail@example.com'], 
    ['id' => 1]
);

4.6. Connection::delete()

सिग्नेचर: public function delete(string $tableName, array $where, array $types = []): int

कार्य: टेबल से रिकॉर्ड हटाता है। $where में हटाने की शर्तें होती हैं।

$conn->delete('users', ['id' => 1]);

4.7. Query Builder का उपयोग

Query Builder जटिल SQL क्वेरी को प्रोग्रामेटिक रूप से बनाने की सुविधा देता है। यह विशेष रूप से तब उपयोगी होता है जब क्वेरी की शर्तें डायनामिक हों।

use Doctrine\DBAL\Query\QueryBuilder;

$queryBuilder = $conn->createQueryBuilder();
$queryBuilder
    ->select('u.id', 'u.name', 'u.email')
    ->from('users', 'u')
    ->where('u.active = :active')
    ->setParameter('active', 1)
    ->orderBy('u.name', 'ASC')
    ->setMaxResults(10);

$users = $queryBuilder->fetchAllAssociative();

5. निष्कर्ष

Doctrine DBAL PHP डेवलपर्स के लिए एक बेहतरीन टूल है जो डेटाबेस कार्य को सुरक्षित, पोर्टेबल और कुशल बनाता है। चाहे आप छोटे प्रोजेक्ट पर काम कर रहे हों या बड़े एंटरप्राइज़ एप्लिकेशन पर, DBAL आपको SQL पर पूर्ण नियंत्रण देता है साथ ही सुरक्षा और सुविधा भी प्रदान करता है। इसे अपने अगले PHP प्रोजेक्ट में आज़माएँ और डेटाबेस इंटरैक्शन को आसान बनाएँ!