FCKeditor (現更名為 CKEditor) 是經典的開源 Web 富文本編輯器,支援 Java/.NET/PHP 等後端。本文記錄 JSP 環境下的完整整合流程:從下載、部署、web.xml 配置、標籤庫使用,到生產環境瘦身優化與前台安全配置。
官網下載兩個套件:
FCKeditor_2.x.zip → 解壓後的 FCKeditor/ 目錄FCKeditor-2.x.zip → 含 WEB-INF/lib (JAR)、WEB-INF/web.xml (Servlet 定義)、_samples/ (範例)FCKeditor/ 整個目錄複製到 Web 應用根目錄WEB-INF/lib 複製所有 JAR 到專案 WEB-INF/libWEB-INF/web.xml 複製 Servlet 定義到專案 web.xml,修改 url-pattern 前綴:<servlet-mapping>
<servlet-name>Connector</servlet-name>
<url-pattern>/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>SimpleUploader</servlet-name>
<url-pattern>/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>Connector</servlet-name>
<url-pattern>/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>SimpleUploader</servlet-name>
<url-pattern>/FCKeditor/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>
<%@ taglib uri="https://java.fckeditor.net" prefix="FCK" %>
...
<FCK:editor id="content" basePath="/FCKeditor/"
imageBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector"
linkBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Connector=connectors/jsp/connector"
flashBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector"
imageUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Image"
linkUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=File"
flashUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Flash"
>預設內容 </FCK:editor>
_samples, _test, _source 等fckconfig.js, fckeditor.js, fckstyles.xml, fcktemplates.xmleditor/filemanager/upload/ 目錄清空 (上傳處理由 Servlet 處理)editor/skins/ 僅保留 default/ (不需換膚時)editor/lang/ 僅保留 en.js, fcklanguagemanager.js, zh-cn.js, zh.js (中英雙語)瘦身後體積可減少 70% 以上,加快部署與載入速度。
上傳圖片報錯:The output format must have a '{https://xml.apache.org/xalan}content-handler' property!
解決:刪除 WEB-INF/lib/xalan*.jar,避免與 JDK 內建 XML 解析器衝突。
fckconfig.js 定義精簡工具列陣列,移除「圖片」、「Flash」、「表單」、「來源碼」等高風險按鈕FCKeditor 已停止維護,新專案強烈建議直接使用 CKEditor 4/5,架構更現代、安全性更高、支援模組化建構與 npm 整合。