萬盛學電腦網

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

Smarty 插件開發:{load_data} 標籤實現模板內直接查詢資料庫

插件檔案:plugins/function.load_data.php

<?php
/**
 * Smarty {load_data} 函數插件
 * 用法:{load_data assign="list" table="test" where="id<100" limit=10}
 */
function smarty_function_load_data($params, &$smarty) {
    // 1. 參數預設與驗證
    $class = !empty($params['class']) ? $params['class'] : 'cls_crud';
    if (empty($params['table'])) {
        trigger_error('{load_data} 缺少必要參數 `table`', E_USER_ERROR);
        return;
    }
    
    // 2. 實例化資料存取物件 (假設支援靜態 factory)
    $db = $class::factory(['table' => $params['table']]);
    
    // 3. 執行查詢
    $where = isset($params['where']) ? $params['where'] : '';
    $limit = isset($params['limit']) ? (int)$params['limit'] : 10;
    $data = $db->get_block_list([$where], $limit);
    
    // 4. 指定 assign 則賦值給模板變數,否則直接輸出(視需求)
    if (!empty($params['assign'])) {
        $smarty->assign($params['assign'], $data);
    } else {
        // 直接輸出模式(較少用)
        foreach ($data as $row) {
            echo implode(', ', $row) . "
\n"; } } }

模板使用範例

{* 載入並賦值給 $list *}
{load_data assign="list" table="articles" where="status=1" limit=5}
{foreach from=$list item=row}
    <h3>{$row.title}</h3>
    <p>{$row.summary}</p>
{/foreach}

{* 直接輸出模式 *}
{load_data table="ads" where="position='sidebar'" limit=3}

進階:cls_crud 基礎類別範例

class cls_crud {
    protected $table;
    protected $pdo;
    
    public static function factory($config) {
        $obj = new static();
        $obj->table = $config['table'];
        $obj->pdo = Database::getConnection(); // 單例 PDO
        return $obj;
    }
    
    public function get_block_list($where = [], $limit = 10) {
        $sql = "SELECT * FROM `{$this->table}`";
        if ($where) $sql .= " WHERE " . implode(' AND ', $where);
        $sql .= " LIMIT " . (int)$limit;
        
        $stmt = $this->pdo->query($sql);
        return $stmt->fetchAll(PDO::FETCH_ASSOC);
    }
}

安全性強化(必要)

function smarty_function_load_data($params, &$smarty) {
    // ... 前略 ...
    
    // 1. SQL 注入防護:where 條件白名單或參數化
    $allowedColumns = ['id', 'status', 'category', 'created_at']; // 需配合模型定義
    $whereClause = '';
    if (!empty($params['where'])) {
        // 簡易解析:僅允許 column=value 形式
        // 生產環境建議使用查詢建構器或 ORM
        $whereClause = sanitizeWhere($params['where'], $allowedColumns);
    }
    
    // 2. 限制最大 limit
    $limit = min((int)($params['limit'] ?? 10), 100);
    
    // 3. 權限控制:敏感表禁止直接載入
    $forbiddenTables = ['users', 'admin_logs', 'payments'];
    if (in_array($params['table'], $forbiddenTables)) {
        trigger_error('禁止直接載入敏感資料表', E_USER_WARNING);
        return;
    }
    
    // ... 查詢與賦值 ...
}

優缺點權衡

優點缺點
減少控制器樣板代碼SQL 邏輯分散在模板,難以維護
區塊化複用(側邊欄、推薦位)效能難以監控(N+1 查詢風險)
設計師可自主調整資料來源破壞 MVC 分層,測試困難
集中處理快取、過濾、權限模板編譯錯誤難以除錯

現代替代方案

  • View Composer / View Model:Laravel View Composers、Yii View Params
  • 片段快取:{cache lifetime=300}...{/cache} 搭配控制器預載
  • AJAX 區塊載入:前端請求 API,獨立快取策略
  • GraphQL / API Gateway:前端聲明式查詢,後端統一解析
copyright © 萬盛學電腦網 all rights reserved