Skip to content

Conversation

nicolas-grekas
Copy link
Member

@nicolas-grekas nicolas-grekas commented Oct 1, 2025

Fix #21447 for branch 8.0 (7.4 might need some inline notes)
This removes all mentions of XML that are in relation with configuring routes and services.
Of course this keeps XML for translations, validation, serializer and Doctrine entities, among a few others.

@nicolas-grekas nicolas-grekas requested a review from xabbuh as a code owner October 1, 2025 09:37
@carsonbot carsonbot added this to the 7.4 milestone Oct 1, 2025
@carsonbot carsonbot changed the title Remove mentions of the deprecated XML format Remove mentions of the deprecated XML format Oct 1, 2025
@wouterj
Copy link
Member

wouterj commented Oct 1, 2025

Thanks for starting this!

I think we should only do this change in the docs on 8.0 for 2 reasons:

  • The doc examples will be the resource people use to convert their XML config to Yaml/PHP. It's a bit of a bummer to have to version switch to 7.3 each time for this.
  • This is emphasized by a recent change to only show x.4 for eol major versions. We have the same problem with the big security refactor: because I rewrote the entire docs in 5.3 already, people still using the old system on 5.4 will now have to switch back all the way to 4.4 for the older security documentation.

@nicolas-grekas
Copy link
Member Author

nicolas-grekas commented Oct 2, 2025

Works for me. PR rebased to target 8.0
Not sure what should be done on 7.4. If someone else can take care of that aspect that'd be cool!

@xabbuh xabbuh modified the milestones: 7.4, 8.0 Oct 2, 2025
@wouterj
Copy link
Member

wouterj commented Oct 2, 2025

Not sure what should be done on 7.4. If someone else can take care of that aspect that'd be cool!

For 7.4, I guess we can leave the examples as-is, and only update this section in 7.4 to no longer mention XML: https://symfony.com/doc/current/configuration.html#configuration-formats. And probably add a .. deprecated:: 7.4 directive so people looking for it can still find some informatio. That way, we don't lead new users to choose a format that is deprecated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants