PHPackages peinhu/aetherupload-webman - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. peinhu/aetherupload-webman ActiveLibrary[File & Storage](/categories/file-storage) peinhu/aetherupload-webman ========================== Webman plugin peinhu/aetherupload-webman v1.0.2(3y ago)13165GPL-2.0PHP Since Aug 23Pushed 3y ago1 watchersCompare [ Source](https://github.com/peinhu/AetherUpload-Webman)[ Packagist](https://packagist.org/packages/peinhu/aetherupload-webman)[ RSS](/packages/peinhu-aetherupload-webman/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (3)Versions (7)Used By (0) AetherUpload-Webman =================== [](#aetherupload-webman) 本项目移植自广受好评的Laravel大文件上传扩展包：[AetherUpload-Laravel](https://github.com/peinhu/AetherUpload-Laravel) [![示例页面](https://camo.githubusercontent.com/499da131399233ccf0dbaa2b6baee533c50c1d61d80884182d8272ab63a9fb4b/687474703a2f2f7778322e73696e61696d672e636e2f6d773639302f363965323330353667793166686f36796d65706a6c673230676f30616b6e61722e676966)](https://camo.githubusercontent.com/499da131399233ccf0dbaa2b6baee533c50c1d61d80884182d8272ab63a9fb4b/687474703a2f2f7778322e73696e61696d672e636e2f6d773639302f363965323330353667793166686f36796d65706a6c673230676f30616b6e61722e676966) 功能特性 ==== [](#功能特性) - 百分比进度条 - 文件类型限制 - 文件大小限制 - 多语言支持 - 资源分组配置 - 上传完成事件 - 同步上传 *①* - 断线续传 *②* - 文件秒传 *③* - 自定义中间件 *④* - 自定义路由 - 宽松模式 *①：同步上传相比异步上传，在上传带宽足够大的情况下速度稍慢，但同步可在上传同时进行文件的拼合，而异步因文件块上传完成的先后顺序不确定，需要在所有文件块都完成时才能拼合，将会导致异步上传在接近完成时需等待较长时间。同步上传每次只有一个文件块在上传，在单位时间内占用服务器的内存较少，相比异步方式可支持更多人同时上传。* *②：断线续传和断点续传不同，断线续传是指遇到断网或无线网络不稳定时，在不关闭页面的情况下，上传组件会定时自动重试，一旦网络恢复，文件会从未上传成功的那个文件块开始继续上传。断线续传在刷新页面或关闭后重开是无法续传的，之前上传的部分已成为无效文件。* *③：文件秒传需服务端Redis和客户端浏览器支持(FileReader、File.slice())，两者缺一则秒传功能无法生效。默认关闭，需在配置文件中开启。* *④：结合自定义中间件，可对已上传资源的访问、下载行为进行权限控制。* 安装 == [](#安装) 0 在终端内切换到你的webman项目根目录，执行`composer require peinhu/aetherupload-webman ^1.0` 1 在浏览器访问`http://域名/aetherupload`可到达示例页面 *提示：更改相关配置选项请编辑`config/plugin/peinhu/aetherupload-webman/app.php`。* 使用 == [](#使用) **文件上传** 参考示例文件及注释，在需要上传大文件的页面引入相应文件及代码。 **分组配置** 在本插件配置文件的`groups`下新增分组，运行`php webman aetherupload:groups`自动创建对应目录。 ``` 'video' => [ 'group_dir' => 'video', 'resource_maxsize' => 0, 'resource_extensions' => [], 'event_before_upload_complete' => false, 'event_upload_complete' => false, ], ``` 在前端通过调用`setGroup('分组名')`方法指定上传分组，注意分组名必须已经存在。 **添加秒传功能（需Redis及浏览器支持）** 参考Webman文档Redis部分，安装所需依赖。 安装Redis并启动服务。 安装predis包`composer require predis/predis`。 在`config/redis.php`中设置`client`为`predis`。 在本插件配置文件中将`instant_completion`设置为`true`。 *提示：在Redis中维护了一份与实际资源文件对应的秒传清单，实际资源文件的增删造成的变化均需要同步到秒传清单中，否则会产生脏数据。 扩展包已包含新增部分，当需要删除资源文件时，使用者需手动调用对应方法删除文件及秒传清单中的记录。* ``` \AetherUpload\Util::deleteResource($savedPath); //删除对应的资源文件 \AetherUpload\Util::deleteRedisSavedPath($savedPath); //删除对应的Redis秒传记录 ``` **自定义中间件** 参考Webman文档路由中间件部分，创建你的中间件并将你编写的中间件名称填入配置文件对应部分。 ``` 'middleware_download' => [app\middleware\MiddlewareA::class,app\middleware\MiddlewareB::class], ``` 可使用此功能对文件进行上传、访问、下载行为的权限控制。 **自定义路由** 在本插件配置文件下编辑`'route_uploading' => '/aetherupload/uploading'`等选项，在前端调用`setUploadingRoute('/aetherupload/uploading')`等方法。 文件访问、下载路由编辑后，可直接访问，无需调用前端方法。 **上传完成事件** 分为上传完成前、上传完成后事件，参考Webman文档常用组件Event事件部分。 在`config/event.php`中为`aetherupload.before_upload_complete`及`aetherupload.upload_complete`配置对应的事件处理类。 在本插件配置文件中将`groups`下相应选项设置为`true`。 ``` 'event_before_upload_complete' => true, 'event_upload_complete' => true, ``` 可使用此功能在上传完成前、上传完成后进行额外处理。 **宽松模式** 在本插件配置文件下编辑`'lax_mode' => true,`，在前端调用`setLaxMode(true)`方法。 通过上传前跳过计算hash，可缩短总耗时。此选项开启后，无法进行秒传和完整性校验。 **多语言** 前端检测浏览器语言后自动设置，目前支持中、英。 **使用方便的控制台命令** `php webman aetherupload:groups` 列出所有分组并自动创建对应目录 `php webman aetherupload:build` 在Redis中重建资源文件的秒传清单 `php webman aetherupload:clean 2` 清除2天前的无效临时文件 优化建议 ==== [](#优化建议) - **（推荐）设置每天自动清除无效的临时文件** 由于上传流程存在意外终止的情况，如在传输过程中强行关闭页面或浏览器，将会导致已产生的文件部分成为无效文件，占据大量的存储空间，我们可以使用crontab的定时任务功能来定期清除它们。 在Linux中运行`crontab -e`命令，确保文件中包含这行代码： ``` 0 0 * * * php /项目根目录的绝对路径/webman aetherupload:clean 1> /dev/null 2>&1 ``` - **设置每天自动重建Redis中的秒传清单** 不恰当的处理和某些极端情况可能使秒传清单中出现脏数据，从而影响到秒传功能的准确性，重建秒传清单可消除脏数据，恢复与实际资源文件的同步。 在Linux中运行`crontab -e`命令，确保文件中包含这行代码： ``` 0 0 * * * php /项目根目录的绝对路径/webman aetherupload:build 1> /dev/null 2>&1 ``` - **提高分块临时文件读写速度（仅对PHP生效）** 利用Linux的tmpfs文件系统，来达到将上传的分块临时文件放到内存中快速读写的目的，通过以空间换时间，提升读写效率，将会**额外占用**部分内存（约1个分块大小）。 将php.ini中上传临时目录`upload_tmp_dir`项的值设置为`"/dev/shm"`，重启服务。 - **提高分块临时文件读写速度（对系统临时目录生效）** 利用Linux的tmpfs文件系统，来达到将上传的分块临时文件放到内存中快速读写的目的，通过以空间换时间，提升读写效率，将会**额外占用**部分内存（约1个分块大小）。 执行以下命令： `mkdir /dev/shm/tmp` `chmod 1777 /dev/shm/tmp` `mount --bind /dev/shm/tmp /tmp` 兼容性 === [](#兼容性) IE Edge Firefox Chrome Safari 上传 10+ 12+ 3.6+ 6+ 5.1+ 秒传 10+ 12+ 3.6+ 6+ 6+ 安全性 === [](#安全性) AetherUpload在上传前使用白名单+黑名单的形式进行文件后缀名过滤，上传后再检查文件的Mime-Type类型。白名单直接限制了保存文件扩展名，黑名单默认屏蔽了常见的可执行文件扩展名，来阻止上传恶意文件，安全起见白名单一栏不应留空。 虽然做了诸多安全工作，但恶意文件上传是防不胜防的，建议正确设置上传目录权限，确保相关程序对资源文件没有执行权限。 更新日志 ==== [](#更新日志) 详见[CHANGELOG.md](https://github.com/peinhu/AetherUpload-Webman/blob/master/CHANGELOG.md) 许可证 === [](#许可证) 使用GPLv2许可证, 查看[LICENCE](https://github.com/peinhu/AetherUpload-Webman/blob/master/LICENSE)文件以获得更多信息。 ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community9 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 84.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 1360d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/28e39cdff1890a997ff0c33048bc2478dcf7050682e8a1c0e26afa80bcdbee19?d=identicon)[peinhu](/maintainers/peinhu) --- Top Contributors [![peinhu](https://avatars.githubusercontent.com/u/8167724?v=4)](https://github.com/peinhu "peinhu (11 commits)")[![RadfemTerminator](https://avatars.githubusercontent.com/u/39252153?v=4)](https://github.com/RadfemTerminator "RadfemTerminator (2 commits)") --- Tags uploadlargewebman ### Embed Badge ![Health badge](/badges/peinhu-aetherupload-webman/health.svg) ``` [![Health](https://phpackages.com/badges/peinhu-aetherupload-webman/health.svg)](https://phpackages.com/packages/peinhu-aetherupload-webman) ``` ### Alternatives [vich/uploader-bundle Ease file uploads attached to entities 1.9k25.9M116](/packages/vich-uploader-bundle)[oneup/uploader-bundle This Symfony bundle provides a server implementation for handling single and multiple file uploads using either FineUploader, jQuery File Uploader, YUI3 Uploader, Uploadify, FancyUpload, MooUpload, Plupload or Dropzone. Features include chunked uploads, orphanages, Gaufrette and Flysystem support. 6066.3M27](/packages/oneup-uploader-bundle)[sonata-project/media-bundle Symfony SonataMediaBundle 4625.5M71](/packages/sonata-project-media-bundle)[peinhu/aetherupload-laravel Upload large files for Laravel 上传 大文件 laravel包 91884.7k3](/packages/peinhu-aetherupload-laravel)[marrouchi/upload-crop-image-bundle Basic server side cropping behavior for Symfony2 121.1k](/packages/marrouchi-upload-crop-image-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)