README

将文件与 Eloquent 模型关联

此包可以将各种文件与 Eloquent 模型关联起来。它提供了一个简单的 API 来操作。要了解所有内容，请访问 详尽的文档。

以下是您可以进行的几个简要示例

$newsItem = News::find(1);
$newsItem->addMedia($pathToFile)->toMediaCollection('images');

它可以直接处理您的上传

$newsItem->addMedia($request->file('image'))->toMediaCollection('images');

想要将一些大文件存储在另一个文件系统上？没问题

$newsItem->addMedia($smallFile)->toMediaCollection('downloads', 'local');
$newsItem->addMedia($bigFile)->toMediaCollection('downloads', 's3');

文件存储由 Laravel 的文件系统 处理，因此您可以使用任何您喜欢的文件系统。此外，该包可以在媒体库中添加的图像和 PDF 上创建图像处理。

Spatie 是一家位于比利时安特卫普的网页设计公司。您可以在我们的网站上找到所有开源项目的概述 在这里。

支持我们

我们投入了大量资源来创建 一流的开放源代码包。您可以通过 购买我们的付费产品之一 来支持我们。

我们非常感谢您从您的家乡给我们寄明信片，说明您正在使用我们的哪些包。您可以在我们的 联系页面 上找到我们的地址。我们将所有收到的明信片发布在我们的 虚拟明信片墙 上。

文档

您可以在 https://spatie.be/docs/laravel-medialibrary 上找到文档。

如果您在使用包时遇到困难？发现了一个错误？您对改进媒体库有任何一般性问题和建议吗？请随时在 GitHub 上创建一个问题，我们将尽快解决。

如果您发现有关安全性的错误，请通过电子邮件 security@spatie.be 而不是使用问题跟踪器。

测试

您可以使用以下命令运行测试

./vendor/bin/pest

您可以使用 act 在本地运行 Github actions。您必须使用 自定义镜像 来为 ubuntu-latest 平台安装 PHP 以正确运行。要本地运行测试，请运行

act -P ubuntu-latest=shivammathur/node:latest

要运行特定的流程，例如 run-tests.yml，请运行

act -P ubuntu-latest=shivammathur/node:latest -j run-tests

升级

有关详细信息，请参阅 UPGRADING。

变更日志

请参阅 CHANGELOG 了解最近发生了哪些变化。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全

如果您发现任何安全相关的问题，请通过电子邮件联系 security@spatie.be，而不是使用问题跟踪器。

致谢

• Freek Van der Herten
• 所有贡献者

特别感谢 Nicolas Beauvais 帮助解决这个仓库中的一些问题。

还要特别感谢 Caneco 设计了标志 ✨

替代方案

• laravel-mediable
• laravel-stapler
• media-manager

许可证

MIT 许可证（MIT）。有关更多信息，请参阅 许可证文件。