Agavi MVC 框架實戰第 5 部分：分頁、文件上傳與自定義驗證器

系列回顧

前 4 部分已構建功能完整的 Web Automobiles Sales Platform (WASP)：管理模塊、搜索引擎、XML 輸出。本文補充實戰中不可或缺的進階技術。

核心內容

1. 數據庫記錄排序與分頁

管理模塊列表頁 https://wasp.localhost/admin/listing/index 實現：

• 欄標題點擊排序（ASC/DESC 切換）
• 分頁導航組件
• 每頁記錄數可配置

2. 文件上傳支持

• Web 表單 enctype="multipart/form-data"
• Agavi 內建 sfFileValidator 驗證文件類型、大小
• 上傳後處理：重命名、移動、權限設置、數據庫記錄

3. 自定義輸入驗證器

• 繼承 AgaviValidator 基類
• 實現 validate() 方法，包含業務邏輯校驗
• 註冊到驗證器鏈，支持錯誤消息國際化
• 示例：VIN 碼格式驗證、價格區間驗證、唯一性檢查

Agavi 內置工具優勢

• 分頁器：AgaviPager 自動處理 OFFSET/LIMIT、總數統計、URL 生成
• 文件上傳：AgaviRequestDataHolderFile 封裝 $_FILES，安全便捷
• 驗證框架：聲明式配置 + 程序化擴展，覆蓋 90%+ 場景

掌握這三大技術，可構建生產級健壯的 Agavi 應用。