From 83c9cec61b8a2483177ccd7459ccca7f8d625e36 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Thu, 20 Jul 2017 08:50:16 +0200 Subject: [PATCH] Updated the Requirements article for Symfony 2.8 --- reference/requirements.rst | 64 +++++++++++--------------------------- 1 file changed, 18 insertions(+), 46 deletions(-) diff --git a/reference/requirements.rst b/reference/requirements.rst index 7946dd1e37d..0988809ee83 100644 --- a/reference/requirements.rst +++ b/reference/requirements.rst @@ -6,57 +6,29 @@ Requirements for Running Symfony ================================ -To run Symfony, your system needs to adhere to a list of requirements. You -can easily see if your system passes all requirements by running the -``web/config.php`` in your Symfony distribution. Since the CLI often uses -a different ``php.ini`` configuration file, it's also a good idea to check -your requirements from the command line via: +Symfony 2.8 requires **PHP 5.3.9** or higher to run, in addition to other minor +requirements. To make things simple, Symfony provides a tool to quickly check if +your system meets all those requirements. -.. code-block:: terminal - - $ php app/check.php - -Below is the list of required and optional requirements. - -Required --------- +Beware that PHP can define a different configuration for the command console and +the web server, so you need to check requirements in both environments. -* PHP needs to be a minimum version of PHP 5.3.9 -* `JSON extension`_ needs to be enabled -* `ctype extension`_ needs to be enabled -* Your ``php.ini`` needs to have the ``date.timezone`` setting +Checking Requirements for the Web Server +---------------------------------------- -.. caution:: +Symfony includes a ``config.php`` file in the ``web/`` directory of your project. +Open that file with your browser to check the requirements. - Be aware that PHP 5.3.16 is not suitable to run Symfony, - because of a `major bug in the Reflection subsystem`_. +Once you've fixed all the reported issues, delete the ``web/config.php`` file +to avoid leaking internal information about your application to visitors. -Optional --------- +Checking Requirements for the Command Console +--------------------------------------------- -* You need to have the PHP-XML module installed -* You need to have at least version 2.6.21 of libxml -* PHP tokenizer needs to be enabled -* mbstring functions need to be enabled -* iconv needs to be enabled -* POSIX needs to be enabled (only on \*nix) -* Intl needs to be installed with ICU 4+ -* APC 3.0.17+ (or another opcode cache needs to be installed) -* ``php.ini`` recommended settings +Open your console or terminal, enter in your project directory, execute this +command and fix the reported issues: - * ``short_open_tag = Off`` - * ``magic_quotes_gpc = Off`` - * ``register_globals = Off`` - * ``session.auto_start = Off`` - -Doctrine --------- - -If you want to use Doctrine, you will need to have PDO installed. Additionally, -you need to have the PDO driver installed for the database server you want -to use. +.. code-block:: terminal -.. _`Requirements section of the README`: https://github.com/symfony/symfony/blob/2.8/README.md#requirements -.. _`JSON extension`: https://php.net/manual/book.json.php -.. _`ctype extension`: https://php.net/manual/book.ctype.php -.. _`major bug in the Reflection subsystem`: https://bugs.php.net/bug.php?id=62715 + $ cd my-project/ + $ php app/check.php