Skip to content

Commit ca3b4c8

Browse files
committed
feature #4753 bump Symfony requirements to PHP 5.5 (xabbuh)
This PR was merged into the master branch. Discussion ---------- bump Symfony requirements to PHP 5.5 | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no (but mandatory due to symfony/symfony#12522) | Applies to | 3.0+ | Fixed tickets | Commits ------- bcab77b bump Symfony requirements to PHP 5.5
2 parents 9919bca + bcab77b commit ca3b4c8

File tree

15 files changed

+25
-85
lines changed

15 files changed

+25
-85
lines changed

Diff for: book/controller.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Controllers are also called *actions*.
116116

117117
This controller is pretty straightforward:
118118

119-
* *line 4*: Symfony takes advantage of PHP 5.3 namespace functionality to
119+
* *line 4*: Symfony takes advantage of PHP's namespace functionality to
120120
namespace the entire controller class. The ``use`` keyword imports the
121121
``Response`` class, which the controller must return.
122122

@@ -559,7 +559,7 @@ Symfony will automatically return a 500 HTTP response code.
559559
throw new \Exception('Something went wrong!');
560560
561561
In every case, an error page is shown to the end user and a full debug
562-
error page is shown to the developer (i.e. when you're using ``app_dev.php`` -
562+
error page is shown to the developer (i.e. when you're using ``app_dev.php`` -
563563
see :ref:`page-creation-environments`).
564564

565565
You'll want to customize the error page your user sees. To do that, see the

Diff for: book/installation.rst

+2-16
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,6 @@ Using the Symfony Installer is the only recommended way to create new Symfony
1616
applications. This installer is a PHP application that has to be installed
1717
only once and then it can create any number of Symfony applications.
1818

19-
.. note::
20-
21-
The installer requires PHP 5.4 or higher. If you still use the legacy
22-
PHP 5.3 version, you cannot use the Symfony Installer. Read the
23-
:ref:`book-creating-applications-without-the-installer` section to learn how
24-
to proceed.
25-
2619
Depending on your operating system, the installer must be installed in different
2720
ways.
2821

@@ -107,9 +100,8 @@ to use for your projects.
107100
Creating Symfony Applications without the Installer
108101
---------------------------------------------------
109102

110-
If you still use PHP 5.3, or if you can't execute the installer for any reason,
111-
you can create Symfony applications using the alternative installation method
112-
based on `Composer`_.
103+
If you can't execute the installer for any reason, you can create Symfony
104+
applications using the alternative installation method based on `Composer`_.
113105

114106
Composer is the dependency manager used by modern PHP applications and it can
115107
also be used to create new applications based on the Symfony framework. If you
@@ -168,12 +160,6 @@ possible solutions depending on your operating system. All of them are
168160
explained in the :ref:`Setting up Permissions <book-installation-permissions>`
169161
section.
170162

171-
.. note::
172-
173-
PHP's internal web server is available in PHP 5.4 or higher versions. If you
174-
still use the legacy PHP 5.3 version, you'll have to configure a *virtual host*
175-
in your web server.
176-
177163
The ``server:run`` command is only suitable while developing the application. In
178164
order to run Symfony applications on production servers, you'll have to configure
179165
your `Apache`_ or `Nginx`_ web server as explained in

Diff for: book/security.rst

-2
Original file line numberDiff line numberDiff line change
@@ -487,8 +487,6 @@ else, you'll want to encode their passwords. The best algorithm to use is
487487
// ...
488488
));
489489
490-
.. include:: /cookbook/security/_ircmaxwell_password-compat.rst.inc
491-
492490
Of course, your user's passwords now need to be encoded with this exact algorithm.
493491
For hardcoded users, you can use an `online tool`_, which will give you something
494492
like this:

Diff for: book/translation.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -405,8 +405,8 @@ checks translation resources for several locales:
405405

406406
.. note::
407407

408-
When Symfony doesn't find a translation in the given locale, it will
409-
add the missing translation to the log file. For details,
408+
When Symfony doesn't find a translation in the given locale, it will
409+
add the missing translation to the log file. For details,
410410
see :ref:`reference-framework-translator-logging`.
411411

412412
.. _book-translation-user-locale:
@@ -664,8 +664,8 @@ Translating Database Content
664664
----------------------------
665665

666666
The translation of database content should be handled by Doctrine through
667-
the `Translatable Extension`_ or the `Translatable Behavior`_ (PHP 5.4+).
668-
For more information, see the documentation for these libraries.
667+
the `Translatable Extension`_ or the `Translatable Behavior`_. For more information,
668+
see the documentation for these libraries.
669669

670670
Debugging Translations
671671
----------------------

Diff for: components/http_foundation/session_configuration.rst

-17
Original file line numberDiff line numberDiff line change
@@ -218,23 +218,6 @@ particular cookie by reading the ``getLifetime()`` method::
218218
The expiry time of the cookie can be determined by adding the created
219219
timestamp and the lifetime.
220220

221-
PHP 5.4 Compatibility
222-
~~~~~~~~~~~~~~~~~~~~~
223-
224-
Since PHP 5.4.0, :phpclass:`SessionHandler` and :phpclass:`SessionHandlerInterface`
225-
are available. Symfony provides forward compatibility for the :phpclass:`SessionHandlerInterface`
226-
so it can be used under PHP 5.3. This greatly improves interoperability with other
227-
libraries.
228-
229-
:phpclass:`SessionHandler` is a special PHP internal class which exposes native save
230-
handlers to PHP user-space.
231-
232-
In order to provide a solution for those using PHP 5.4, Symfony has a special
233-
class called :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeSessionHandler`
234-
which under PHP 5.4, extends from ``\SessionHandler`` and under PHP 5.3 is just a
235-
empty base class. This provides some interesting opportunities to leverage
236-
PHP 5.4 functionality if it is available.
237-
238221
Save Handler Proxy
239222
~~~~~~~~~~~~~~~~~~
240223

Diff for: contributing/code/patches.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Before working on Symfony, setup a friendly environment with the following
1414
software:
1515

1616
* Git;
17-
* PHP version 5.3.3 or above;
17+
* PHP version 5.5.9 or above;
1818
* `PHPUnit`_ 4.2 or above.
1919

2020
Configure Git

Diff for: cookbook/bundles/best_practices.rst

+4-5
Original file line numberDiff line numberDiff line change
@@ -29,10 +29,9 @@ Bundle Name
2929
-----------
3030

3131
A bundle is also a PHP namespace. The namespace must follow the technical
32-
interoperability `standards`_ for PHP 5.3 namespaces and class names: it
33-
starts with a vendor segment, followed by zero or more category segments, and
34-
it ends with the namespace short name, which must end with a ``Bundle``
35-
suffix.
32+
interoperability `standards`_ for PHP namespaces and class names: it starts
33+
with a vendor segment, followed by zero or more category segments, and it
34+
ends with the namespace short name, which must end with a ``Bundle`` suffix.
3635

3736
A namespace becomes a bundle as soon as you add a bundle class to it. The
3837
bundle class name must follow these simple rules:
@@ -348,7 +347,7 @@ there are 3 modes, which the user can configure in their project:
348347
* 2.4: the original 2.4 and earlier validation API;
349348
* 2.5: the new 2.5 and later validation API;
350349
* 2.5-BC: the new 2.5 API with a backwards-compatible layer so that the
351-
2.4 API still works. This is only available in PHP 5.3.9+.
350+
2.4 API still works.
352351

353352
As a bundle author, you'll want to support *both* API's, since some users
354353
may still be using the 2.4 API. Specifically, if your bundle adds a violation

Diff for: cookbook/deployment/azure-website.rst

+2-3
Original file line numberDiff line numberDiff line change
@@ -96,9 +96,8 @@ and how to properly configure PHP for a production environment.
9696
Configuring the latest PHP Runtime
9797
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9898

99-
Even though Symfony only requires PHP 5.3.3 to run, it's always recommended
100-
to use the most recent PHP version whenever possible. PHP 5.3 is no longer
101-
supported by the PHP core team, but you can update it easily in Azure.
99+
Even though Symfony only requires PHP 5.5.9 to run, it's always recommended
100+
to use the most recent PHP version whenever possible.
102101

103102
To update your PHP version on Azure, go to the **Configure** tab of the control
104103
panel and select the version you want.

Diff for: cookbook/logging/monolog.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
How to Use Monolog to Write Logs
55
================================
66

7-
Monolog_ is a logging library for PHP 5.3 used by Symfony. It is
8-
inspired by the Python LogBook library.
7+
Monolog_ is a logging library for PHP used by Symfony. It is inspired by the
8+
Python LogBook library.
99

1010
Usage
1111
-----

Diff for: cookbook/security/_ircmaxwell_password-compat.rst.inc

-13
This file was deleted.

Diff for: cookbook/security/entity_provider.rst

-2
Original file line numberDiff line numberDiff line change
@@ -355,8 +355,6 @@ the database to be encoded using this encoder. For details on how to create
355355
a new User object with a properly encoded password, see the
356356
:ref:`book-security-encoding-user-password` section of the security chapter.
357357

358-
.. include:: /cookbook/security/_ircmaxwell_password-compat.rst.inc
359-
360358
The ``providers`` section defines an ``administrators`` user provider. A
361359
user provider is a "source" of where users are loaded during authentication.
362360
In this case, the ``entity`` keyword means that Symfony will use the Doctrine

Diff for: cookbook/web_server/built_in.rst

+4-5
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,10 @@ How to Use PHP's built-in Web Server
88
The ability to run the server as a background process was introduced
99
in Symfony 2.6.
1010

11-
Since PHP 5.4 the CLI SAPI comes with a `built-in web server`_. It can be used
12-
to run your PHP applications locally during development, for testing or for
13-
application demonstrations. This way, you don't have to bother configuring
14-
a full-featured web server such as
15-
:doc:`Apache or Nginx </cookbook/configuration/web_server_configuration>`.
11+
The CLI SAPI comes with a `built-in web server`_. It can be used to run your
12+
PHP applications locally during development, for testing or for application
13+
demonstrations. This way, you don't have to bother configuring a full-featured
14+
web server such as :doc:`Apache or Nginx </cookbook/configuration/web_server_configuration>`.
1615

1716
.. caution::
1817

Diff for: quick_tour/the_big_picture.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ by showing you a simple project in action.
88
If you've used a web framework before, you should feel right at home with
99
Symfony. If not, welcome to a whole new way of developing web applications.
1010

11-
The only technical requisite to follow this tutorial is to have **PHP 5.4 or higher
11+
The only technical requisite to follow this tutorial is to have **PHP 5.5.9 or higher
1212
installed on your computer**. If you use a packaged PHP solution such as WAMP,
13-
XAMP or MAMP, check out that they are using PHP 5.4 or a more recent version.
13+
XAMP or MAMP, check out that they are using PHP 5.5.9 or a more recent version.
1414
You can also execute the following command in your terminal or command console
1515
to display the installed PHP version:
1616

Diff for: reference/configuration/framework.rst

+1-2
Original file line numberDiff line numberDiff line change
@@ -641,8 +641,7 @@ API. The ``api`` option is used to switch between the different implementations:
641641
``2.5-bc`` or ``auto``
642642
If you omit a value or set the ``api`` option to ``2.5-bc`` or ``auto``,
643643
Symfony will use an API implementation that is compatible with both the
644-
legacy implementation and the ``2.5`` implementation. You have to use
645-
PHP 5.3.9 or higher to be able to use this implementation.
644+
legacy implementation and the ``2.5`` implementation.
646645

647646
Full default Configuration
648647
--------------------------

Diff for: reference/requirements.rst

+1-9
Original file line numberDiff line numberDiff line change
@@ -21,17 +21,11 @@ Below is the list of required and optional requirements.
2121
Required
2222
--------
2323

24-
* PHP needs to be a minimum version of PHP 5.3.3
24+
* PHP needs to be a minimum version of PHP 5.5.9
2525
* JSON needs to be enabled
2626
* ctype needs to be enabled
2727
* Your ``php.ini`` needs to have the ``date.timezone`` setting
2828

29-
.. caution::
30-
31-
Be aware that Symfony has some known limitations when using a PHP version
32-
less than 5.3.8 or equal to 5.3.16. For more information see the
33-
`Requirements section of the README`_.
34-
3529
Optional
3630
--------
3731

@@ -56,5 +50,3 @@ Doctrine
5650
If you want to use Doctrine, you will need to have PDO installed. Additionally,
5751
you need to have the PDO driver installed for the database server you want
5852
to use.
59-
60-
.. _`Requirements section of the README`: https://github.com/symfony/symfony#requirements

0 commit comments

Comments
 (0)