PHPackages dnabeast/bladeimagecrop - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. dnabeast/bladeimagecrop ActiveLibrary[Image & Media](/categories/media) dnabeast/bladeimagecrop ======================= Creates a blade component that grabs an image and resizes it and crops it to match the blade settings. 3.4.13(5mo ago)0184MITPHPPHP ^7.3|^8.0 Since Mar 13Pushed 5mo ago1 watchersCompare [ Source](https://github.com/dnabeast/BladeImageCrop)[ Packagist](https://packagist.org/packages/dnabeast/bladeimagecrop)[ Docs](https://github.com/dnabeast/bladeimagecrop)[ RSS](/packages/dnabeast-bladeimagecrop/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (5)Versions (38)Used By (0) Blade Image Crop ================ [](#blade-image-crop) About Blade Image Crop 3 ------------------------ [](#about-blade-image-crop-3) Use WebP without the headache. Provide alternate image sizes for your user's preferred display. Reference one image on your server then specify its dimensions in a blade component. All the image work you're too lazy to do but with the ease of a single blade tag. This crops and resizes automatically and creates multiple versions for high DPI devices and new image formats. It then creates the HTML required to display them. It supports - Automatic cropping to a specified aspect ratio and focus point - Multiple files for different DPI - webp with jpeg as a fallback (In a picture tag) - Inline backgrounds that display first on slow connections - Mobile and desktop versions - local AND online images - queuing the image processing Installation ------------ [](#installation) You can install the package via composer: ``` composer require dnabeast/bladeimagecrop ``` You can publish the config file ``` php artisan vendor:publish --provider="DNABeast\BladeImageCrop\BladeImageCropServiceProvider" ``` By default the system is set to use the Laravel public storage path so don't forget to set up ``` php artisan storage:link ``` Or make whatever changes you wish to the storage. (more info below) Upgrade Guide ------------- [](#upgrade-guide) Because it uses the Laravel Http helper this program no longer supports Laravel 6. By default we use Image Magick which comes installed by default on Laravel Forge. There is still the option to switch to GD library by publishing the config file and selecting the GD options. The system now grabs the original src from the public directory OR an URL (rather than the weird workaround needed by the FileStorage system ) The next time you load an image using the blade component it will duplicate your image to a holding directory and remake your resized images. It will only do this once. You can safely remove older versions of files. If you've turned the images\_from\_public\_path to false then it's not going to work any more and you'll have to update your img src attributes. No longer upscales images if the original image is too small. (It allows the browser to do this) Usage ----- [](#usage) ### The easy image tag [](#the-easy-image-tag) #### Only resizing the image [](#only-resizing-the-image) If you want your image to resize to a specific width and not trim the height you may have had your image like so ``` ``` Instead you would put ``` ``` The initial image would be resized and saved to a 300px wide version and a 600px wide version (for hi-res displays) in JPG format. The resulting output would be ``` ``` This will result in ``` env('BLADE_CROP_ENABLED', false), ``` or set it in your .env ``` BLADE_CROP_ENABLED=false ``` **Are you getting this error?** ``` syntax error, unexpected end of file, expecting "elseif" or "else" or "endif" ``` It probably means you haven't closed the blade component tag. Use one of these solutions. ``` ``` **How about this one?** ``` File not found at path: imageNotFound ``` or the image is appearing as an empty 4x3 aspect rectangle. The original image isn't where you told it. It should be looking in the public path. If you've done something weird to your public path this is a good place to start looking. In your local environment you can check the img's output image path to see the full path that it's looking for the image. **Server failures? 500 errors?** When loading a page of many images or some big images the php service can get overwhelmed. BladeImageCrop does the image processing asynchronously so perhaps try setting up your queue drivers. **Images are showing sideways or upside down** Some images taken on devices that register orientation (smart phones etc) will show the image upright and then display in the browser at the incorrect angle. This is slowly getting fixed by browsers but until then the solution exists only when you're using Image Magick. If Image Magick in installed on your server they will auto align but with only GD there is no current fix for ths issue. You will need to resave this image using your photo processing software of choice. ### Testing [](#testing) ``` vendor/bin/phpunit ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Dan Beeston](https://github.com/dnabeast) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Laravel Package Boilerplate --------------------------- [](#laravel-package-boilerplate) This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com). ### Health Score 43 — FairBetter than 91% of packages Maintenance69 Regular maintenance activity Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~47 days Recently: every ~63 days Total 37 Last Release 179d ago Major Versions 1.0.0 → 2.0.02021-09-10 2.0.11 → 3.0.02022-10-04 PHP version history (3 changes)1.0.0PHP ^7.3 2.0.0PHP ^7.3|^8.0 3.1.0PHP ^7.3|^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/cf76c68ac95629b7f74a5c56306a5e8c9dd9148dcaf46eef97048429fd6db578?d=identicon)[dnabeast](/maintainers/dnabeast) --- Top Contributors [![dnabeast](https://avatars.githubusercontent.com/u/3229763?v=4)](https://github.com/dnabeast "dnabeast (42 commits)") --- Tags dnabeastbladeimagecrop ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/dnabeast-bladeimagecrop/health.svg) ``` [![Health](https://phpackages.com/badges/dnabeast-bladeimagecrop/health.svg)](https://phpackages.com/packages/dnabeast-bladeimagecrop) ``` ### Alternatives [bkwld/croppa Image thumbnail creation through specially formatted URLs for Laravel 510496.0k22](/packages/bkwld-croppa)[spatie/laravel-og-image Generate OG images for your Laravel app 305.2k](/packages/spatie-laravel-og-image)[daun/statamic-placeholders Generate low-quality image placeholders for lazyloading Statamic assets 106.6k](/packages/daun-statamic-placeholders)[abordage/laravel-og-images Generate Open Graph images (og:image, twitter:image, vk:image) for each site pages 122.8k](/packages/abordage-laravel-og-images)[daun/statamic-mux Seamless video encoding and streaming using Mux on Statamic sites 132.3k](/packages/daun-statamic-mux) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)