Laravel Medialibrary Laravel Package

What's Changed

• Replace all Unicode space separators in the default file name sanitizer by @chengkangzai in https://github.com/spatie/laravel-medialibrary/pull/3965

New Contributors

• @chengkangzai made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3965

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.8...11.23.9

What's Changed

• Fix keepOriginalImageFormat() encoding conversions as JPEG when the original file has an uppercase extension by @moemadeldin in https://github.com/spatie/laravel-medialibrary/pull/3964

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.7...11.23.8

What's Changed

• Decode remote url path before stripping directory in addMediaFromUrl by @bunlongheng in https://github.com/spatie/laravel-medialibrary/pull/3961

New Contributors

• @bunlongheng made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3961

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.4...11.23.5

What's Changed

• docs: fix HasMedia interface import in custom image generator by @latent-9 in https://github.com/spatie/laravel-medialibrary/pull/3960
• docs: fix outdated class namespaces in consuming events guide by @latent-9 in https://github.com/spatie/laravel-medialibrary/pull/3959
• Fix media-library:clean when conversions live on a separate disk by @AdzerKI in https://github.com/spatie/laravel-medialibrary/pull/3958

New Contributors

• @latent-9 made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3960
• @AdzerKI made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3958

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.3...11.23.4

What's Changed

• Remove period from the command description by @kminek in https://github.com/spatie/laravel-medialibrary/pull/3953
• Keep the just-added media when enforcing a collection size limit by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3955

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.2...11.23.3

What's Changed

• Bump actions/checkout from 6 to 7 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3946
• test: remove real sleep(1) from regenerate command tests by @nikolauspschuetz in https://github.com/spatie/laravel-medialibrary/pull/3951
• Fix double URL encoding for getTemporaryUrl() with non-ASCII filenames on local disk by @maeandrew in https://github.com/spatie/laravel-medialibrary/pull/3950

New Contributors

• @nikolauspschuetz made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3951
• @maeandrew made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3950

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.23.1...11.23.2

Fixed

• Strip path-traversal (..) segments from the zip_filename_prefix custom property so MediaStream can no longer emit ZIP archives with traversal entries (zip-slip defense-in-depth) #3947

What's Changed

• Update Retrieving converted images documentation to include getAvailableTemporaryUrl by @Orrison in https://github.com/spatie/laravel-medialibrary/pull/3936
• Fix flaky S3 temporary-URL tests by comparing without timing params by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3940
• Harden filename validation against malicious extensions by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3939
• Add opt-in conversions_disk_name config for default conversions disk by @patrickweh in https://github.com/spatie/laravel-medialibrary/pull/3938

New Contributors

• @patrickweh made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3938

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.22.1...11.23.0

What's Changed

• Removed stray 3MB speaking-page.png from the repo root, accidentally committed in a previous "wip" commit. Reduces the size of the package archive downloaded by Composer.

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.22.0...11.22.1

What's Changed

• Bump dependabot/fetch-metadata from 2 to 3 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3931
• Add deferred() conversion option by @ziadoz in https://github.com/spatie/laravel-medialibrary/pull/3922

New Contributors

• @ziadoz made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3922

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.21.2...11.22.0

What's Changed

• fix: skip URL encoding for S3 disk to prevent double encoding by @moemadeldin in https://github.com/spatie/laravel-medialibrary/pull/3934

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.21.1...11.21.2

What's Changed

• Fix docs bugs: 'to the where' typo and 'how to working with conversio… by @tareq-halaby in https://github.com/spatie/laravel-medialibrary/pull/3928
• Fix awkward phrasing: 'want to not move, but copy' -> clearer wording by @tareq-halaby in https://github.com/spatie/laravel-medialibrary/pull/3927
• fix: encode percent signs in filenames when generating URL by @moemadeldin in https://github.com/spatie/laravel-medialibrary/pull/3930

New Contributors

• @tareq-halaby made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3928
• @moemadeldin made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3930

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.21.0...11.21.1

What's Changed

• Add Laravel 13 support

What's new

• Add getAvailableTemporaryUrl method (#3919)

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.19.0...11.20.0

What's Changed

• Add Laravel Boost v2 skill by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3917

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.18.2...11.19.0

What's Changed

• Fix setNewOrder breaking with non-sequential array keys by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3916

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.18.1...11.18.2

What's Changed

• Revert breaking interface change on registerAllMediaConversions() — the ?Media $media = null parameter that was added to the HasMedia interface in v11.18.0 has been removed, as it broke userland code that overrides the method without the parameter. The PHPStan error is now handled via the baseline instead. Fixes #3915.

What's Changed

• Add vips as a documented image driver option by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3911
• Fix: setNewOrder method upgrade by @GameBear64 in https://github.com/spatie/laravel-medialibrary/pull/3908
• Update Laravel Filesystem documentation link to v12 by @mathiasdg in https://github.com/spatie/laravel-medialibrary/pull/3909
• Add conversion to responsAdd conversion parameter to toResponse and toInlineResponse by @miccehedin in https://github.com/spatie/laravel-medialibrary/pull/3907
• Fix #3889: Clean orphaned responsive images for base image by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3913
• Fix S3 conversions inheriting original media's ContentType by @freekmurze in https://github.com/spatie/laravel-medialibrary/pull/3914

New Contributors

• @GameBear64 made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3908
• @mathiasdg made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3909
• @miccehedin made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3907

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.10...11.18.0

What's Changed

• Add getAvailablePathRelativeToRoot() method by @adriaanzon in https://github.com/spatie/laravel-medialibrary/pull/3877

This new method is similar to getAvailablePath() but calls getPathRelativeToRoot() instead of getPath(). This is useful when working with both local and cloud filesystem drivers, as getPath() returns an absolute path that cannot be passed to Storage::get().

Example usage:

Storage::disk($media->disk)->get(
    $media->getAvailablePathRelativeToRoot(['conversion'])
)

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.9...11.17.10

What's Changed

• Fix getStream path concatenation for custom PathGenerator by @dmitrakovich in https://github.com/spatie/laravel-medialibrary/pull/3904

This fix resolves an issue where getStream() was forcing directory-style paths, making it impossible to use custom PathGenerators with non-directory paths (like prefixes). The fix allows developers to use filename prefixes such as {basePath}-{fileName}.

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.8...11.17.9

What's Changed

• feat: faster clean command via hash lookup by @ImJustToNy in https://github.com/spatie/laravel-medialibrary/pull/3898

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.7...11.17.8

What's Changed

• Fix PHPDoc property name to use snake_case by @michael-tscholl in https://github.com/spatie/laravel-medialibrary/pull/3895

New Contributors

• @michael-tscholl made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3895

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.6...11.17.7

What's Changed

• Bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3883
• Allow ZipStream to be 'unfinished' by @chrispage1 in https://github.com/spatie/laravel-medialibrary/pull/3887
• Set config directory for larastan by @erikn69 in https://github.com/spatie/laravel-medialibrary/pull/3894
• Fix imagedestroy deprecation by @erikn69 in https://github.com/spatie/laravel-medialibrary/pull/3893

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.5...11.17.6

What's Changed

• fix: duration should be parsed as float by @francoism90 in https://github.com/spatie/laravel-medialibrary/pull/3869

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.4...11.17.5

What's Changed

• Add m4v format clean by @imhayatunnabi in https://github.com/spatie/laravel-medialibrary/pull/3873

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.3...11.17.4

What's Changed

• Improve media library with safeguards by @imhayatunnabi in https://github.com/spatie/laravel-medialibrary/pull/3867

New Contributors

• @imhayatunnabi made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3867

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.2...11.17.3

What's Changed

• Added Symfony 8 support to all symfony/* packages. by @thecaliskan in https://github.com/spatie/laravel-medialibrary/pull/3864

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.1...11.17.2

What's Changed

• Add timeout and threads configuration for FFMpeg by @francoism90 in https://github.com/spatie/laravel-medialibrary/pull/3862

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.17.0...11.17.1

What's Changed

• docs: add installation instructions for image optimizers on Alpine Linux by @nastoychev in https://github.com/spatie/laravel-medialibrary/pull/3845
• Feat: allow null expiration for model get temporary url method by @chinmaypurav in https://github.com/spatie/laravel-medialibrary/pull/3851
• Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-medialibrary/pull/3850
• Optimize filename suffix generation in MediaStream by @iizno in https://github.com/spatie/laravel-medialibrary/pull/3855
• Test PHP 8.5 by @erikn69 in https://github.com/spatie/laravel-medialibrary/pull/3857
• Add Support for Defining Custom Path Generators in Models or Service Providers by @alissn in https://github.com/spatie/laravel-medialibrary/pull/3828
• Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3860

New Contributors

• @iizno made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3855
• @alissn made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3828

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.14.0...11.17.0

What's Changed

• Test PHP 8.5 by @erikn69 in https://github.com/spatie/laravel-medialibrary/pull/3857
• Add Support for Defining Custom Path Generators in Models or Service Providers by @alissn in https://github.com/spatie/laravel-medialibrary/pull/3828
• Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3860

New Contributors

• @alissn made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3828

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.15.0...11.16.0

What's Changed

• docs: add installation instructions for image optimizers on Alpine Linux by @nastoychev in https://github.com/spatie/laravel-medialibrary/pull/3845
• Feat: allow null expiration for model get temporary url method by @chinmaypurav in https://github.com/spatie/laravel-medialibrary/pull/3851
• Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-medialibrary/pull/3850
• Optimize filename suffix generation in MediaStream by @iizno in https://github.com/spatie/laravel-medialibrary/pull/3855

New Contributors

• @iizno made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3855

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.14.0...11.15.0

What's Changed

• Feat: set default expiration minutes when no value passes in args for temp url by @chinmaypurav in https://github.com/spatie/laravel-medialibrary/pull/3832
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3840
• Bump stefanzweifel/git-auto-commit-action from 5 to 6 by @dependabot[bot] in https://github.com/spatie/laravel-medialibrary/pull/3825

New Contributors

• @chinmaypurav made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3832

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.13.0...11.14.0

What's Changed

• Add support for LastMedia functions by @bAngerman in https://github.com/spatie/laravel-medialibrary/pull/3818

New Contributors

• @bAngerman made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3818

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.9...11.13.0

What's Changed

• Add null check for temporary model instance by @sebastiaanluca in https://github.com/spatie/laravel-medialibrary/pull/3801

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.8...11.12.9

What's Changed

• Dynamically check instance of temporary upload model by @sebastiaanluca in https://github.com/spatie/laravel-medialibrary/pull/3795

New Contributors

• @sebastiaanluca made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3795

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.7...11.12.8

What's Changed

• chore: update README for test documentation by @JavoByte in https://github.com/spatie/laravel-medialibrary/pull/3790
• Allow regenerate to queue all conversions by @patrickomeara in https://github.com/spatie/laravel-medialibrary/pull/3793

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.6...11.12.7

What's Changed

• fix: media manipulations should be applied before media conversions by @JavoByte in https://github.com/spatie/laravel-medialibrary/pull/3783

New Contributors

• @JavoByte made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3783

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.5...11.12.6

What's Changed

• Laravel 12 Support by @erikn69 in https://github.com/spatie/laravel-medialibrary/pull/3785

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.4...11.12.5

What's Changed

• Add @return $this annotation to methods by @lorenzolosa in https://github.com/spatie/laravel-medialibrary/pull/3780

New Contributors

• @lorenzolosa made their first contribution in https://github.com/spatie/laravel-medialibrary/pull/3780

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.3...11.12.4

What's Changed

• Add default types for template by @sforward in https://github.com/spatie/laravel-medialibrary/pull/3779

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.2...11.12.3

What's Changed

• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/laravel-medialibrary/pull/3773
• Improve return types when using a custom Media model by @sforward in https://github.com/spatie/laravel-medialibrary/pull/3777

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.1...11.12.2

What's Changed

• Add alt attribute to responsive image components by @A909M in https://github.com/spatie/laravel-medialibrary/pull/3765

Full Changelog: https://github.com/spatie/laravel-medialibrary/compare/11.12.0...11.12.1