Inštalácia

Pridajte balík, potom publikujte a spustite migrácie — tabuľku media a tabuľku media_uploads s tiketmi priameho nahrávania, ktorá zostane prázdna, kým priame nahrávanie nezapnete. Migrácie sa len publikujú — balík ich sám nenačítava, takže samotné php artisan migrate tabuľku media nevytvorí, kým ich nepublikujete. Publikujú sa s časovou pečiatkou a opätovné publikovanie prepíše tie isté súbory. Service provider sa zaregistruje automaticky:

composer require roundly-consulting/media-library-for-laravel

php artisan vendor:publish --tag="media-migrations"
php artisan migrate

Konfiguračný súbor je voliteľný — každý kľúč má predvolenú hodnotu z env. Publikujte ho len na prepísanie:

php artisan vendor:publish --tag="media-config"

Podpísanú streamovaciu routu balík zaregistruje sám (ak media.stream.enabled nie je false). Súbor routy publikujte, len ak ho chcete upraviť:

php artisan vendor:publish --tag="media-routes"

Balík vystavuje publish tagy media-migrations, media-config, media-routes a media-translations — anglické a slovenské hlásenia pravidla SafeRemoteUrl, ktoré sa načítajú pod menným priestorom media:: aj bez publikovania.

Prechod z verzie 2.0

Verzia 2.1 pridáva tabuľku tiketov media_uploads. Migrácie publikujte znova a spustite migrate — nič iné sa nezmení:

php artisan vendor:publish --tag="media-migrations"   # adds create_media_uploads_table
php artisan migrate

• Všetky novinky verzie 2.1 sú voliteľné alebo zachovávajú doterajšie správanie: deduplicate_scope je predvolene global, temporary_url_response_headers a mime_types.strict sú false a direct_uploads.enabled je false.
• Verzia 2.2 nepotrebuje migráciu: expectedOwner / expectedBucket v adoptUpload() a completeUpload() sú voliteľné a TooManyPendingDirectUploads rozširuje doteraz vyhadzovanú DirectUploadsNotSupported, takže existujúce catch bloky fungujú ďalej.
• Plánované pre ďalšiu hlavnú verziu: deduplicate_scope bude predvolene owner (ak chcete zdieľať naprieč vlastníkmi, nastavte global), temporary_url_response_headers bude zapnuté (ak chcete obyčajné presigned URL, nastavte false) a adoptUpload() / completeUpload() budú vyžadovať očakávaného vlastníka (alebo výslovné odmietnutie pre globálne médiá a drafty).
• Vlastný url_generator funguje pri všetkých doterajších volaniach ďalej; len getTemporaryUrlWithOptions() a getTemporaryDownloadUrl() vyžadujú, aby implementoval GeneratesTemporaryUrlsWithOptions.