ueditor如何调用织梦文件管理器？

核心原理

UEditor 的图片、视频、附件等上传功能，默认是调用它自带的 controller.php 文件，要让它调用织梦的文件管理器,我们需要做两件事：

1. 修改 UEditor 的配置：告诉 UEditor，当用户点击“上传图片”等按钮时，不要走自己的上传流程,而是跳转到织梦文件管理器的指定页面。
2. 修改织梦文件管理器：确保织梦文件管理器在用户选择完文件后，能以 UEditor 能识别的格式（通常是 JSON）将文件的路径等信息返回给 UEditor。

准备工作

1. 确认文件路径：你需要知道你的 UEditor 文件夹和织梦文件管理器文件夹在你的网站根目录下的具体位置。

   • UEditor 路径：通常为 /ueditor/
   • 织梦文件管理器路径：通常为 /dede/file_manager/

2. 备份文件：在修改任何文件之前，务必备份以下关键文件：

   • UEditor 的 ueditor.config.js
   • 织梦文件管理器的 include/dialog/select_soft_post.php (或类似名称的文件,这是处理选择并返回数据的核心文件)

详细操作步骤

第 1 步：修改 UEditor 的配置文件 (ueditor.config.js)

这是最关键的一步，我们需要找到 UEditor 的服务器端配置项，并修改其 imageActionName、imageFieldName 等配置,使其指向织梦的处理脚本。

打开 ueditor.config.js 文件，找到 serverUrl 相关的配置段（通常在文件末尾）。

原始配置可能如下：

// serverUrl 用于指定上传文件的服务器端接口路径
, serverUrl: URL + "php/controller.php" 

修改后的配置如下：

我们将 serverUrl 指向织梦文件管理器中处理文件选择并返回数据的脚本，这个脚本通常是 select_soft_post.php。

// serverUrl 用于指定上传文件的服务器端接口路径
// 将其指向织梦文件管理器的处理脚本
, serverUrl: URL + "../dede/file_manager/include/dialog/select_soft_post.php" 
// 以下是一些可选的配置，确保它们与织梦返回的数据格式兼容
, imageActionName: "uploadImage" // Uditor会向serverUrl发送这个action参数
, imageFieldName: "filedata"     // Uditor会向serverUrl发送这个文件域参数名
, imageMaxSize: 2048000          // 2M
, imageAllowFiles: [".png", ".jpg", ".jpeg", ".gif", ".bmp"] // 允许的图片类型

配置解释：

• serverUrl: 这是最重要的修改。URL 是 UEditor 初始化时的基础路径，../dede/file_manager/ 是相对于 UEditor 根目录的相对路径,请根据你的实际路径进行调整。
• imageActionName, imageFieldName: 这些参数是 Uditor 发送请求时附加在 URL 上的，织梦的 select_soft_post.php 默认就能识别这些参数，所以通常不需要修改织梦的代码来接收它们，它会检查 activepath (当前目录), img (是否只显示图片), f (是否只显示Flash) 等参数。

第 2 步：修改织梦文件管理器的返回数据格式

织梦文件管理器默认返回的数据格式可能不是 UEditor 标准的 JSON 格式，我们需要修改处理返回数据的文件，确保它返回一个 UEditor 能正确解析的 JSON 对象。

打开织梦文件管理器目录下的 include/dialog/select_soft_post.php 文件。

找到处理返回数据的代码段，通常在文件末尾。

原始代码可能如下：

// ... 前面的代码 ...
// 默认是弹出窗口关闭的JS代码
if(empty($callback))
{
    echo "<script>try{window.opener.document.getElementById('".$f."').value='".$fileurl."';}catch(e){} window.close();</script>";
}
else
{
    echo "<script>try{window.opener.".$callback."('".$fileurl."');}catch(e){} window.close();</script>";
}

这段代码是给 window.open 弹窗模式使用的，它会尝试向父窗口的某个 input 赋值，我们需要修改它，使其在 UEditor 调用时返回 JSON。

修改后的代码如下：

<?php
// ... 前面的代码 ...
// 定义返回给UEditor的数据格式
$return_data = array(
    'state' => 'SUCCESS', // UEditor需要的状态码，SUCCESS表示成功
    'url'   => $fileurl,  // 文件的访问URL => $filename, // 文件的原始名称（可选）
    'original' => $filename // 文件的原始名称（可选）
);
// 检查请求是否来自UEditor
// UEditor会传递一个特定的参数，'ueditor_callback'
// 我们可以通过检查 $_GET 或 $_POST 中的某个特定参数来判断
// 这里我们假设UEditor会传递一个名为 'ueditor_request' 的参数
if (isset($_GET['ueditor_request']) || isset($_POST['ueditor_request'])) {
    // 如果是UEditor的请求，则返回JSON数据
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode($return_data);
    exit;
}
// 如果不是UEditor的请求（比如是普通弹窗），则执行原来的逻辑
if(empty($callback))
{
    echo "<script>try{window.opener.document.getElementById('".$f."').value='".$fileurl."';}catch(e){} window.close();</script>";
}
else
{
    echo "<script>try{window.opener.".$callback."('".$fileurl."');}catch(e){} window.close();</script>";
}
?>

代码解释：

1. 我们构建了一个名为 $return_data 的 PHP 数组，它的键名（state, url 等）是 Uditor 的 uploader.js 期望的。
2. 我们增加了一个判断条件 if (isset($_GET['ueditor_request']))，这是一个“约定”，我们告诉 UEditor，当它调用这个文件时，必须附带这个参数，这样织梦就知道该返回 JSON 还是执行原来的JS。
3. 如果是 UEditor 的请求，我们设置 Content-Type 为 application/json，json_encode 数组并输出，exit 终止脚本。
4. 如果不是 UEditor 的请求（比如用户通过后台手动打开文件管理器），则保留原来的逻辑,不影响织梦后台的正常使用。

第 3 步：在 UEditor 初始化时传递特殊参数

为了让第 2 步的判断生效，我们需要在 UEditor 初始化时，向 serverUrl 附加这个 ueditor_request 参数。

找到你调用 UEditor 的初始化 JS 代码（通常在需要编辑器的页面里），在 serverUrl 后面加上参数。

你的初始化代码可能是这样的：

var ue = UE.getEditor('editor', {
    // ... 其他配置 ...
    serverUrl: "你的网站路径/dede/file_manager/include/dialog/select_soft_post.php" // 第1步修改的路径
});

修改为：

var ue = UE.getEditor('editor', {
    // ... 其他配置 ...
    serverUrl: "你的网站路径/dede/file_manager/include/dialog/select_soft_post.php?ueditor_request=1" // 在URL后加上参数
});

注意：这里的 你的网站路径 必须是完整的、可访问的 URL 路径,而不是相对路径。

测试与排错

完成以上步骤后，刷新你的页面，点击 UEditor 编辑器上的“上传图片”按钮。

1. 如果成功：会弹出织梦文件管理器的窗口，选择图片后，窗口会自动关闭，并且图片会成功插入到编辑器中，可以查看浏览器的“网络”（Network）选项卡，查看对 select_soft_post.php 的请求，其响应（Response）应该是一个类似 {"state":"SUCCESS","url":"/uploads/image/2025/a.jpg","title":"a.jpg","original":"a.jpg"} 的 JSON 字符串。

2. 如果失败，请检查以下几点：

   • 路径错误：ueditor.config.js 中的 serverUrl 路径是否正确？能否访问到？
   • 参数传递：初始化时是否在 serverUrl 后面加上了 ?ueditor_request=1？
   • 织梦文件：select_soft_post.php 的修改是否正确？PHP 语法有没有错误？
   • 权限问题：网站运行的用户（如 www-data 或 IIS_IUSRS）是否有权限读取和执行织梦文件管理器目录下的文件？
   • 织梦配置：检查织梦后台的“文件管理”设置,确保上传目录和允许的文件类型是正确的。
   • 浏览器控制台：按 F12 打开开发者工具，查看 Console（控制台）是否有 JavaScript 错误，查看 Network（网络）面板中请求的详细信息和错误响应。

其他文件（视频、附件）的处理

如果你想让 UEditor 的“上传视频”、“上传附件”功能也调用织梦文件管理器，你需要重复上述步骤,但针对不同的文件类型。

1. 修改 ueditor.config.js：找到 videoActionName, scrawlActionName 等配置，它们的 serverUrl 都应该指向同一个织梦文件处理脚本 select_soft_post.php。

   // 在ueditor.config.js中
   , videoActionName: "uploadVideo"
   , videoFieldName: "filedata"
   , videoUrl: URL + "../dede/file_manager/include/dialog/select_soft_post.php?ueditor_request=1"

2. 修改织梦脚本：select_soft_post.php 的逻辑已经足够通用，因为它会根据你传递的参数（如 img 是否为真）来筛选文件类型，所以你不需要为视频和附件单独修改 PHP 文件。

通过以上步骤，你就可以成功地将 UEditor 和织梦的文件管理器整合起来了。