建立靈活可維護的 PHP 應用程式架構

核心架構原則

「好的程式碼應分為多個部分：合適的庫、清晰的函數呼叫、清楚的資料庫結構、站點各部分相對獨立。」

四大基石

實作範例：SourceForge 風格分層

HTML 庫（表現層）

<?php
require("database.php");
require("html.php");        // 共用版面函數
require("bug_data.php");    // 資料存取庫

echo site_header("Page Title");
echo "Updating A Bug";

if (bug_data_update($f1, $f2, $f3)) {
    echo "Update Failed! " . $feedback; // 全域錯誤訊息
} else {
    echo "Updated Successfully";
}
echo site_footer();
?>

資料存取庫（邏輯層）

<?php
// bug_data.php
function bug_data_update($field1, $field2, $field3) {
    // 1. 驗證輸入
    // 2. 安全檢查（權限、CSRF 等）
    // 3. 執行 SQL 更新
    // 4. 成功 return false，失敗 return true + 設定 $feedback
}
?>

關鍵洞見

• HTML 層極薄：僅含簡單函數呼叫、版面函數、資料顯示
• 所有業務規則在資料層：驗證、安全、SQL 組裝、錯誤處理
• 資料庫抽象：database.php 提供統一介面，不綁定特定 DB
• 介面切換容易：要支援 WAP 只需寫新 HTML 庫呼叫同一 bug_data.php

可移植性實踐

• 共用版面（header/footer/選單）封裝為函數，而非複製 HTML 片段
• 資料庫認證資訊集中於抽象層配置
• 網站風格參數（顏色、字體）集中於設定檔

函數庫化原則

「任何將在超過一處使用的程式碼，都應放入庫中。」

例：使用者驗證邏輯封裝為 check_login()，未來改用 Session/資料庫/OAuth 僅修改此函數。

後記

作者承認即使是經驗豐富的開發者，回顧舊碼也會發現改進空間。架構設計是持續演進的過程，歡迎讀者分享大型專案規劃經驗與重構心得。