README

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

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

内容

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

分支

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

功能

• 类似于MacOS Finder或Windows Explorer的用户界面
• 适用于触摸设备的友好视图
• 远程服务器上的所有文件和文件夹操作（复制、移动、上传、创建文件夹/文件、重命名等）
• 高性能服务器后端和轻量级客户端UI
• 多根支持
• 本地文件系统、MySQL、FTP、SFTP、Box、Dropbox、GoogleDrive和OneDrive卷存储驱动程序
• 通过 League\Flysystem Flysystem驱动程序支持AWS S3、Azure、Digital Ocean Spaces等
• 云存储（Box、Dropbox、GoogleDrive和OneDrive）驱动程序
• 支持Drag & Drop HTML5的背景文件/文件夹上传
• 大文件分块上传
• 直接上传到文件夹
• 上传表单URL（或列表）
• 列表和图标视图
• 键盘快捷键
• 使用鼠标或键盘进行文件/组选择的标准方法
• 通过拖放移动/复制文件
• 按住alt/option键开始拖动以将文件拖放到外部
• 创建/提取存档（zip、rar、7z、tar、gzip、bzip2）
• 丰富的上下文菜单和工具栏
• 快速查看和预览常见文件类型
• 编辑文本文件和图片
• "位置"用于您的收藏夹
• 计算目录大小
• 图像和电影文件的缩略图
• 易于与网页编辑器（elRTE、CKEditor、TinyMCE）集成
• 灵活配置访问权限、上传文件类型、用户界面等
• 通过后端和客户端的事件处理进行扩展
• 基于JSON的简单客户端-服务器API
• 支持在信息对话框中自定义信息
• 可配置列表视图的列
• 支持为自定义文件夹图标自定义CSS类函数
• 连接器插件
  • 自动旋转 : 通过EXIF方向自动旋转上传的JPEG文件
  • 自动调整大小 : 上传文件时自动调整大小
  • 标准化器 : 文件名和文件路径等的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 App模式（“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？https://github.com/Studio-42/elFinder/wiki/How-to-load-CSS-with-RequireJS%3F

• 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
• 问题
• [email protected]

作者

• 当前主要开发者：Naoki Sawada [email protected]
• 首席开发者：Dmitry "dio" Levashov [email protected]
• 维护者：Troex Nevelin [email protected]
• 开发者：Alexey Sukhotin, Naoki Sawada [email protected]
• 图标：PixelMixer, Yusuke Kamiyamane, Icons8

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

许可

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

• 许可条款