萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 整合 FCKeditor 2.3.2 完整配置指南:中文介面、字型、皮膚、上傳設定

編輯器簡介

FCKeditor (後更名為 CKEditor 3+) 曾是經典富文本編輯器。2.3.2 版支援檔案上傳、多語言、皮膚切換。本文記錄 PHP 環境整合步驟。

安裝與清理

  1. 下載解壓至專案目錄 `FCKeditor/`
  2. 刪除不需檔案:`_samples/`, `_testcases/`, `*.asp`, `*.jsp`, `*.cfm`, `*.pl` 等非 PHP 連接器。

核心配置:fckconfig.js

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/'; // 實體路徑,需寫入權限

編輯區域 CSS (editor/css/fck_editorarea.css)

body, td {
    font-family: "微軟正黑體", "新細明體", Arial, Verdana, Sans-Serif;
    font-size: 14px;
    color: #333;
    background-color: #fff;
    margin: 10px;
}

PHP 端整合範例

<?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
?>

檔案上傳連接器配置 (connectors/php/config.php)

$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);
}

遷移建議:升級至 CKEditor 4/5

版本狀態PHP 整合現代特性
FCKeditor 2.x停止維護 (2010)舊版 fckeditor.php無
CKEditor 4LTS 維護中`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。

copyright © 萬盛學電腦網 all rights reserved