Yii2整合Xunsearch全文搜索：命名空間兼容性問題與配置實踐

整合步驟

1. 安裝 Xunsearch 服務端（僅 Linux）
2. Composer 安裝 hightman/xunsearch SDK 及 hightman/yii2-xunsearch 擴展
3. 配置 components：

'components' => [
    'xunsearch' => [
        'class' => 'hightman\xunsearch\Connection',
        'iniDirectory' => '@app/config', // 項目配置目錄
        'charset' => 'utf-8',
    ],
],

踩坑記錄

報錯 Unexpected character in input: '\' (ASCII=92) state=1，初以為是 short_open_tag 配置，實際是 PHP 版本過低：Yii2 擴展使用命名空間（PHP 5.3+ 特性），而環境為 PHP 5.2.6。

解決方案

• 升級 PHP 至 5.6+ 或 7.x
• 或手動修改擴展源碼移除命名空間（不推薦，維護成本高）

經驗總結

引入現代擴展前務必檢查 PHP 版本要求，避免因語法特性導致不可預期的解析錯誤。