a7madev / stapler
优雅且简单的基于ORM的PHP文件上传包。
Requires
- php: >=5.4
- doctrine/inflector: ~1
- imagine/imagine: ~0.6.2
- symfony/http-foundation: ~2.3|~3.0
Requires (Dev)
- aws/aws-sdk-php: 2.4.*@dev
- illuminate/config: 4.*|5.*
- illuminate/database: 4.*|5.*
- mockery/mockery: 0.8.0
This package is not auto-updated.
Last update: 2024-09-26 01:07:44 UTC
README
注意: 如果您之前一直在使用此包,那么您一直在使用Laravel。此包不再直接与Laravel框架耦合。自1.0.0版本起,Stapler现在是框架无关的。为了利用之前Beta版本提供的Laravel特定功能(服务提供者、IOC容器、命令、迁移生成器等),我创建了一个专门用于在Laravel中使用Stapler的独立包:Laravel-Stapler。如果您在Laravel应用程序中使用Stapler,我强烈建议您使用此包(它可以节省您一些样板代码)。
Stapler是一个基于PHP的框架无关文件上传包,灵感来源于Ruby Paperclip插件。它可以用于将文件上传(作为附件对象)添加到您的ORM记录中。虽然不是完全相同,但如果您之前使用过Paperclip,那么您应该会非常熟悉此包。
Stapler是由Travis Bennett创建的。
要求
Stapler目前需要php >= 5.4(Stapler通过使用特性实现)。
安装
Stapler作为composer包分发,这是在您的应用程序中使用它的正确方式。
使用Composer安装包。编辑您的项目composer.json
文件,以要求codesleeve/stapler
。
"require": { "codesleeve/stapler": "1.0.*" }
关于Stapler
Stapler通过将文件上传附加到数据库表记录来工作。这是通过在表的对应模型中定义附件并然后分配上传的文件(从您的表单)作为模型上的属性(以附件命名)在保存之前完成的。Stapler将监听模型的生命周期回调(保存后、删除前和删除后)并相应地处理文件。本质上,这允许上传的文件像模型上的任何其他属性一样被处理;Stapler将抽象出所有文件处理、存储等,以便您可以在不担心文件位置或如何检索它们的情况下专注于项目的其余部分。
主要优势
- 现代:Stapler在php >= 5.4上运行,并利用了许多现代PHP提供的新功能(特性、可调用类型提示等)。
- 简单:传统上,文件上传一直被认为是一项艰巨的任务;Stapler极大地减少了整个过程中所需的样板代码。说真的,Stapler使文件上传(任何类型)变得极为简单。
- 灵活:Stapler提供了一个极其灵活的级联配置;只需更改单个配置选项,即可将文件配置为本地存储或通过AWS S3存储。
- 可扩展:将您的资产存储在中央位置(如S3)允许您的文件从单个位置由多个Web实例访问。
- 强大:Stapler利用现代面向对象编程模式,为文件上传提供稳健的架构。它基于特性的驱动系统提供了跨多个ORMS(包括Active Record和数据映射实现)实现生命周期回调的潜力。