Skip to content

Commit 4066e46

Browse files
authored
Merge pull request #5 from ace-of-aces/fix/installation-requirements
[Enhancement] improve requirements and installation instructions
2 parents 2d4637c + b978a14 commit 4066e46

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

README.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,19 @@ Easy, URL-based image transformations inspired by [Cloudflare Images](https://de
1818

1919
- PHP \>= 8.4
2020
- Laravel 12.x
21+
- [GD PHP Library](https://www.php.net/manual/en/book.image.php)
2122

2223
If you want to use the file caching feature (highly recommended), a configured `Storage` disk and a `Cache` driver is required. More info in the [Image Caching](#image-caching) section.
2324

24-
> [!IMPORTANT]
25-
> It is highly recommended to set a minimum memory limit of 256MB in your `php.ini` file to avoid memory issues when images are being processed.
25+
### Important `php.ini` settings❗
26+
1. The underlying image processing library (GD) can use alot more RAM than regular web requests. It's highly recommended to set your memory limit to *at least* 256MB.
27+
```
28+
memory_limit=512M
29+
```
30+
2. If you have the [Swoole extension](https://laravel.com/docs/octane#swoole) installed, make sure you have the following setting to [avoid conflicts](https://github.com/ace-of-aces/laravel-image-transform-url/issues/4) with Laravel's `defer` helper which this package uses.
31+
```
32+
swoole.use_shortname=off
33+
```
2634

2735
## Installation
2836

0 commit comments

Comments
 (0)