FCKeditor (後更名為 CKEditor 3+) 曾是經典富文本編輯器。2.3.2 版支援檔案上傳、多語言、皮膚切換。本文記錄 PHP 環境整合步驟。
FCKConfig.AutoDetectLanguage = true; // 自動偵測瀏覽器語言
FCKConfig.DefaultLanguage = 'zh-cn'; // 預設繁/簡中文
FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/default/'; // 皮膚
FCKConfig.ToolbarStartExpanded = true; // 工具列預設展開
// 中文字型支援 (關鍵)
FCKConfig.FontNames = '標楷體;微軟正黑體;新細明體;細明體;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana';
// 檔案上傳連接器 (PHP)
FCKConfig.LinkBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=File&Connector=connectors/php/connector.php';
FCKConfig.ImageBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Image&Connector=connectors/php/connector.php';
FCKConfig.FlashBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/php/connector.php';
// 上傳目錄 (相對 DocumentRoot)
FCKConfig.UserFilesPath = '/userfiles/';
FCKConfig.UserFilesAbsolutePath = '/var/www/html/userfiles/'; // 實體路徑,需寫入權限
body, td {
font-family: "微軟正黑體", "新細明體", Arial, Verdana, Sans-Serif;
font-size: 14px;
color: #333;
background-color: #fff;
margin: 10px;
}
<?php
require_once 'FCKeditor/fckeditor.php';
$oFCK = new FCKeditor('content');
$oFCK->BasePath = '/FCKeditor/';
$oFCK->Value = $defaultContent; // 從 DB 讀取
$oFCK->Height = 400;
$oFCK->ToolbarSet = 'Basic'; // 或 'Default'
$oFCK->Create(); // 輸出 HTML
?>
$Config['Enabled'] = true;
$Config['UserFilesPath'] = '/userfiles/';
$Config['UserFilesAbsolutePath'] = $_SERVER['DOCUMENT_ROOT'] . '/userfiles/';
// 允許副檔名
$Config['AllowedExtensions']['File'] = ['pdf','doc','docx','xls','xlsx','zip','rar'];
$Config['DeniedExtensions']['File'] = ['php','php3','php5','phtml','asp','aspx','jsp','exe','sh'];
$Config['AllowedExtensions']['Image'] = ['jpg','jpeg','png','gif','webp'];
$Config['DeniedExtensions']['Image'] = [];
// 檔案大小限制 (bytes)
$Config['MaxFileSize'] = 5 * 1024 * 1024; // 5MB
// 安全:驗證 MIME (需 fileinfo 擴充)
function CheckFileType($filePath, $mimeType) {
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$detected = finfo_file($finfo, $filePath);
finfo_close($finfo);
return in_array($detected, ['image/jpeg','image/png','image/gif','image/webp','application/pdf'], true);
}
| 版本 | 狀態 | PHP 整合 | 現代特性 |
|---|---|---|---|
| FCKeditor 2.x | 停止維護 (2010) | 舊版 fckeditor.php | 無 |
| CKEditor 4 | LTS 維護中 | `ckeditor/ckeditor4` Composer 套件 | Widget、圖片上傳外掛、Accessibility |
| CKEditor 5 | 主力開發 | `ckeditor/ckeditor5-build-classic` + 自訂建構 | Real-time collaboration、現代架構、ES6 模組 |
新專案請直接採用 **CKEditor 5**,透過 npm/Composer 管理,配置檔為 JSON/JS 模組,支援 TypeScript、React/Vue/Angular 整合。
FCKeditor 2.3.2 配置重點在於 `fckconfig.js` 語系/字型/上傳路徑、連接器 `config.php` 安全設定、編輯區 CSS 字型回退。若維護舊專案請做好輸入過濾 (HTMLPurifier) 與上傳驗證;新專務請遷移至 CKEditor 5。