Yii2 整合 Redactor 富文本編輯器完整教程

Redactor 為強大輕量的富文本編輯器，官方提供 Yii2 擴充套件 yiidoc/yii2-redactor，體驗優於 UMeditor。

安裝與配置

1. Composer 安裝：composer require yiidoc/yii2-redactor
2. 模組配置（config/main.php）：

'modules' => [
    'redactor' => [
        'class' => 'yii\redactor\RedactorModule',
        'uploadDir' => '@webroot/uploads',      // 檔案儲存目錄
        'uploadUrl' => '@web/uploads',          // 公開訪問 URL
        'imageAllowExtensions' => ['jpg','png','gif'],
    ],
],

3. View 中使用：

ActiveField 形式：

field($model, 'content')->widget(\yii\redactor\widgets\Redactor::className()) ?>

獨立 Widget 形式：

 $model,
    'attribute' => 'content'
]) ?>

進階自訂

• 自訂上傳路由：在 clientOptions 指定 imageUpload、fileUpload、imageManagerJson。
• 語言與外掛：lang => 'zh_cn'，plugins => ['clips','fontcolor','imagemanager']。外掛列表見 vendor/yiidoc/yii2-redactor/assets/plugins。
• 權限控制：Redactor 以模組形式掛載，若專案有 RBAC，需為上傳路由（/redactor/upload/*）授權。
• PHP 擴充需求：確保 fileinfo 擴充已啟用（php.ini 取消註解 extension=fileinfo）。

配置完成即可享受流暢的編輯體驗與圖片管理功能。