bansalakhil/stapler

基于ORM的优雅且简单的PHP文件上传包。

维护者

详细信息

github.com/bansalakhil/stapler

来源

3.0.2 2019-08-19 07:34 UTC

README

#Stapler 构建状态 最新稳定版本 总下载量 最新不稳定版本 许可证

注意: 如果您之前已经使用过此包,那么您已经用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和数据映射实现)实现生命周期回调的潜力。

文档