@@ -10,17 +10,27 @@ Installing & Setting up the Symfony Framework
10
10
Do you prefer video tutorials? Check out the `Stellar Development with Symfony `_
11
11
screencast series.
12
12
13
+ .. _symfony-tech-requirements :
14
+
13
15
Technical Requirements
14
16
----------------------
15
17
16
18
Before creating your first Symfony application you must:
17
19
18
- * Make sure to have PHP 7.1 or higher installed (and :doc: `these PHP extensions </reference/requirements >`
19
- which are installed and enabled by default by PHP);
20
+ * Install PHP 7.1 or higher and these PHP extensions (which are installed and
21
+ enabled by default in most PHP 7 installations): `Ctype `_, `iconv `_, `JSON `_,
22
+ `PCRE `_, `Session `_, `SimpleXML `_, and `Tokenizer `_;
20
23
* `Install Composer `_, which is used to install PHP packages;
21
24
* `Install Symfony `_, which creates in your computer a binary called ``symfony ``
22
25
that provides all the tools you need to develop your application locally.
23
26
27
+ The ``symfony `` binary provides a tool to check if your computer meets these
28
+ requirements. Open your console terminal and run this command:
29
+
30
+ .. code-block :: terminal
31
+
32
+ $ symfony check:requirements
33
+
24
34
.. _creating-symfony-applications :
25
35
26
36
Creating Symfony Applications
@@ -57,6 +67,12 @@ will create a new ``my_project_name/`` directory, download some dependencies
57
67
into it and even generate the basic directories and files you'll need to get
58
68
started. In other words, your new application is ready!
59
69
70
+ .. note ::
71
+
72
+ The project's cache and logs directory (by default, ``<project>/var/cache/ ``
73
+ and ``<project>/var/log/ ``) must be writable by the web server. If you have
74
+ any issue, read how to :doc: `set up permissions for Symfony applications </setup/file_permissions >`.
75
+
60
76
Running Symfony Applications
61
77
----------------------------
62
78
@@ -81,12 +97,6 @@ Open your browser and navigate to ``http://localhost:8000/``. If everything is
81
97
working, you'll see a welcome page. Later, when you are finished working, stop
82
98
the server by pressing ``Ctrl+C `` from your terminal.
83
99
84
- .. tip ::
85
-
86
- If you're having any problems running Symfony, your system may be missing
87
- some technical requirements. Use the :doc: `Symfony Requirements Checker </reference/requirements >`
88
- tool to make sure your system is set up.
89
-
90
100
.. _install-existing-app :
91
101
92
102
Setting up an Existing Symfony Project
@@ -258,3 +268,10 @@ Learn More
258
268
.. _`Main recipe repository` : https://github.com/symfony/recipes
259
269
.. _`Contrib recipe repository` : https://github.com/symfony/recipes-contrib
260
270
.. _`Symfony Recipes documentation` : https://github.com/symfony/recipes/blob/master/README.rst
271
+ .. _`iconv` : https://php.net/book.iconv
272
+ .. _`JSON` : https://php.net/book.json
273
+ .. _`Session` : https://php.net/book.session
274
+ .. _`Ctype` : https://php.net/book.ctype
275
+ .. _`Tokenizer` : https://php.net/book.tokenizer
276
+ .. _`SimpleXML` : https://php.net/book.simplexml
277
+ .. _`PCRE` : https://php.net/book.pcre
0 commit comments