ThinkPHP 3.2 整合 YAML 設定檔完整步驟

ThinkPHP 3.2 原生支援 YAML 設定檔，但需額外安裝 Spyc 解析器。本文記錄完整整合流程與坑點。

為何選 YAML

• 語法簡潔、可讀性高
• 支援註解、多行字串、錨點引用
• 比 PHP 陣列、INI、XML 更適合人工維護

步驟 1：定義設定副檔名

// 入口檔 index.php
define('CONF_EXT', '.yaml');

步驟 2：將所有 config.php 改為 config.yaml

Application/
  Common/Conf/config.yaml
  Home/Conf/config.yaml
  Admin/Conf/config.yaml

步驟 3：安裝 Spyc 解析器

ThinkPHP 內建 yaml_parse_file() 會嘗試 vendor('spyc.Spyc') 載入 Spyc。

1. 下載：Spyc GitHub
2. 建立目錄：ThinkPHP/Library/Vendor/spyc/
3. 將 Spyc.php 放入上述目錄

步驟 4：驗證

重新整理專案，不再出現 Class 'Spyc' not found，即完成整合。

YAML 設定檔範例

# config.yaml
app_debug: true
url_model: 2
db_config:
  type: mysql
  host: 127.0.0.1
  name: mydb
  user: root
  pass: secret
  prefix: tp_
cache:
  type: Redis
  host: 127.0.0.1
  port: 6379

常見問題

• 大小寫敏感：Linux 下目錄 spyc 必須小寫
• 命名空間：Spyc 類別無命名空間，直接 Spyc::YAMLLoad()
• 快取：修改 YAML 後需清除 ThinkPHP Runtime 快取

現代替代：ThinkPHP 5/6/8

新版內建 symfony/yaml，無需額外安裝，直接設定 config.yaml 即可使用。

掌握 YAML 整合，讓專案設定更優雅易維護。