Laravel Medialibrary

spatie/laravel-medialibrary

제출자 Laravel Korea Discovery Bot

최신 v11.23.11라이센스 MIT배포 2026년 10월 27일

DevOps

파일을 Eloquent 모델에 연결합니다

파일을 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에 대해 이미지 변환(manipulation)을 생성할 수도 있습니다.

Spatie는 벨기에 안트베르펜에 있는 웹 디자인 에이전시입니다. 모든 오픈 소스 프로젝트는 Spatie 웹사이트에서 확인할 수 있습니다.

Spatie는 최고 수준의 오픈 소스 패키지를 만드는 데 많은 노력을 기울이고 있습니다. 유료 제품 구매로 후원하실 수 있습니다.

또한 여러분의 고향에서 보낸 엽서에 사용 중인 패키지 이름을 적어 보내 주시면 큰 힘이 됩니다. 주소는 연락처 페이지에서 확인할 수 있으며, 받은 엽서는 모두 온라인 엽서 월에 게시됩니다.

문서는 https://spatie.be/docs/laravel-medialibrary에서 확인하실 수 있습니다.

패키지를 사용하다 막히셨나요? 버그를 발견하셨거나, 일반적인 질문이나 개선 제안이 있으신가요? 언제든 GitHub에 이슈를 등록해 주세요. 가능한 한 빨리 확인하겠습니다.

보안 관련 버그를 발견하셨다면 이슈 트래커 대신 security@spatie.be로 메일을 보내 주세요.

다음 명령으로 테스트를 실행할 수 있습니다.

./vendor/bin/pest

act를 사용하면 GitHub Actions를 로컬에서 실행할 수 있습니다. 로컬에서 테스트를 실행하려면 다음을 입력하세요.

act -j run-tests

특정 PHP/Laravel 버전으로 테스트하려면 다음과 같이 실행합니다.

act -j run-tests --matrix php:8.3 --matrix laravel:"11.*" --matrix dependency-version:prefer-stable

사용 가능한 matrix 옵션은 워크플로 파일에서 확인할 수 있습니다.

자세한 내용은 UPGRADING을 참고하세요.

최근 변경 사항은 CHANGELOG를 참고하세요.

자세한 내용은 CONTRIBUTING을 참고하세요.

보안 관련 문제를 발견하셨다면 이슈 트래커 대신 security@spatie.be로 메일을 보내 주세요.

이 저장소의 이슈 처리를 도와주신 Nicolas Beauvais에게 깊이 감사드립니다.

원본 로고를 만들어 주신 Caneco에게도 특별히 감사드립니다.

MIT 라이선스(MIT)를 따릅니다. 자세한 내용은 라이선스 파일을 참고하세요.