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 上创建一个问题，我们将尽快解决。

如果您发现了一个关于安全性的错误，请通过 [email protected] 发送电子邮件，而不是使用问题跟踪器。

测试

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

./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 以获取详细信息。

安全

如果您发现任何与安全相关的问题，请通过 [email protected] 发送电子邮件，而不是使用问题跟踪器。

鸣谢

• Freek Van der Herten
• 所有贡献者

非常感谢 Nicolas Beauvais 帮助解决本仓库中的问题。

特别感谢 Caneco 提供的标志 ✨

替代方案

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

许可

MIT 许可证（MIT）。请参阅 许可文件 了解更多信息。