IBX-11485: Update doc for Symfony 7.4#3098
Conversation
Preview of modified filesPreview of modified Markdown: |
| ``` bash | ||
| yarn upgrade @ibexa/frontend-config @ibexa/ts-config | ||
| composer require ibexa/headless:v5.0.7 --with-all-dependencies --no-scripts | ||
| composer recipes:install ibexa/headless --force -v |
There was a problem hiding this comment.
due to how flex resolves recipes, and that we forked JMSTranslationBundle this command at first installs recipes for our fork - so it tries to add JMSTranslationBundle to bundles.php which is already there, and then it UNinstall recipes for original repository and that step eventually removes entry from bundles.php. There is no easy way around that, that would not affect fresh installs, so our suggestion at this moment is that after recipes:install you should manually restore
JMS\TranslationBundle\JMSTranslationBundle::class => ['all' => true], in bundles.php in old position
There was a problem hiding this comment.
Thanks, added in eb85427 , could you have a look?
Recipes - love them when they work, hate them when they don't 😓
|
I took the liberty to add https://ibexa.atlassian.net/browse/IBX-11485 to this one, since it basically resolves this issue by adding an additional step. 😉 |
|
@konradoboza I added a section for the "gotcha" of SF 7.4 (var/share dir) in fa5d64d , could you please have a look again? |
adriendupuis
left a comment
There was a problem hiding this comment.
Section 2. shouldn't be empty and shouldn't let the reader helpless.
The "official Symfony upgrade instructions" paragraph could be moved up into this section 2.
| 2. To allow installing Symfony 7.4, update the requirements for `symfony` packages in `composer.json` as in the example below: | ||
|
|
||
| ``` diff | ||
| - "symfony/console": "7.3.*", | ||
| + "symfony/console": "7.4.*", | ||
| ``` |
There was a problem hiding this comment.
I would try to emphase on that every package must be updated so reader don't do it only for the console as in the example:
| 2. To allow installing Symfony 7.4, update the requirements for `symfony` packages in `composer.json` as in the example below: | |
| ``` diff | |
| - "symfony/console": "7.3.*", | |
| + "symfony/console": "7.4.*", | |
| ``` | |
| 2. To allow installing Symfony 7.4, update the requirements for **all** `symfony` packages in `composer.json` as in the example below: | |
| ``` diff | |
| - "symfony/<package>": "7.3.*", | |
| + "symfony/<package>": "7.4.*", | |
| ``` |
|
|
Thank you @adriendupuis , I've added your suggestions in https://github.com/ibexa/documentation-developer/pull/3098/commits |
| - Array-based PHP configuration format | ||
|
|
||
| As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. | ||
| You should commit this file to the repository. |
There was a problem hiding this comment.
"should" implies that thay may under certain circumstances not commit the file, like Polish "powinien". "must" would imply no other option.
There was a problem hiding this comment.
It's optional, but recommended - it's the wording Symfony uses in https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration#:~:text=PHP%2E-,These,config%2F%22%5D%29%2E
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
* Init next release notes w/ postponed * mkdocs.yml: Increment latest_tag_* * Symfony 7.4 #3098 * Apply suggestion from @adriendupuis * Revert "Apply suggestion from @adriendupuis" This reverts commit 519103f. * ibexa_dxp_v5.0.md: Raptor connector LTS Update * ibexa_dxp_v5.0.md: Raptor connector LTS Update (Format) * Apply suggestion from vale * Apply suggestions from @julitafalcondusza Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * ibexa_dxp_v5.0.md: translation components, AI in PB * ibexa_dxp_v5.0.md: Narrowed link for Raptor connector * ibexa_dxp_v5.0.md: Sort editions and add Quable * ibexa_dxp_vX.Y.md: Taxonomy search criteria * ibexa_dxp_v4.6.md: Taxonomy search criteria: fix links * Comment include 'snippets/release_XY.md' * Use absolute links in snippets/release_XY.md * Add Quable to ibexa_dxp_v4.6.md * Add Integrated help's Product tour * Raptor connector isn't an LTS Update * Raptor connector isn't an LTS Update * Quable is an add-on * ibexa_dxp_v5.0.md: REST API request body examples * ibexa_dxp_v5.0.md: PHP API * ibexa_dxp_v5.0.md: PHP API * Quable PIM isn't for Commerce * Move Quable PIM up, rm badges * ibexa_dxp_v5.0.md: Fix link * Quable isn't for 4.6 * Add PHP API draft to release notes * Apply suggestion from @dabrt * remove blur, set versions and date * uncomment include_file * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Move AI Actions in blocks upper * TaxonomySubtree isn't new to these release * Update the next release date --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>
* Raptor integration - feature branch (#3121) * first batch added * content added * recommendations twig page added * updates * content moved, structure updated * guide added * guide content * fixes, content moved * fixes after review * Raptor integration - feature branch: fix links (#3123) * Add preview of linked PHP API Ref entries * Fix few links * new batch of fixes * updates * new blocks added * name fix * fix * new page added to cards on raptor_connector landing page * fixes - first batch * new fixes * PHP & JS CS Fixes * new fixes * block names fixed * code fixed * code fixed * links fixed * card fixed * IBX-11571: Rendering recommendations outside of Page Builder documented in Dev-doc (#3127) * Update JWT (#3108) * development_security.md: Update JWT firewalls ibexa/recipes-dev#122 ibexa/recipes-dev#124 ibexa/recipes-dev#125 * rest_api_authentication.md: XML isn't supported for JWT ibexa/rest#101 * render doc added * updates * img added, content added * mkdocs * fixes after rev * fix * fixes --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * php fix * composer.json fix - connector-raptor added * Raptor integration - feature branch: Fix PHP (#3130) * EventData.php: Wrap into a class * Event*.php: Format * language fixes * Raptor integration: Rework PHP (#3131) * tracking_php_api.md: Detail EventMapper, EventType, EventContext * tracking_php_api.md: caution about buy event --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * server description updated --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: julitafalcondusza <julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Added translation-related Twig Component groups (#3091) * Doc for Quable (#3085) * Renaming - part one * Current status * Install doc ready? * Fixed build * Configuration doc * Removed Quable other * Added product guide skeleton * Guide * Current status * Customize product embeds * Added missing search doc * Attribute rendering * Provided a list of attributes * Fixed mkdocs build * Self review * Added product code limitatin * Fix typos * Removed asset mentions * Self review * Selfreview done * Apply suggestion from @mnocon * Fixed table rendering * Added Quable API * Removed Quable client package * Adrien's review * After review * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Review changes * Update docs/product_catalog/quable/install_quable.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Update docs/product_catalog/add_remote_pim_support.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Update docs/product_catalog/customize_product_embed_templates.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Manual changes * Apply suggestions from code review Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com> * Manual review feedback * Added doc for language configuration (#3128) * Added doc for language configuration * Apply suggestion from @mnocon --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com> * Added doc for TaxonomyNoEntries & TaxonomySubtree (#3082) * Added doc for TaxonomyNoEntries * Added doc for Taxonomy subtree * Fixed CS * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Apply suggestion from @mnocon * Rebuild --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * IBX-11485: Update doc for Symfony 7.4 (#3098) * Update doc for Symfny 7.4 * Added bundle entry * Apply suggestion from @mnocon * Added var/share mention * Review feedback * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Product tour (#3065) * Product tour doc skeleton * Review feedback * Vale * Review feedback - part 2 * Added doc for the new config * Review feedback * Adjusted includes * Wording * Specified button name * Removed TODO * Help Center and Product tour enabled by default * Added images and interactive demo * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Manual changes * [TMP] Fix build * Fixed build * Reworded --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Documented try_catch (and sql: execute) in migrations (#3060) * Added doc for try_catch and sql in migrations * Vale suggestions * Vale suggestion * Added missing code block * Review feedback * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Improved example and clarified migration and migratoin step usage * Removed RN enties --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * IBX-10998: Document Gemini connector (#3025) * IBX-10998: Document Gemini connector * Update docs/ai_actions/extend_ai_actions.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Implement reviewer comments * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Add RN entry * IBX-11401: Describe Gemini embeddings provider (#3120) * IBX-11401: Describe Gemini embeddings provider * Remove the RN entry * Fied broken link * Fixed event page name --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Added doc for additional parameter for ibexa_render (#3043) * Added doc for additional parameter for ibexa_render * Added update sections * Update docs/update_and_migration/from_5.0/update_from_5.0.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Reworked RN drafts * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Removed RN entries --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Product tour: Deptract+Rector fixes (#3136) * deptrac.baseline.yaml: Ignore NotificationScenarioSubscriber * NotificationScenarioSubscriber: Apply Rector suggestions * customize_product_tour.md: Update hl_lines * updated_at_criterion.md: Rm EOF blank lines * Release 5.0.7 follow up (#3137) * Added homepage mention * Applied update doc suggestion * Reworded Gemini connector * Fixed link? * search_api.md: Minor fixes * Raptor Add/Update buy event (#3141) * tracking_php_api.md: Rm caution w/ EventType::BUY * recommendations_twig_functions: Add buy event, sort events * tracking_php_api.md: More PHP API Ref links in mapping intro --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * 5.0.7 update (#3143) * Added DB update scripts * Mention that ibexa:setup is deprecated * Reordered * Reworded * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Release 5.0.7 fixes (#3140) * Highlight and wording fixes * Fixes * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Extracted to separate yaml file * Apply suggestion from @adriendupuis Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Release notes for v5.0.7 and v4.6.29 (#3133) * Init next release notes w/ postponed * mkdocs.yml: Increment latest_tag_* * Symfony 7.4 #3098 * Apply suggestion from @adriendupuis * Revert "Apply suggestion from @adriendupuis" This reverts commit 519103f. * ibexa_dxp_v5.0.md: Raptor connector LTS Update * ibexa_dxp_v5.0.md: Raptor connector LTS Update (Format) * Apply suggestion from vale * Apply suggestions from @julitafalcondusza Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * ibexa_dxp_v5.0.md: translation components, AI in PB * ibexa_dxp_v5.0.md: Narrowed link for Raptor connector * ibexa_dxp_v5.0.md: Sort editions and add Quable * ibexa_dxp_vX.Y.md: Taxonomy search criteria * ibexa_dxp_v4.6.md: Taxonomy search criteria: fix links * Comment include 'snippets/release_XY.md' * Use absolute links in snippets/release_XY.md * Add Quable to ibexa_dxp_v4.6.md * Add Integrated help's Product tour * Raptor connector isn't an LTS Update * Raptor connector isn't an LTS Update * Quable is an add-on * ibexa_dxp_v5.0.md: REST API request body examples * ibexa_dxp_v5.0.md: PHP API * ibexa_dxp_v5.0.md: PHP API * Quable PIM isn't for Commerce * Move Quable PIM up, rm badges * ibexa_dxp_v5.0.md: Fix link * Quable isn't for 4.6 * Add PHP API draft to release notes * Apply suggestion from @dabrt * remove blur, set versions and date * uncomment include_file * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Move AI Actions in blocks upper * TaxonomySubtree isn't new to these release * Update the next release date --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Made Date and time/Symbol attribute links version aware * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Fixed broken link * Added PHP API links * Added security note --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: julitafalcondusza <julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com>



Target: Link change is for 5.0 only, but update instructions are 4.6 and 5.0
Adding update instructions for Symfony 7.4
Status: needs to be merged together with the 5.0.7 release.
JIRA: https://ibexa.atlassian.net/browse/IBX-11485