Skip to content

Commit 3aba2cd

Browse files
committed
Add error handler warning to update guide
1 parent 6fac7c4 commit 3aba2cd

File tree

2 files changed

+21
-6
lines changed

2 files changed

+21
-6
lines changed

docs/infrastructure_and_maintenance/performance.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,17 @@ In production setups:
5252
- Always enable opcache for php-fpm/`mod_php`.
5353
- Prefer php-fpm and web server using it over fast-cgi for lower overall memory usage.
5454

55+
!!! caution
56+
57+
To avoid deprecations when using PHP 8.2 or 8.3, [[= product_name =]] v4.6 needs an additional error handler.
58+
The error handler is present by default for projects that started with 4.6.8 or later.
59+
For projects that started with earlier versions, you need to add the error handler manually by running the following commands:
60+
61+
``` bash
62+
composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
63+
composer dump-autoload
64+
```
65+
5566
### Symfony
5667

5768
- Review the [Symfony performance documentation]([[= symfony_doc =]]/performance.html) and apply matching suggestions, including OPCache configuration if enabled.

docs/update_and_migration/from_4.6/update_from_4.6.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,15 @@ First, run:
3232

3333
Then execute the instructions below starting from the version you're upgrading from.
3434

35+
!!! caution
36+
37+
To avoid deprecations when using PHP 8.2 or 8.3, run the following commands:
38+
39+
``` bash
40+
composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
41+
composer dump-autoload
42+
```
43+
3544
<!-- vale Ibexa.VariablesVersion = NO -->
3645

3746
## v4.6.1
@@ -123,12 +132,7 @@ No additional steps needed.
123132

124133
## v4.6.8
125134

126-
To avoid deprecations when updating from an older PHP version to PHP 8.2 or 8.3, run the following commands:
127-
128-
``` bash
129-
composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
130-
composer dump-autoload
131-
```
135+
No additional steps needed.
132136

133137
## v4.6.9
134138

0 commit comments

Comments
 (0)