Skip to content

Commit f210580

Browse files
committed
Draft 5.0 update process
1 parent 508fd53 commit f210580

File tree

1 file changed

+22
-12
lines changed

1 file changed

+22
-12
lines changed

docs/update_and_migration/from_4.6/update_to_5.0.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,21 @@ Before you update to v5.0, you need to [update to the latest maintenance release
1313

1414
When you have the last version of 4.6, you can update to v5.0.
1515

16+
### Requirements
17+
1618
First, match v5.0's [requirements](requirements.md).
1719
It supports only PHP 8.3 and above.
1820

19-
### Update custom code for PHP 8.3+
21+
### Update custom code for PHP 8.3+ and DXP 4.6
2022

2123
If your DXP 4.6 is running on a PHP below 8.3, start migrating it to PHP 8.3.
2224

2325
Use Ibexa Rector to help yourself to upgrade PHP code for 8.3,
2426
see [`ibexa/rector`'s README](https://github.com/ibexa/rector?tab=readme-ov-file#ibexa-dxp-rector) for more information about installation and usage.
2527

28+
Rector might also find out code deprecated in 4.6 which are likely removed in 5.0.
29+
Update according to its report to reduce this debt and have less code not compatible with 5.0.
30+
2631
TODO: Example with our own code samples?
2732
TODO: list of features deprecated in 4.6 removed in 5.0?
2833

@@ -323,23 +328,28 @@ You can track the renamming in the `ibexa-4.6.latest-to-5.0.0.sql` files or in t
323328

324329
TODO: Compatibility "views" layers? Even if there is this layer to save time, it is recommended to update your code to use the new tables.
325330

326-
### Update custom code for [[= product_name =]] 5.0
327-
328-
TODO: Rector again, this time with 5.0 rules.
329-
330-
### Update Back Office extensions
331-
332-
TODO: Update JS, templates, CSS…
333-
TODO: Some old deprecated Webpack file names were supported in 4.6 for backward compatibility; They aren't in 5.0
334-
TODO: Conversion tables
335-
336331
#### Generate GraphQL schema
337332

338333
GraphQL is used by 4.6's Back Office
339334
but isn't used by 5.0's one.
340335

341-
Optionaly, if you are using GraphQL, generate its schema:
336+
Optionally, if you are using GraphQL in your project, generate its schema:
342337

343338
```bash
344339
php bin/console ibexa:graphql:generate-schema
345340
```
341+
342+
### Update custom code for [[= product_name =]] 5.0
343+
344+
Update the `rector.php` file to use `IbexaSetList::IBEXA_50` rule set
345+
by running the recipe:
346+
347+
```bash
348+
composer recipe:install ibexa/rector --force --reset --yes
349+
```
350+
351+
### Update Back Office extensions
352+
353+
TODO: Update JS, templates, CSS…
354+
TODO: Some old deprecated Webpack file names were supported in 4.6 for backward compatibility; They aren't in 5.0
355+
TODO: Conversion tables

0 commit comments

Comments
 (0)