README

警告：如果您在公共服务器上使用旧版本（尤其是2.1.38或更早版本）的elFinder，可能会对您的服务器和访问用户造成严重损害。您应升级到最新版本或将它从服务器上移除。

      _ ______ _           _           
     | |  ____(_)         | |          
  ___| | |__   _ _ __   __| | ___ _ __ 
 / _ \ |  __| | | '_ \ / _` |/ _ \ '__|
|  __/ | |    | | | | | (_| |  __/ |   
 \___|_|_|    |_|_| |_|\__,_|\___|_|

elFinder是一个基于JavaScript和jQuery UI编写的开源网络文件管理器。其设计灵感来源于Mac OS X操作系统中的Finder程序的简洁和便捷。

内容

分支
功能
要求
安装
下载
演示网站
常见问题解答
第三方连接器
第三方卷驱动器
第三方主题
支持
作者
许可证

分支

master - 主开发分支
2.1-src - 2.1开发分支，提交时自动构建为2.1
2.1 - 2.1夜间构建分支

功能

类似于MacOS Finder或Windows资源管理器的可用性
适用于触摸设备的移动友好视图
远程服务器上文件和文件夹的所有操作（复制、移动、上传、创建文件夹/文件、重命名等）
高性能服务器后端和轻量级客户端UI
多根支持
本地文件系统、MySQL、FTP卷存储驱动器
云存储（Box、Dropbox、GoogleDrive和OneDrive）驱动器
使用HTML5支持的拖放上传文件/文件夹
大文件分块上传
直接上传到文件夹
上传表单URL（或列表）
列表和图标视图
键盘快捷键
使用鼠标或键盘进行文件/组选择的标准方法
使用拖放移动/复制文件
按alt/option键开始拖动时，拖放到外部
创建/解压存档（zip、rar、7z、tar、gzip、bzip2）
丰富的上下文菜单和工具栏
快速查看和预览常见文件类型
编辑文本文件和图像
"位置"用于您的收藏夹
计算目录大小
图像和电影文件的缩略图
易于与网络编辑器（elRTE、CKEditor、TinyMCE）集成
灵活配置访问权限、上传文件类型、用户界面等
通过后端和客户端的事件处理进行扩展
基于JSON的简单客户端-服务器API
支持在信息对话框中自定义信息
可配置列表视图的列
支持为自定义文件夹图标提供自定义CSS类函数
连接器插件
- AutoRotate : 通过EXIF方向自动旋转上传的JPEG文件。
- AutoResize : 在文件上传时自动调整文件大小。
- Normalizer : 文件名和文件路径等的UTF-8标准化器。
- Sanitizer : 文件名和文件路径等的净化器。
- Watermark : 在文件上传时打印水印。
更多详情，请参阅变更日志

需求

jQuery / jQuery UI

jQuery 1.8.0+
jQuery UI 1.9.0+ (需要draggable, droppable, resizable, selectable和slider)

然而，我们推荐最新版本。

客户端

现代桌面或移动浏览器。elFinder在最新版的Chrome，Edge，Firefox，IE和Opera上进行了测试
- 注意：iOS上的Web App模式("apple-mobile-web-app-capable"元标签)在elFinder中可能无法完美工作

服务器

任何Web服务器
PHP 5.2+ (推荐PHP 5.4或更高) 以及生成缩略图所需的GD / Imagick模块 / convert(imagemagick)
- 推荐PHP 7.1或更高版本以支持Windows服务器上的文件路径/名称的非ASCII字符

安装

构建（压缩版）

下载以下构建之一到您的PHP服务器
将/php/connector.minimal.php-dist重命名为/php/connector.minimal.php
在浏览器中加载/elfinder.html以运行elFinder

源代码（未压缩版）

将此存储库克隆到您的PHP服务器

$ git clone https://github.com/Studio-42/elFinder.git

将/php/connector.minimal.php-dist重命名为/php/connector.minimal.php
在浏览器中加载/elfinder.src.html以运行elFinder

安装程序

使用Composer设置elFinder 2.1.x夜间版本

下载

稳定版本 (变更日志)

elFinder 2.1.41
elFinder 2.0.9 (已弃用)

夜间构建

elFinder 2.1.x (夜间)

演示网站

2.1.x 夜间

https://studio-42.github.io/elFinder/ (带有CORS)
https://hypweb.net/elFinder-nightly/demo/2.1/

常见问题解答

我应该使用elFinder的构建（压缩版）还是源代码（未压缩版）？

为了调试和开发，请使用源代码。对于生产使用，请使用构建版本。

如何将elFinder与CKEditor/TinyMCE/elRTE等集成？

请查看Wiki以获取具体操作说明。

语言文件的创建或修改流程？

您可以通过创建或修改语言文件来使用翻译工具。请参考将结果提交到相应分支的拉取请求。

2.1 分支翻译工具

第三方连接器

第三方卷驱动程序

League\Flysystem (PHP)（适用于elFinder 2.1+）

第三方主题

提示：如何使用RequireJS加载CSS？

第三方集成

支持

作者

首席开发者：Dmitry "dio" Levashov dio@std42.ru
维护者：Troex Nevelin troex@fury.scancode.ru
开发者：Alexey Sukhotin strogg@yandex.ru，Naoki Sawada hypweb+elfinder@gmail.com
图标：PixelMixer，Yusuke Kamiyamane，Icons8

我们希望我们的工具对您有所帮助。

许可证

elFinder在3条款BSD许可证下发布。

许可证条款

helios-ag / fm-elfinder

维护者

详细信息