Skip to content

Update setup.rst to mention about Intl extension #21285

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from

Conversation

amirhosseindz
Copy link

Without the Intl extension, composer install will face a PHP fatal error

Without the Intl extension, `composer install` will face a PHP fatal error
@carsonbot carsonbot changed the title Update setup.rst to mention about Intl extension Update setup.rst to mention about Intl extension Aug 12, 2025
@xabbuh
Copy link
Member

xabbuh commented Aug 12, 2025

What error did you get without the extension being installed?

javiereguiluz added a commit that referenced this pull request Aug 14, 2025
…xtension (javiereguiluz)

This PR was squashed before being merged into the 6.4 branch.

Discussion
----------

[Translation] Mention that you need to install the PHP extension

Related to #21285, I propose to mention that you must have the `intl` PHP extension for proper translation and localization.

Commits
-------

0683d25 [Translation] Mention that you need to install the PHP extension
@javiereguiluz
Copy link
Member

@amirhosseindz thanks for this contribution.

We've reviewed this was our conclusion:

  • Symfony includes polyfills related to PHP intl, so you don't have to install that extension to use Symfony.
  • But, those polyfills only support English, so they can't be use for proper translation/localization.

So, we think that:

  • The setup guide is correct to not mention that extension as a requirement (not all folks translate apps and even those don't necessarily need it because of the reason explained above)
  • But the main translation article should mention that you probably must install the intl extension.

We've just updated the docs to mention that (see #21286), so we're closing this one without merging. But, if you see any error when installing Symfony witohut the intl extension, please share the error details here so we reopen this and fix it. Thanks!

@amirhosseindz
Copy link
Author

I faced the error in my MacBook while I was just trying to install the framework via the Symfony CLI command. I could get over it only by installing this extension. I will try to reproduce the error if I find some time. Thanks for following up.

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