萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Drupal 7 資料庫操作查詢建構器完整實戰指南

Drupal 7 引入 Database API 查詢建構器,提供資料庫抽象層,支援 MySQL、PostgreSQL、SQLite 等多種資料庫,避免撰寫原生 SQL 的可攜性與安全性問題。本文完整涵蓋 CRUD、合併、條件、事務等核心操作。

資料庫連線設定

<?php
// settings.php 已設定 $databases
// 取得預設連線
$db = Database::getConnection();

// 切換其他資料庫(若在 settings.php 定義多個 key)
$db = Database::getConnection('external', 'default');

插入操作

單筆插入

<?php
$nid = db_insert('node')
    ->fields([
        'type' => 'article',
        'title' => 'Hello Drupal',
        'uid' => 1,
        'created' => REQUEST_TIME,
        'status' => 1,
    ])
    ->execute(); // 回傳自增 ID (lastInsertId)

echo "新節點 ID: $nid";

批次多筆插入(高效能)

<?php
$values = [
    ['title' => 'Article 1', 'type' => 'article', 'uid' => 1],
    ['title' => 'Article 2', 'type' => 'article', 'uid' => 2],
    ['title' => 'Article 3', 'type' => 'article', 'uid' => 3],
];

$query = db_insert('node')->fields(['title', 'type', 'uid']);
foreach ($values as $record) {
    $query->values($record);
}
$lastId = $query->execute(); // 回傳最後一筆 ID

// 或使用 database 驅動層級的 multi-insert(更快)
// 但 db_insert()->values() 迴圈已自動優化為單一多值 INSERT 语句

更新操作

<?php
$updated = db_update('node')
    ->condition('nid', 123)
    ->fields([
        'title' => 'Updated Title',
        'changed' => REQUEST_TIME,
    ])
    ->execute(); // 回傳影響行數

echo "更新了 $updated 筆記錄";

// 複雜條件
db_update('users')
    ->condition('status', 1)
    ->condition('last_login', REQUEST_TIME - 86400*30, '<')
    ->fields(['status' => 0]) // 停用 30 天未登入用戶
    ->execute();

刪除操作

<?php
$deleted = db_delete('node')
    ->condition('type', 'spam')
    ->condition('status', 0)
    ->execute();

echo "刪除了 $deleted 筆垃圾內容";

// 子查詢刪除
db_delete('field_data_body')
    ->condition('entity_id', db_select('node', 'n')
        ->fields('n', ['nid'])
        ->condition('n.type', 'deleted_type')
    )
    ->execute();

合併操作(UPSERT:存在更新、不存在插入)

<?php
// 類似 MySQL INSERT ... ON DUPLICATE KEY UPDATE
// 或 PostgreSQL INSERT ... ON CONFLICT
db_merge('users')
    ->key(['mail' => 'user@example.com']) // 唯一鍵判斷依據
    ->insertFields([
        'name' => 'newuser',
        'mail' => 'user@example.com',
        'created' => REQUEST_TIME,
    ])
    ->updateFields([
        'name' => 'updateduser',
        'login' => REQUEST_TIME,
    ])
    ->execute();

// 等效邏輯:
// 如果 mail='user@example.com' 存在 → 更新 name、login
// 不存在 → 插入新記錄

查詢操作:db_select 建構器

基本查詢

<?php
$query = db_select('node', 'n')
    ->fields('n', ['nid', 'title', 'created'])
    ->condition('n.type', 'article')
    ->condition('n.status', 1)
    ->range(0, 10)
    ->orderBy('n.created', 'DESC');

$results = $query->execute()->fetchAllAssoc('nid');

foreach ($results as $nid => $record) {
    echo "$nid: {$record->title}\n";
}

欄位別名

<?php
$query = db_select('node', 'n');
$query->addField('n', 'title', 'node_title'); // 別名 node_title
$query->addField('n', 'uid', 'author_uid');
$query->join('users', 'u', 'n.uid = u.uid');
$query->addField('u', 'name', 'author_name');

$results = $query->execute()->fetchAll();
// 每筆包含: node_title, author_uid, author_name

條件群組與複雜邏輯

<?php
$query = db_select('node', 'n')
    ->fields('n', ['nid', 'title'])
    ->condition(
        db_or()
            ->condition('n.title', '%keyword%', 'LIKE')
            ->condition('n.body', '%keyword%', 'LIKE')
    )
    ->condition('n.status', 1);

// 等效:WHERE (title LIKE '%keyword%' OR body LIKE '%keyword%') AND status = 1

子查詢與 EXISTS

<?php
// 找有評論的節點
$subquery = db_select('comment', 'c')
    ->fields('c', ['nid'])
    ->condition('c.status', 0)
    ->distinct();

$query = db_select('node', 'n')
    ->fields('n', ['nid', 'title'])
    ->where("n.nid IN ($subquery)") // 子查詢
    ->execute();

計數與聚合

<?php
// 總數
$count = db_select('node', 'n')
    ->condition('n.type', 'article')
    ->countQuery()
    ->execute()
    ->fetchField();

// 聚合
$stats = db_select('node', 'n')
    ->fields('n', ['type'])
    ->addExpression('COUNT(*)', 'count')
    ->addExpression('MAX(created)', 'latest')
    ->groupBy('n.type')
    ->execute()
    ->fetchAllKeyed(); // type => count

事務處理

<?php
$transaction = db_transaction();

try {
    $nid = db_insert('node')->fields([...])->execute();
    db_insert('field_data_body')->fields([...])->execute();
    db_insert('field_revision_body')->fields([...])->execute();
    
    $transaction->commit(); // 明確提交(可選,析構時自動提交)
} catch (Exception $e) {
    $transaction->rollback(); // 任何異常自動回滾
    watchdog_exception('mymodule', $e);
    throw $e;
}

資料庫抽象層優勢與注意事項

優勢說明
SQL 注入防護所有值自動參數化,`condition('field', $value)` 安全
跨資料庫相容同一代碼支援 MySQL/PostgreSQL/SQLite
前綴自動處理`{table}` 自動展開為 `prefix_table`
可讀性/維護性鏈式呼叫、IDE 自動完成、重構友善

常見陷阱

  • 忘記 `execute()`:建構器回傳查詢物件,必須呼叫 `execute()` 才送出 SQL
  • 條件值型別:`condition('nid', '123')` 字串 vs 整數可能導致索引失效,建議強制型別轉換
  • 大量資料查詢記憶體:`fetchAll()` 會載入所有記憶體,大資料集用 `fetch()` 迴圈或 `db_query()` 遊標
  • 欄位名稱保留字:用 `{table}` 包裹表名,欄位名用反引號或依賴驅動層處理
copyright © 萬盛學電腦網 all rights reserved