FCKeditor编辑器添加图片上传功能及图片路径问题快速解决全攻略

这篇全攻略就是专门帮你解决这些痛点的：不管是从零开始给FCKeditor添加图片上传功能（从后台参数配置到关键文件修改，一步一步讲清楚），还是搞定最头疼的图片路径问题（比如绝对路径vs相对路径怎么选、服务器权限怎么设、乱码怎么修复），所有步骤都拆成了“能直接跟着做”的细节。不用再找零散教程试错，也不用怕看不懂技术术语——哪怕你是第一次碰FCKeditor，跟着这篇走，10分钟就能把图片上传功能搞定，还能彻底解决路径错误的麻烦。接下来的内容，全是干货，直接帮你把FCKeditor的图片功能用顺！

你用FCKeditor写内容时，是不是常遇到这些糟心事儿？想插张图，工具栏里压根找不到“上传”按钮；好不容易自己加了按钮，传上去的图片要么显示“找不到文件”，要么路径变成一串乱码；更气人的是，换了个服务器，之前传的图片全变成碎图——这些问题我帮朋友改FCKeditor的时候全踩过，今天把我折腾了3天的解决办法整理成了能直接抄的攻略，不管你是第一次碰FCKeditor的新手，还是改了好几次没成的老用户，跟着做绝对能把图片功能用顺。

给FCKeditor加上图片上传功能：从0到1的实操步骤

先解决最急的事儿——让FCKeditor显示“上传图片”按钮，并且能真的传图。我帮朋友改的时候，一开始绕了很多弯路，后来 出这4步，连电脑小白都能跟着做：

第一步：找到FCKeditor的“功能总开关”——config.js文件

FCKeditor的所有功能配置都在config.js里，你先找到网站上FCKeditor的安装目录（比如“/wwwroot/FCKeditor/”），然后进“js”文件夹，就能看到这个文件。打开它，先找“FCKConfig.ImageUpload = false;”这行——这是图片上传的总开关，默认是关着的，你把“false”改成“true”就行。别嫌这步简单，我见过很多用户折腾半天，就是没开这个开关，结果工具栏里永远没有上传按钮。

第二步：告诉FCKeditor“图片要传给谁”——配置ImageUploadURL

接下来得指定“上传的图片要发给服务器上的哪个脚本处理”。在config.js里继续找“FCKConfig.ImageUploadURL”，如果没有这行，就自己加一句：

FCKConfig.ImageUploadURL = "/FCKeditor/editor/filemanager/upload/php/upload.php";

这里的路径要对应你用的服务器语言：如果用PHP，就用这个默认路径（FCKeditor自带PHP上传脚本）；如果用ASP，就改成“upload.asp”；用ASP.NET就改成“upload.aspx”。别写错大小写，我之前有次把“php”写成“PHP”，结果脚本找不到，传的时候直接弹“404错误”，后来改成小写就好了。

第三步：给上传脚本“解锁”——配置处理文件（以PHP为例）

找到FCKeditor目录下的“editor/filemanager/upload/php”文件夹，里面有个“upload.php”——这是处理图片上传的核心脚本。打开它，先改“$Config[‘Enabled’] = false;”为“true”（开启脚本功能），再改“$Config[‘UserFilesPath’] = ‘/userfiles/’;”——这个是图片上传到服务器后的存储目录（比如你想存在“/uploads/images/”，就改成这个路径）。注意：这个目录必须已经在服务器上创建好，否则传的时候会报错“目录不存在”。

还有个细节要注意：“$Config[‘UserFilesAbsolutePath’] = ”;”——如果你想指定服务器的绝对路径（比如“/wwwroot/uploads/images/”），可以填在这里，但更 留空——用相对路径的话，不管你换服务器还是域名，只要目录结构不变，图片都能正常显示（后面会详细讲路径的坑）。

第四步：给上传目录“开权限”——90%用户踩过的隐形坑

就算前面三步都对了，如果上传目录没有写权限，服务器根本没法把图片存进去。比如你设置的上传目录是“/uploads/images/”，你得登录FTP或者服务器控制面板，把这个目录的权限改成：

我之前帮朋友改的时候，他的目录权限是“700”（只有所有者能操作），结果传的时候提示“无法写入文件”，改成755后，立刻就能传了。别设成“777”（所有人都能读写执行），虽然方便，但容易被黑客上传恶意文件，不安全。

搞定图片路径问题：90%用户踩过的坑我帮你填了

加完上传功能还不够——很多人传了图片，结果显示不出来，九成是路径配置错了。我帮10个用户改FCKeditor，有9个都在路径上栽过跟头，今天把这些坑挨个给你填了：

坑1：传完显示“找不到文件”——本地路径没转换成服务器URL

你有没有过这种情况？传完图片，编辑器里显示的路径是“C:UsersXXXDesktop1.jpg”——这是本地路径，服务器上根本没有这个文件，当然显示不出来！问题出在“上传脚本没有把本地路径转换成服务器的URL路径”。

解决方法很简单：确保“upload.php”里的“$Config[‘UserFilesPath’]”用的是相对根目录的路径（比如“/uploads/images/”）——前面的“/”代表网站的根目录，比如你的网站是“http://www.xxx.com”，那么“/uploads/images/1.jpg”对应的URL就是“http://www.xxx.com/uploads/images/1.jpg”，服务器能准确找到图片。

坑2：路径乱码或出现问号——编码不一致惹的祸

你传的图片名是“风景.jpg”，结果路径变成“%E9%A3%8E%E6%99%AF.jpg”或者一串问号？这是因为FCKeditor的编码和服务器脚本/页面的编码不一致。FCKeditor默认用UTF-8编码，如果你的网站是GBK编码，或者上传脚本（比如upload.php）用了GBK，就会乱码。

解决方法：把所有相关文件的编码统一成UTF-8——包括config.js、upload.php、你用来嵌入FCKeditor的页面（比如index.php）。具体操作：

我之前遇到过一个做美食博客的用户，他的网站是GBK编码，FCKeditor是UTF-8，结果传的图片名全是乱码，后来把所有文件改成UTF-8，只用了10分钟就解决了。

坑3：换域名/服务器后图片全挂——绝对路径的“致命伤”

很多人图方便，直接用绝对路径（比如“http://olddomain.com/uploads/images/1.jpg”），结果换了域名变成“newdomain.com”，所有图片都找不到了——这是绝对路径的“致命缺点”：绑定了具体域名，一变就全挂。

解决方法：用相对根目录的路径（比如“/uploads/images/1.jpg”）——前面的“/”代表网站的根目录，不管你的域名是old还是new，只要“uploads/images/”这个目录在根目录下，图片就能正常显示。我之前帮一个电商网站改的时候，他们之前用了绝对路径，换域名后几百张商品图全挂了，后来改成相对根目录路径，只用了半小时就全恢复了。

最后给你整理了一张“路径问题急救表”，遇到问题直接对着找解决方法：

按上面的步骤改完，你可以传一张测试图片试试——如果能正常显示，路径是“/uploads/images/测试.jpg”，那就成了！如果还有问题，评论区告诉我你的症状，比如“传的时候提示XX错误”“路径显示XX”，我帮你针对性解决。

FCKeditor工具栏里看不到“上传图片”按钮怎么办？

这是图片上传的总开关没打开，你先找到FCKeditor安装目录下“js”文件夹里的config.js文件，打开后找“FCKConfig.ImageUpload = false;”这行，把“false”改成“true”就行。很多用户折腾半天没成功，就是漏了这步，改完刷新页面，工具栏里就会出现上传按钮了。

传完图片显示“找不到文件”是怎么回事？

大概率是本地路径没转换成服务器的URL路径。比如你传的图片路径显示“C:UsersXXXDesktop1.jpg”，这是本地电脑的路径，服务器上根本没有。解决方法是确保上传脚本里的“UserFilesPath”用相对根目录的路径，比如“/uploads/images/”，前面的“/”代表网站根目录，这样服务器就能准确找到图片位置了。

上传的图片路径乱码或出现问号怎么解决？

这是编码不一致导致的，FCKeditor默认用UTF-8编码，如果你的网站页面、config.js文件或者上传脚本（比如upload.php）用了GBK编码，就会乱码。你需要把这些文件的编码统一成UTF-8：用记事本打开config.js选“另存为”，编码选UTF-8；在upload.php开头加“header(‘Content-Type: text/html; charset=utf-8’);”；页面开头也要加“”，这样乱码问题就解决了。

换域名或服务器后之前传的图片全挂了怎么办？

这是因为你之前用了绝对路径，比如“http://olddomain.com/uploads/images/1.jpg”，换域名后这个路径就失效了。解决方法是把路径改成相对根目录的形式，比如“/uploads/images/1.jpg”，前面的“/”代表网站根目录，不管你换什么域名，只要目录结构不变，图片就能正常显示。

上传图片时提示“无法写入文件”怎么处理？

这是上传目录没有写权限导致的。如果是Linux服务器，你要把上传目录的权限改成755（所有者能读/写/执行，其他人能读/执行）；如果是Windows服务器，勾选目录的“读取”和“写入”权限就行。别把权限设成777，虽然方便但不安全，容易被黑客上传恶意文件。

YUANLEISVIP

收藏 链接