medialibrary-development

Implement the HasMedia interface and use the InteractsWithMedia trait on the model, then call addMedia with the file followed by toMediaCollection. Files can also be added from URLs, requests, base64 strings, streams, or existing disks.

Define conversions inside registerMediaConversions using addMediaConversion with a fit method such as Fit::Contain and target dimensions. Use nonQueued for synchronous generation or queued for background processing, then retrieve them via getFirstMediaUrl with the conversion name.

Yes, collections can specify a disk with useDisk, and conversions can be stored separately with storeConversionsOnDisk. Temporary URLs for private S3 files are available through getFirstTemporaryUrl with an expiration time.

The most common cause is calling addMedia without finalizing with toMediaCollection, which is required to persist the file. Also verify the medialibrary migration was published and run before adding media.

Call singleFile on the collection definition inside registerMediaCollections. Uploading a new file then automatically replaces the previous one, and you can pair it with useFallbackUrl for a default image when the collection is empty.