Skip to content

Document PHP compatibility #15803

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.

Sign up for GitHub

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

Merged
merged 1 commit into from
Sep 14, 2021
Merged

Document PHP compatibility #15803

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions contributing/community/releases.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,22 @@ deprecations, you can upgrade to the new major version (e.g. 5.0) without
effort, because it contains the same features (the only difference are the
deprecated features, which your project no longer uses).

PHP Compatibility
-----------------

The **minimum** PHP version is decided for each major Symfony version by consensus
amongst the :doc:`core team </contributing/code/core_team>` and documented as
Comment on lines +107 to +108
Copy link
Contributor

@ro0NL ro0NL Sep 13, 2021 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i was also curious if there's some rule maybe? IIUC new SF major requires latest PHP major at time of release, right? in that sense, is it predictable?

Copy link
Member

@derrabus derrabus Sep 13, 2021 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wouldn't dare to predict the min PHP version for Symfony 7, 8 and 9 years in advance, if that's what you mean. 😉

Related: symfony/symfony#40389

Copy link
Contributor

@ro0NL ro0NL Sep 13, 2021 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

then i predict SF 8 will require PHP 9 ;)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm gonna bookmark this discussion. Let's see how well it ages. 😁

part of the :ref:`technical requirements for running Symfony applications
<symfony-tech-requirements>`.

Throughout each Symfony release's support lifetime, all released versions of PHP
including new major versions will be supported. In this way, the **maximum** supported
version of PHP for a maintained Symfony release is the latest released
one that is publicly available.

For out-of-support releases of Symfony, the latest PHP version at time of EOL is the last
supported PHP version. Newer versions of PHP may or may not function.

Rationale
---------

Expand Down
4 changes: 4 additions & 0 deletions setup.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,10 @@ Before creating your first Symfony application you must:
* Install PHP 7.1 or higher and these PHP extensions (which are installed and
enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
`PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;

* Note that all newer, released versions of PHP will be supported during the
lifetime of each Symfony release (including new major versions).
For example, PHP 8.0 is supported.
* `Install Composer`_, which is used to install PHP packages.

Optionally, you can also `install Symfony CLI`_. This creates a binary called
Expand Down