Skip to content

Commit 798bbfc

Browse files
committed
minor #15803 Document PHP compatibility (lol768)
This PR was squashed before being merged into the 4.4 branch. Discussion ---------- Document PHP compatibility ref symfony/symfony#42993 This makes it, at least to me, a lot clearer what the policy is re which Symfony versions will support which versions of PHP. Please correct me if I've misunderstood anything - I am most unsure about how the minimal PHP version is chosen - obviously I've seen the `RFC` labeled issues, but am I correct in assuming this is ultimately decided by the core team before each major release? I suggested mentioning this on https://symfony.com/releases too but I think the website might be closed-source? Commits ------- 3927225 Document PHP compatibility
2 parents 50c030b + 3927225 commit 798bbfc

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed

contributing/community/releases.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,22 @@ deprecations, you can upgrade to the new major version (e.g. 5.0) without
101101
effort, because it contains the same features (the only difference are the
102102
deprecated features, which your project no longer uses).
103103

104+
PHP Compatibility
105+
-----------------
106+
107+
The **minimum** PHP version is decided for each major Symfony version by consensus
108+
amongst the :doc:`core team </contributing/code/core_team>` and documented as
109+
part of the :ref:`technical requirements for running Symfony applications
110+
<symfony-tech-requirements>`.
111+
112+
Throughout each Symfony release's support lifetime, all released versions of PHP
113+
including new major versions will be supported. In this way, the **maximum** supported
114+
version of PHP for a maintained Symfony release is the latest released
115+
one that is publicly available.
116+
117+
For out-of-support releases of Symfony, the latest PHP version at time of EOL is the last
118+
supported PHP version. Newer versions of PHP may or may not function.
119+
104120
Rationale
105121
---------
106122

setup.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,10 @@ Before creating your first Symfony application you must:
2020
* Install PHP 7.1 or higher and these PHP extensions (which are installed and
2121
enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
2222
`PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
23+
24+
* Note that all newer, released versions of PHP will be supported during the
25+
lifetime of each Symfony release (including new major versions).
26+
For example, PHP 8.0 is supported.
2327
* `Install Composer`_, which is used to install PHP packages.
2428

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

0 commit comments

Comments
 (0)