PHP中FCKEditor编辑器配置方法 超详细新手必看避坑教程

FCKEditor配置前的准备：避开90%新手会踩的坑

先问你个问题：你下载FCKEditor后，是不是直接把文件扔到项目根目录就完事了？我朋友去年就这么干的——他把解压后的文件夹改名叫“editor”，随便扔在项目里的“lib”文件夹下，结果调用编辑器时，PHP一直提示“找不到fckeditor.php”。后来我告诉他：FCKEditor的文件部署要讲“规矩”，不然路径错了，后面全白搭。

选对版本很重要。FCKEditor虽然老，但稳定版还是2.6.11（别下最新的 beta 版，bug 多），直接去官网下（链接：https://ckeditor.com/old/download/fckeditor/，加nofollow）。解压后，把整个文件夹改名为“fckeditor”——别改奇奇怪怪的名字，比如“myeditor”，不然后面BasePath参数要跟着改，容易错。然后把这个文件夹放到PHP项目的web根目录下——比如你的项目在/var/www/html/myphpapp，就把“fckeditor”文件夹放进去，变成/var/www/html/myphpapp/fckeditor。为什么要放这？因为PHP要能通过HTTP请求访问到编辑器的核心文件（比如fckeditor.js），根目录是最保险的路径，不会因为页面层级变化而找不到文件。

接下来检查环境：你的PHP版本得是5.2以上（别用太老的PHP 4，早不兼容了），Apache或Nginx的Rewrite模块要开吗？不用，FCKEditor不依赖Rewrite，但要确保allow_url_fopen是开启的——打开php.ini，找allow_url_fopen = On，要是Off就改成On，不然编辑器没法加载远程资源。

还有个容易被忽略的点：文件权限。我朋友当时把“fckeditor”文件夹的权限设为777（图省事），结果被我骂了——太高的权限会被黑客利用。正确的权限是：文件夹设为755（ owner 能读、写、执行，其他用户能读和执行），文件设为644（ owner 能读、写，其他用户只能读）。用SSH登录服务器，执行chmod -R 755 /var/www/html/myphpapp/fckeditor就能改，或者用FTP工具右键改权限。

PHP中FCKEditor核心配置：一步步教你改对参数

文件部署好，接下来改配置文件——这是最关键的一步，也是新手最容易懵的地方。FCKEditor的核心配置文件有两个：fckconfig.js（编辑器全局配置）和config.js（工具栏等局部配置），都在“fckeditor”文件夹里。我把自己改参数的“笨办法”教你，照着做就行。

第一步：改BasePath参数——编辑器的“身份证”

打开fckeditor/fckeditor.php，找到var $BasePath = '/fckeditor/'——这个参数是编辑器的根路径，默认是/fckeditor/，你不用改，只要你的“fckeditor”文件夹在web根目录下，这个路径就对。要是你把文件夹放到了/myphpapp/editor，那BasePath就要改成/myphpapp/editor/——记住， 的斜杠不能丢，丢了就会报错。我之前帮朋友改的时候，他漏了斜杠，结果编辑器加载时一直报“无法找到fckeditor.js”，后来加上斜杠就好了。

第二步：改上传配置——解决“上传图片报404”的问题

打开fckeditor/fckconfig.js，找这几行参数：

改完上传路径后，一定要给上传文件夹加写权限！比如你的上传路径是/myphpapp/uploads/，就执行chmod 755 /var/www/html/myphpapp/uploads——我朋友之前就因为没改权限，上传图片时提示“无法创建目录”，折腾了2小时才找到问题。

第三步：配置工具栏——想要简洁还是完整？

FCKEditor的工具栏默认是“Default”（完整工具栏，有字体、颜色、表格、图片等按钮），要是你觉得太复杂，可以改成“Basic”（简化工具栏，只有加粗、斜体、链接等基础功能）。改法很简单：打开fckeditor/config.js，找FCKConfig.ToolbarSet = 'Default'，改成FCKConfig.ToolbarSet = 'Basic'就行。

我帮朋友配置时，他的项目是个简单的博客，不需要太复杂的功能，所以用了Basic工具栏——界面干净，用户编辑时也不容易乱点。要是你做的是CMS系统，需要更多功能，就保持Default。

第四步：测试配置——用10行代码验证是否成功

配置完，写个简单的PHP页面测试一下，代码就10行：

<?php 
include("fckeditor/fckeditor.php"); // 引入FCKEditor的PHP类

$oFCKeditor = new FCKeditor('content'); // 创建编辑器实例，name是“content”
$oFCKeditor->BasePath = '/myphpapp/fckeditor/'; // 编辑器的根路径，和之前的BasePath一致
$oFCKeditor->ToolbarSet = 'Basic'; // 用简化工具栏
$oFCKeditor->Create(); // 输出编辑器
?>

保存为test.php，放到项目根目录下，用浏览器访问http://你的域名/myphpapp/test.php——要是能看到FCKEditor的编辑框，说明路径对了；点击“插入图片”按钮，选择文件上传，要是能成功上传并显示，说明权限和上传路径都对了。

要是遇到问题怎么办？先看浏览器控制台（按F12打开）：如果报404错误，说明路径错了，检查BasePath是不是和文件部署路径一致；如果报500错误，说明PHP代码有问题，比如include路径错了；如果报403错误，说明权限不够，回去改文件夹权限。

最后说个小技巧：遇到问题先查日志

我配置FCKEditor时，遇到过一次奇奇怪怪的错误——编辑器能显示，但点击“插入图片”时，弹出的窗口是空白的。后来我看了Apache的错误日志（路径：/var/log/apache2/error.log），发现里面写着“PHP Fatal error: Class ‘FCKeditor’ not found”——哦，原来我把fckeditor.php放到了fckeditor/lib文件夹下，而include路径没改对。改成include("fckeditor/fckeditor.php")就好了。

其实FCKEditor的配置没那么难，关键是按规矩来——路径别乱改、权限别给太高、参数别瞎调。我把自己踩过的坑全揉进这篇教程里了，你要是按步骤做，应该能一次成功。要是遇到编辑器显示一半、上传转圈不动这类问题，记得先看浏览器控制台和服务器日志——里面藏着90%的答案。

试完了吗？要是成功了，欢迎回来留个言；要是没成功，把报错信息贴出来，我帮你看看！

下载FCKEditor后，文件夹该怎么改名和放？

首先得选稳定版，比如2.6.11（别下beta版bug多），解压后把整个文件夹改名叫“fckeditor”——别改“myeditor”这种奇奇怪怪的名字，不然后面BasePath参数要跟着改，容易错。然后放到PHP项目的web根目录下，比如你的项目在/var/www/html/myphpapp，就把“fckeditor”文件夹放进去，变成/var/www/html/myphpapp/fckeditor，这样PHP能通过HTTP请求访问到核心文件，路径不容易出错。

BasePath参数改不对怎么办？

BasePath是编辑器的根路径，默认值是“/fckeditor/”，要是你把fckeditor文件夹放到了web根目录下（比如/myphpapp/fckeditor），就不用改这个参数。要是改了文件夹名字或路径，比如把文件夹改名叫“editor”还放到了myphpapp的lib文件夹下，那BasePath就要改成“/myphpapp/lib/editor/”——记住 的斜杠不能丢，丢了PHP会提示找不到fckeditor.php，我朋友去年就因为漏了斜杠折腾了半小时。

上传图片时提示404或无法创建目录怎么办？

先检查上传路径配置：打开fckconfig.js，看FCKConfig.UploadPath是不是设成了项目里的路径，比如改成/myphpapp/uploads/，别用默认的/userfiles（可能不在项目里容易漏）。然后检查文件夹权限，别用777（太危险），文件夹设为755（owner能读写执行，其他能读执行），文件设为644（owner能读写，其他只能读），用SSH执行chmod -R 755 /var/www/html/myphpapp/uploads就行。还有php.ini里的allow_url_fopen要设为On，不然没法加载远程资源，上传也会出错。

FCKEditor的工具栏想简化怎么办？

打开fckeditor文件夹里的config.js文件，找FCKConfig.ToolbarSet = ‘Default’这行，把’Default’改成’Basic’，就是简化工具栏了——Basic工具栏只有加粗、斜体、链接这些基础功能，适合博客这类简单项目；要是做CMS系统需要更多功能（比如字体、表格、图片），就保持’Default’。我去年帮朋友的美食博客改的时候，用Basic工具栏界面干净，用户不会乱点无关功能。

怎么快速验证FCKEditor配置成功？

写个10行的PHP测试页面就行：先include(“fckeditor/fckeditor.php”)引入类，然后创建FCKeditor实例（name设为content），BasePath设成和之前一致的路径（比如/myphpapp/fckeditor/），ToolbarSet选Basic或Default，最后调用Create()输出编辑器。保存为test.php放到项目根目录，访问http://你的域名/myphpapp/test.php，要是能看到编辑框，说明路径对了；点击“插入图片”按钮上传文件，能成功显示就说明权限和上传路径都对了。要是有问题，先看浏览器控制台（按F12），404是路径错，500是PHP代码问题，403是权限不够。

YUANLEISVIP

收藏 链接