Laravel Mediable Laravel Package

What's Changed

• Added compatibility with symfony 8.X by @frasmage in https://github.com/plank/laravel-mediable/pull/389
• Added support for intervention/image:4.0 by @frasmage in https://github.com/plank/laravel-mediable/pull/388
• Dropped support for intervention/image:2.X
• Added ImageManipulation::setOutputOptions(), to support various intervention/image output format settings
• Deprecated ImageManipulation::setOutputQuality(). Use the 'quality' key in setOutputOptions() instead

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.4.0...6.5.0

What's Changed

• Added Laravel 13 support
• Removed Laravel 11 support
• Minimum supported PHP version is now 8.3

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.3.1...6.4.0

What's Changed

• Don't require CLI to execute migrations by @syssi in https://github.com/plank/laravel-mediable/pull/376
• Fix template type definition in MediableCollection by @marvinschroeder in https://github.com/plank/laravel-mediable/pull/378

New Contributors

• @syssi made their first contribution in https://github.com/plank/laravel-mediable/pull/376
• @marvinschroeder made their first contribution in https://github.com/plank/laravel-mediable/pull/378

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.3.0...6.3.1

What's Changed

• added support for laravel 12, drop support for laravel 10 by @frasmage in https://github.com/plank/laravel-mediable/pull/375

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.2.1...6.3.0

What's Changed

• Fix imageManipulation::outputWebpFormat() encoding by @frasmage in https://github.com/plank/laravel-mediable/pull/373
• Update 2020_10_12_000000_add_variants_to_media.php by @solomon-ochepa in https://github.com/plank/laravel-mediable/pull/372
• adjust variant FK constraint drop by @frasmage in https://github.com/plank/laravel-mediable/pull/374

New Contributors

• @solomon-ochepa made their first contribution in https://github.com/plank/laravel-mediable/pull/372

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.2.0...6.2.1

What's Changed

• Added support for PHP 8.4 by @selfsimilar in https://github.com/plank/laravel-mediable/pull/362
• MediaUploader directory now defaults to empty string by @EriBloo in https://github.com/plank/laravel-mediable/pull/366
• add support for HEIC image files by @frasmage in https://github.com/plank/laravel-mediable/pull/368
• add php 8.4 to test suite by @frasmage in https://github.com/plank/laravel-mediable/pull/369

New Contributors

• @selfsimilar made their first contribution in https://github.com/plank/laravel-mediable/pull/362
• @EriBloo made their first contribution in https://github.com/plank/laravel-mediable/pull/366

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.1.3...6.2.0

What's Changed

• Migration Class Refactor and Column Existence Check by @anilkumarthakur60 in https://github.com/plank/laravel-mediable/pull/358

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.1.2...6.1.3

What's Changed

• Fix publish add_alt_to_media migration by @jason-nabooki in https://github.com/plank/laravel-mediable/pull/353

New Contributors

• @jason-nabooki made their first contribution in https://github.com/plank/laravel-mediable/pull/353

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.1.1...6.1.2

• Fix typo in driver class FQCN

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.1.0...6.1.1

What's Changed

• Attempt to automatically select an intervention/image driver by @frasmage in https://github.com/plank/laravel-mediable/pull/352
• Fix an error in package discovery if attempting to install both plank/laravel-mediable and intervention/image-laravel at the same time

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.5...6.1.0

What's Changed

• move ImageManipulator singleton to lazy instantiation by @frasmage in https://github.com/plank/laravel-mediable/pull/351

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.4...6.0.5

• Fix alt migration default value for the mysql dialect

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.3...6.0.4

What's Changed

• fix service provider database migration bindings by @frasmage in https://github.com/plank/laravel-mediable/pull/349

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.2...6.0.3

What's Changed

• added intervention/image-laravel to the composer suggests list
• added documentation about upgrading intervention/image to v3 by @frasmage in https://github.com/plank/laravel-mediable/pull/348

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.1...6.0.2

• Fix readthedocs documentation build configuration

Full Changelog: https://github.com/plank/laravel-mediable/compare/6.0.0...6.0.1

What's Changed

Version 6.0 contains numerous long-requested feature additions, quality of life improvements and optimizations under the hood.

Compatibility

• Dropped support for PHP 7.4 and 8.0
• Dropped Support for Laravel 8 and 9
• Added Support for PHP 8.3
• Added Support for Laravel 11
• Added support for intervention/image 3.0
• Modernized the database migration files to use more recent Laravel conventions.

Mediable

• Added MediableInterface which lists all methods added by the trait

MediaUploader

• Added support for recording alt attributes on Media (database migration required). MediaUploader now exposes a withAltAttribute() method to set the alt attribute on the generated media record.
• Added MediaUploader::applyImageManipulation() to make changes to the original uploaded image during the upload process.
• Added MediaUploader::validateHash() to ensure that the hash of the uploaded file matches a particular value during upload. Supports any hashing algorithm supported by PHP's hash() function.
• By default, the MediaUploader will always use the MIME type inferred from the file contents, regardless of the source. Added the MediaUploader::preferClientMimeType() to indicate that the MIME type provided by the source should be used instead, if provided. The default behaviour can be configured with the 'prefer_client_mime_type' key in the config/mediable.php file.
• The MediaUploader::useHashForFilename() method now accepts an optional parameter to specify which hashing algorithm to use to generate the filename. Supports any hashing algorithm supported by PHP's hash() function.
• MediaUploader will now use the visibility defined on the filesystem disk config if the makePublic()/makePrivate() methods are not called, instead of assuming public visibility.
• MediaUploader now supports data URL strings as an input source, e.g. data:image/jpeg;base64,....
• If a filename is not provided to the MediaUploader, and none can be inferred from the source, the uploader will throw an exception.
• If the file extension is not available from the source, the uploader will now consistently infer it from the MIME type. Previously this behaviour was inconsistent across different source adapters.

SourceAdapters

All SourceAdapter classes have been significantly refactored.

• All sourceAdapters will now never load the entire file contents into memory (unless it is already in memory) to determine metadata about the file, in order to avoid memory exhaustion when dealing with large files. If reading the file is necessary, most adapters will attempt use a single streamed scan of the file to load all metadata at once, to speed up to the precess. Remote files will be cached to temp:// to avoid repeated HTTP requests.
• Removed getStreamResource() method. The method has been replaced with the getStream(): StreamInterface, which returns a PSR-7 stream implementation instead.
• Added hash(string $algo): string method which is expected to return the hash of the file contents using the specified algorithm.
• The return type of the filename() and extension() method is now nullable. If the adapter cannot determine the value from the information available, it should return null.
• Removed the getContents() method. The getStream()->getContents() method may be used instead.
• Removed the getSource() method. No replacement.
• Removed the path() method. No replacement.
• Removed the valid() method. SourceAdapters should now throw an exception with a more helpful message from the constructor if the source is not valid.

ImageManipulation

• Added support for optimizing manipulated images, using the spatie/image-optimizer package, which supports a variety of image optimization tools for different image formats (jpegoptim, pngquant, optipng, gifsicle, etc.)
• Default image optimization behaviour can configured in the config/mediable.php file to specify the optimization tools to use and their arguments.
• Added ImageManipulation::noOptimization() and ImageManipulation::optimize(?array $optimizers = null) methods to allow overriding the defaults set in the config file.
• The ImageManipulation::useHashForFilename() method now accepts an optional parameter to specify which hashing algorithm to use to generate the filename. Supports any hashing algorithm supported by PHP's hash() function.
• The ImageManipulation::usingHashForFilename() method has been renamed to ImageManipulation::isUsingHashForFilename() to avoid confusion with the useHashForFilename() method.

Media

• Added alt attribute to the Media model.
• The Media class now exposes a dynamic url attribute which will generate a URL for the file (equivalent to the getUrl() method).

Other

• Improved MediableCollection annotions to support generic types.
• Added missing type declarations to most property and method signatures.
• Removed the \Plank\Mediable\Stream class in favor of the guzzlehttp/psr7 implementation. This removes the direct dependency on the psr/http-message library.
• \Plank\Mediable\HandlesMediaUploadExceptions::transformMediaUploadException() parameter and return type changed from \Exception to \Throwable.
• Added PHPStan static analysis to the test suite.

New Contributors

• @Sparclex made their first contribution in https://github.com/plank/laravel-mediable/pull/322
• @anilkumarthakur60 made their first contribution in https://github.com/plank/laravel-mediable/pull/336
• @karmendra made their first contribution in https://github.com/plank/laravel-mediable/pull/340
• @abbasudo made their first contribution in https://github.com/plank/laravel-mediable/pull/327

Full Changelog: https://github.com/plank/laravel-mediable/compare/5.9.1...6.0.0

What's Changed

• feat:add dependabot by @GeoSot in https://github.com/plank/laravel-mediable/pull/307
• Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/plank/laravel-mediable/pull/308
• Bump actions/cache from 2 to 3 by @dependabot in https://github.com/plank/laravel-mediable/pull/309
• update psr/http-message requirement to 2.0 by @frasmage in https://github.com/plank/laravel-mediable/pull/318

Full Changelog: https://github.com/plank/laravel-mediable/compare/5.9.0...5.9.1

What's Changed

• Add support for Laravel 10 by @frasmage and @selfsimilar in https://github.com/plank/laravel-mediable/pull/306

Full Changelog: https://github.com/plank/laravel-mediable/compare/5.8.0...5.9.0

What's Changed

• Pass media to manipulation callback by @frasmage in https://github.com/plank/laravel-mediable/pull/299
• Support scoped disk driver by @frasmage in https://github.com/plank/laravel-mediable/pull/300

Full Changelog: https://github.com/plank/laravel-mediable/compare/5.7.0...5.8.0

What's Changed

• Allow database access using a user-defined connection by @giant-robot in https://github.com/plank/laravel-mediable/pull/297

New Contributors

• @giant-robot made their first contribution in https://github.com/plank/laravel-mediable/pull/297

Full Changelog: https://github.com/plank/laravel-mediable/compare/5.6.0...5.7.0

• When defining image variants, it is now possible to pass one or more tags as a third argument
• Added ImageManipulator::getVariantDefinitionsByTag() and ImageManipulator::getVariantNamesByTag() to more easily retrieve a group of variants intended for a specific purpose
• Added ImageManipulator::getAllVariantDefinitions() and ImageManipulator::getAllVariantNames()
• Fixed MediaUploader::import() not working if the extension of the existing file is uppercase.

• Filename and pathname sanitization will use the app locale when transliterating UTF-8 characters to ascii.
• Restored original behaviour of treating unrecognized mime types as application/octet-stream (changed in recent version of Flysystem)

• Fixed S3 temporary URL generation for Laravel 9+ / Flysystem 3+

• Added support for Laravel 9
• Dropped support for PHP 7.3
• Dropped support for Laravel 6.x and 7.x
• Fixed S3 temporary URL generation not respecting disk root configuration.

• Support specifying file visibility on variant creation

• Fix aggregate type matching not properly handling case mismatches of mime types and/or extensions
• Handle Guzzle stream_for() deprecation

• Allow passing filesystem options via uploader and mover

• Fixed Facade PHPDOC typehints

• Added MediaUploader::onDuplicateReplaceWithVariants() which behaves similar to onDuplicateReplace() but will also delete any variants of the replaced Media record.
• Fixed onDuplicateUpdate() failing if file exists but without a matching model.

• Fixed MediaUploader Facade returning the same instance