PHP 表單生成類：從零構建靈活的 HTML 表單構建器

在早期的 PHP 開發中，手寫 HTML 表單不僅繁瑣，還難以維護一致的樣式與結構。本文介紹一個經典的 Form 類，它通過面向對象方式封裝表單元素生成邏輯，支持表格佈局與流式佈局雙模式，極大提升了開發效率。雖然現代框架已內置表單構建器，但理解其核心設計思想對掌握 PHP OOP 精髓極有幫助。

核心架構設計

Form 類採用「構建器模式」思想：

• 屬性配置：$action、$method、$layout (表格/流式) 等全局屬性。
• 元素工廠方法：form_text()、form_passwd()、form_select() 等對應各類 input 元素。
• 佈局策略：form_item() 根據 $layout 決定輸出 <tr><th><td> 還是簡單的 <label><input>。
• 統一入口：CreateForm() 批量渲染元素數組。

關鍵代碼解析

1. 構造函數與表單啟動

<?php
class Form {
    public $layout = true;  // 默認表格佈局
    public $action, $method, $enctype, $name, $id, $class;

    public function __construct($action, $method = "POST") {
        $this->action = $action;
        $this->method = $method;
    }

    public function form_start() {
        $html = "<form action=\"{$this->action}\" method=\"{$this->method}\"";
        foreach (['class', 'enctype', 'id', 'name'] as $attr) {
            if ($this->$attr) $html .= " $attr=\"{$this->$attr}\"";
        }
        $html .= ">\n";
        if ($this->layout) $html .= "<table>\n";
        return $html;
    }
    // ...
}
?>

2. 表單元素生成：以文本框為例

<?php
public function form_text($name, $id, $label_name, $label_for, $value = "") {
    $input = "<input type=\"text\" name=\"{$name}\" id=\"{$id}\"";
    if (isset($value)) $input .= " value=\"{$value}\"";
    $input .= " />\n";
    
    $label = $this->form_label($label_name, $label_for);
    return $this->form_item($label, $input);
}

private function form_label($text, $for) {
    return $for ? "<label for=\"{$for}\">{$text}：</label>" : "{$text}：";
}

private function form_item($label, $input) {
    if ($this->layout) {
        return "<tr>\n<th class=\"label\">{$label}</th>\n<td>{$input}</td>\n</tr>\n";
    }
    return $label . $input . "<br>\n";
}
?>

3. 實戰演示：用戶登錄表單

<?php
require_once("Form.php");
$form = new Form($_SERVER['PHP_SELF']);
$form->layout = false; // 切換為流式佈局

$username = $form->form_text("userid", "userid", "用戶名", "userid");
$password = $form->form_passwd("passwd", "passwd", "密碼", "passwd");
$submit   = $form->form_button("", "submit", "submit", "登錄");

$form->CreateForm([$username, $password, $submit]);
?>

現代視角的改進建議

若在現代項目中復用此思路，建議：

1. 引入命名空間與 PSR-4 自動加載，替代 require_once。
2. 使用介面定義元素契約（FormElementInterface），便於擴展自定義組件（如日期選擇器、富文本編輯器）。
3. 模板引擎解耦：將 HTML 字符串拼接移至 Blade/Twig 模板，類僅負責數據準備。
4. CSRF 保護：在 form_start() 自動注入 <input type="hidden" name="_token">。
5. 屬性類型提示：PHP 7.4+ 類型聲明增強 IDE 提示與靜態分析能力。

總結

這個 Form 類雖屬「上古」代碼，但其「配置驅動生成、佈局策略分離、統一入口渲染」的設計模式至今不過時。理解它，有助於你更深入地掌握現代框架（Laravel Form Builder、Symfony Form Component）的底層邏輯。