插件檔案: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:前端聲明式查詢,後端統一解析