PHP中使用FCKeditor编辑器

PHP中使用FCKeditor编辑器
1、概述
FCKeditor 是目前最优秀的可见即可得网页编辑器之一，它采用JavaScript编写。

具备功能强大、配置容易、跨浏览器、支持多种编程语言、开源等特点。

它非常流行，互联网上很容易找到相关技术文档，国内许多WEB项目和大型网站均采用了FCKeditor（如百度，阿里巴巴）。

本文将通过与 PHP相结合，从基本安装到高级的配置循序渐进介绍给广大PHPer。

FCKeditor官方网站：/
FCKeditor Wiki：/
2、下载FCKeditor
登录FCKeditor官方站（），点击网站右上角“Download”链接。

注意：当点击“FCKeditor_2.4.3.zip”链接后，将跳转到网站上自动下载。

如果您当前使用Linux或Unix系统，可以点击
“FCKeditor_2.4.3.tar.gz”链接下载.tar.gz格式的压缩包。

3、安装FCKeditor
解压“FCKeditor_2.4.3.zip”文档到您的网站目录下，我们先假定您存放FCKeditor和调用脚本存于同一个目录下。

fckeditor 目录包含FCKeditor2.4.3程序文件。

check.php用于处理表单数据。

add_article.php和 add_article_js.html分别是PHP调用FCKeditor和JavaScript调用FCKeditor实例脚本文件。

3.1、用PHP调用FCKeditor
调用FCKeditor必须先载入FCKeditor类文件。

具体代码如下。

PHP代码:
<?php
include("fckeditor/fckeditor.php") ; // 用于载入FCKeditor类文件
?>
接下来，我们需要创建FCKeditor实例、指定FCKeditor存放路径和创建（显示）编辑器等。

具体代码如下所示（代码一般放在表单内）。

PHP代码:
<?php
$oFCKeditor = new FCKeditor('FCKeditor1') ; // 创建FCKeditor实例
$oFCKeditor->BasePath = './fckeditor/'; // 设置FCKeditor目录地址$FCKeditor->Width='100%'; //设置显示宽度
$FCKeditor->Height='300px'; //设置显示高度的高度
$oFCKeditor->Create() ; // 创建编辑器
?>
下面是笔者创建好的实例代码，您可将代码保存为add_article.php
通过浏览里打开http://127.0.0.1/add_article.php 查看FCKeditor安装效果。

FCKeditor安装成功！
注意：如果您想将FCKeditor创建为HTML结果代码，以便于在模板引擎里面调用（如Smarty）可使用如下代码。

$output = $oFCKeditor->CreateHtml() ;
现在，您可通过POST方式获得编辑器的变量值。

本例将表单的action设置为check.php，您可在check.php里使用代码
$fckeditorValue = $_POST['FCKeditor1'];
获得编辑器的变量值了。

FCKeditor安装成功了。

但是，我们还可以通过更多设置来使FCKeditor更加灵活人性化。

具体方法文本后面介绍。

FCKeditor常用设置FCKeditor已经安装成功了，也可以使用了。

但是我们可以通过一些简单的设置使FCKeditor更加符合您的项目需求。

设置工具栏很简单，只需打开fckeditor目录下面的fckconfig.js文件，按CTRL+F搜索FCKConfig.ToolbarSets["Default"]代码，找到如下代码。

XML/HTML代码
['Source','DocProps','-','Save','NewPage','Preview','-','Templates'] ,
['Cut','Copy','Paste','PasteText','PasteWord','-','Print','SpellChec k'],
['Undo','Redo','-','Find','Replace','-','SelectAll','RemoveFormat'],
['Form','Checkbox','Radio','TextField','Textarea','Select','Button', 'ImageButton','HiddenField'],
'/',
['Bold','Italic','Underline','StrikeThrough','-','Subscript','Supers cript'],
['OrderedList','UnorderedList','-','Outdent','Indent'],
['JustifyLeft','JustifyCenter','JustifyRight','JustifyFull'],
['Link','Unlink','Anchor'],
['Image','Flash','Table','Rule','Smiley','SpecialChar','PageBreak'], '/',
['Style','FontFormat','FontName','FontSize'],
['TextColor','BGColor'],
['FitWindow','-','About']
]
在默认情况下，FCKeditor会调用上面定义的所有工具栏按钮。

大家可以根据自己的需求进行设置。

表1对上面的配置选项功能说明进行汇总。

代码名称功能代码名称功能Source源代码DocProps页面属性
-｜分隔符Save保存
NewPage新建Preview预览
Templates模板Cut剪切
Copy复制Paste粘贴
PasteText粘贴为无格式文本PasteWord从MS Word粘贴Print打印SpellCheck拼写检查
Undo撤消Redo重做
Find查找Replace替换
SelectAll全选RemoveFormat清除格式
Form表单Checkbox复选框
Radio单选框TextField单行文本Textarea多行文本Select列表菜单
Button按钮ImageButton图像域HiddenField隐藏域Bold加粗
Italic倾斜Underline下划线
StrikeThrough删除线Subscript下标
Superscript上标OrderedList 插入／删除编号列表
UnorderedList 插入／删除项目列
表
Outdent减少缩进
Indent增加缩进JustifyLeft左对齐JustifyCenter居中对齐JustifyRight右对齐JustifyFull两端对齐Link插入／编辑链接
Unlink取消链接Anchor 插入／编辑锚点链接
Image插入编辑图像Flash插入／编辑Flash Table插入／编辑表格Rule插入水平线Smiley插入表情SpecialChar插入特殊符号PageBreak插入分页Style样式
FontFormat格式FontName字体
FontSize大小TextColor文本颜色BGColor背景颜色FitWindow全屏编辑
About关于Fuckeditor
表1：工具栏配置选项功能进行汇总
配置上传
要使您的FCKeditor能够使用上传功能，您必须进行以下配制。

注意：FCKeditor不支持虚拟目录，您的路径设置都是针对网站根目录的绝对路径而言的。

这点对于发布到远程网站目录的开发者极为不便，后面我们会对此进行讨论。

一、打开fckeditor\editor\filemanager\upload\php\config.php，找到代码$Config['Enabled']，将值设置为true。

二、接下来几行，设置$Config['UserFilesPath']，设置上传路径。

三、打开fckeditor\fckconfig.js文件，找到代码_FileBrowserLanguage，将值设置为php。

接下来一行，把_QuickUploadLanguage值也设置为php。

配置文件浏览
一、打开
fckeditor\editor\filemanager\browser\default\connectors\php\config.p hp
找到代码$Config['Enabled']，将值设置为true;
二、接下来几行，设置$Config['UserFilesPath']，设置浏览路径。

关于上传\文件浏览安全性问题
为了解决FCKeditor不支持虚拟目录问题，和FCKeditor文件上传的安全性考良。

我们有必要在这里单论对此进行讨论。

打开fckeditor\editor\filemanager\upload\php\config.php，找到$Config['UserFilesPath']代码，在此行代码之前定义变量$root_path =
$_SERVER['PHP_SELF'];
重新设置$Config['UserFilesPath']变量的值，示例如下。

$Config['UserFilesPath'] = $root_path . '您想上传的目录名/' ;
打开fckeditor\editor\filemanager\browser\default\connectors\php
\config.php，找到代码$Config['UserFilesPath'],在此行代码之前定义变量$root_path = $_SERVER['PHP_SELF'];
重新设置$Config['UserFilesPath']变量的值，示例如下。

$Config['UserFilesPath'] = $root_path . '您想浏览的目录名/'
至此，您的FCKeditor已解决不支持虚拟目录问题。

接下来，我们介绍一种技巧配置只允许管理员才可以使用FCKeditor上传问题。

解决方法其实很简单，假如网站采用$_SESSION['admin_id']验证管理员的登录id，您只需将相关的脚本文件引入即可。

然后使用下面的代码配置文件上传\浏览开关。

精简FCKeditor文件空间大小
FCKeditor目录下面包含有许多示例代码，文档等资源，在我们的WEB项目正式发布式前，这些文件不但没有任何意义，反而会占用相当大的空间。

下面我们介绍如何删除这些文件。

一：删除所有以“_”开头的文件夹
二：删除fckeditor目录下面除fckconfig.js、fckeditor.js、fckeditor.php、fckeditor_php4.php、fckeditor_php5.php、fckpackager.xml、fckstyles.xml、fcktemplates.xml、editor目录以外的所有文件（即，只保留刚才提到的几个文件和一个目录）。

三：进入fckeditor\editor\filemanager\browser\default\connectors文件夹，只保留PHP文件夹和test.html文件。

四：进入fckeditor\editor\filemanager\upload文件夹，只保留PHP文件夹和test.html文件。

五：进入fckeditor\editor文件夹，这个目录下面是一些语言包文件。

除保留_getfontformat.html、 _translationstatus.txt、en.js、zh.js、zh-cn.js 外，其它语言包对国内项目来说意义不大，可以删除。

六：进入fckeditor\editor\skins文件夹，该文件夹保存FCKeditor文件，如果您不想用可以删除。