Skip to content

Commit 933bb96

Browse files
bjo3rnfweaverryan
authored andcommitted
Improving document root handling
1 parent 74cde37 commit 933bb96

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

book/installation.rst

+17-1
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ something like this:
5757

5858
.. code-block:: text
5959
60-
www/ <- your web root directory
60+
www/ <- your web server directory (sometimes named htdocs or public)
6161
Symfony/ <- the unpacked archive
6262
app/
6363
cache/
@@ -77,6 +77,22 @@ something like this:
7777
:doc:`/cookbook/configuration/override_dir_structure` for more
7878
information.
7979

80+
All public files and the front controller that handles incoming requests in
81+
a Symfony2 application live in the ``Symfony/web/`` directory. So, assuming
82+
you unpacked the archive into your web server's or virtual host's document root,
83+
your application's URLs will start with ``http://localhost/Symfony/web/``.
84+
To get nice and short URLs you should point the document root of your web
85+
server or virtual host to the ``Symfony/web/`` directory. Though this is not
86+
required for development it is recommended when your application goes into
87+
production as all system and configuration files become inaccessible to clients.
88+
For information on configuring your specific web server document root, see
89+
the following documentation: `Apache`_ | `Nginx`_ .
90+
91+
.. note::
92+
93+
The following examples assume you don't touch the document root settings
94+
so all URLs start with ``http://localhost/Symfony/web/``
95+
8096
Updating Vendors
8197
~~~~~~~~~~~~~~~~
8298

0 commit comments

Comments
 (0)