善用 PHPLIB DBSQL 類加速 MySQL 開發效率

痛點：原生 MySQL API 繁瑣且易出錯

早期 PHP 開發者常直接使用 mysql_connect、mysql_query、mysql_fetch_array 等函式，不僅參數多、程式碼冗長，每支程式還得硬編碼資料庫名稱、帳號、密碼，維護極度不便。

PHPLIB DBSQL 類簡介

PHPLIB 是早期知名的 PHP 元件庫，其 DBSQL 類將資料庫操作封裝為直觀的物件導向介面，大幅簡化開發流程。取得方式有二：

1. 下載完整 PHPLIB（官網）
2. 直接下載獨立修改版 DBSQL 類

快速上手三步驟

1. 修改設定

開啟 db.php，約第 138 行，設定四個參數：

$Host = "localhost";
$Database = "mydb";
$User = "root";
$Password = "secret";

2. 基本使用範例

<?php
require "db.php";
$db = new DBSQL;
$db->connect();

if ($db->Link_ID) {
    $db->query("SELECT id, name FROM contact WHERE id > 100 AND id < 200");
    if ($db->nf()) {
        while ($db->next_record()) {
            echo "id=" . $db->f("id") . "<br>";
            echo "name=";
            $db->p("name");  // 直接輸出
            echo "<br>";
        }
    }
    $db->free_result();
}
?>

3. 逐行解析

實用進階屬性與方法

• Auto_free = true：查詢結束自動釋放結果集
• DebugMode = true：自動印出執行的 SQL，除錯神器
• seek($offset)：移動結果指標
• num_rows()：同 nf()
• metadata($table)：取得資料表結構陣列

現代視角的啟示

雖然 PHPLIB 早已停止維護，但 DBSQL 的設計理念——「封裝連線細節、提供流暢介面、支援除錯模式」——深深影響後續的 ADOdb、Pear DB、Zend_Db 以至現代的 Eloquent/Doctrine。理解其演進歷程，有助於掌握現代 ORM 的核心設計動機。