jackardios / laravel-medialibrary
将文件与 Eloquent 模型关联
Requires
- php: ^8.2
- ext-exif: *
- ext-fileinfo: *
- ext-json: *
- composer/semver: ^3.4
- illuminate/bus: ^10.0|^11.0
- illuminate/conditionable: ^10.0|^11.0
- illuminate/console: ^10.0|^11.0
- illuminate/database: ^10.0|^11.0
- illuminate/pipeline: ^10.0|^11.0
- illuminate/support: ^10.0|^11.0
- maennchen/zipstream-php: ^3.1
- spatie/image: ^3.3.2
- spatie/laravel-package-tools: ^1.16.1
- spatie/temporary-directory: ^2.2
- symfony/console: ^6.4.1|^7.0
Requires (Dev)
- ext-imagick: *
- ext-pdo_sqlite: *
- ext-zip: *
- aws/aws-sdk-php: ^3.293.10
- guzzlehttp/guzzle: ^7.8.1
- larastan/larastan: ^2.7
- league/flysystem-aws-s3-v3: ^3.22
- mockery/mockery: ^1.6.7
- orchestra/testbench: ^7.0|^8.17|^9.0
- pestphp/pest: ^2.28
- phpstan/extension-installer: ^1.3.1
- spatie/laravel-ray: ^1.33
- spatie/pdf-to-image: ^2.2|^3.0
- spatie/pest-plugin-snapshots: ^2.1
Suggests
- league/flysystem-aws-s3-v3: Required to use AWS S3 file storage
- php-ffmpeg/php-ffmpeg: Required for generating video thumbnails
- spatie/pdf-to-image: Required for generating thumbnails of PDFs and SVGs
Conflicts
- php-ffmpeg/php-ffmpeg: <0.6.1
This package is auto-updated.
Last update: 2024-09-12 22:26:16 UTC
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 发送邮件,而不是使用问题跟踪器。
鸣谢
非常感谢 Nicolas Beauvais 为本仓库的问题提供帮助。
特别感谢 Caneco 设计的标志 ✨
替代方案
许可证
MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件。