elFinder

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

elFinder是一个开源的Web文件管理器，使用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、SFTP、Box、Dropbox、GoogleDrive和OneDrive卷存储驱动
• 支持AWS S3、Azure、Digital Ocean Spaces等，使用League\Flysystem Flysystem驱动
• 云存储（Box、Dropbox、GoogleDrive和OneDrive）驱动
• 支持HTML5拖放的后台文件/文件夹上传
• 大文件分块上传
• 直接上传到文件夹
• 从URL（或列表）上传
• 列表和图标视图
• 键盘快捷键
• 使用鼠标或键盘的标准文件/组选择方法
• 通过拖放移动/复制文件
• 按住alt/option键开始拖动可拖放到外部
• 创建/提取压缩文件（zip、rar、7z、tar、gzip、bzip2）
• 丰富的上下文菜单和工具栏
• 常见文件类型的快速查看和预览
• 编辑文本文件和图像
• 收藏夹"位置"
• 计算目录大小
• 图像和视频文件的缩略图
• 易于与Web编辑器集成（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、button和slider
  • 推荐：sorter（使列表列和位置可排序）

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

客户端

• 现代桌面或移动浏览器。elFinder已在最新的Chrome、Edge、Firefox、IE和Opera中测试
  • 注意：iOS上的Web应用模式（"apple-mobile-web-app-capable"元标签）在elFinder中工作不完美

服务器

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

安装

构建版（压缩）

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

源代码（未压缩）

1. 将此仓库克隆到您的PHP服务器

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

2. 将/php/connector.minimal.php-dist重命名为/php/connector.minimal.php

3. 在浏览器中加载/elfinder.src.html以运行elFinder

安装程序

• 使用Composer设置elFinder 2.1.x每日构建版

下载

稳定版本 (更新日志)

• elFinder 2.1.65
• elFinder 2.0.9（已弃用）

每日构建版

• elFinder 2.1.x（每日构建）

演示站点

2.1.x 每日构建版

• https://studio-42.github.io/elFinder/（支持CORS）

常见问题

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

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

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

查看wiki获取各个编辑器的具体说明。

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

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

• 2.1分支翻译工具

第三方连接器

• ASP.NET / ASP.NET Core / .NET Standard
• Java Servlet
• JavaScript/Efw
• Nodejs
• Python
• Ruby/Rails

第三方卷驱动

• League\Flysystem (PHP)（适用于elFinder 2.1+）Flysystem的驱动

第三方主题

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

• lokothodida/elfinder-theme-moono
• lokothodida/elfinder-theme-windows-10
• RobiNN1/elFinder-Material-Theme
• StudioJunkyard/elfinder-boostrap-theme

第三方集成

• Django
• Drupal
• Laravel
• Roundcube
• Symfony
• Tiki Wiki
• WordPress
• XOOPS
• XOOPSCube 基于GUI的控制面板：FTP、云存储和编辑器
• Yii
• Zenphoto

支持

• 主页
• Wiki
• 问题
• dev@std42.ru

作者

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

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

许可证

elFinder采用3条款BSD许可证发布。

• 许可条款