Skip to content

[Cookbook][Configuration] tweaks for the web server configuration chapter #4142

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 22, 2014
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 25 additions & 5 deletions cookbook/configuration/web_server_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,28 @@
Configuring a Web Server
========================

The web directory is the home of all of your application's public and static
files. Including images, stylesheets and JavaScript files. It is also where the
front controllers live. For more details, see the :ref:`the-web-directory`.
The preferred way to develop your Symfony2 application is to use
:doc:`PHP's internal web server </cookbook/web_server/built_in>`. However,
when using an older PHP version or when running the application in the production
environment, you'll need to use a fully-featured web server. This article
describes several ways to use Symfony with Apache2 or Nginx.

The web directory services as the document root when configuring your web
server. In the examples below, this directory is in ``/var/www/project/web/``.
When using Apache2, you can configure PHP as an
:ref:`Apache module <web-server-apache-mod-php>` or with FastCGI using
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... using Apache2, you can configured PHP as an Apache module...

:ref:`PHP FPM <web-server-apache-fpm>`. FastCGI also is the preferred way
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... FastCGI is also the...

to use PHP :ref:`with Nginx <web-server-nginx>`.

.. sidebar:: The Web Directory

The web directory is the home of all of your application's public and
static files, including images, stylesheets and JavaScript files. It is
also where the front controllers live. For more details, see the :ref:`the-web-directory`.

The web directory services as the document root when configuring your
web server. In the examples below, the ``web/`` directory will be the
document root. This directory is ``/var/www/project/web/``.

.. _web-server-apache-mod-php:

Apache2 with mod_php/PHP-CGI
----------------------------
Expand Down Expand Up @@ -63,6 +79,8 @@ following configuration snippet:
Require all granted
</Directory>

.. _web-server-apache-fpm:

Apache2 with PHP-FPM
--------------------

Expand Down Expand Up @@ -164,6 +182,8 @@ instead:

FastCgiExternalServer /usr/lib/cgi-bin/php5-fcgi -socket /var/run/php5-fpm.sock -pass-header Authorization

.. _web-server-nginx:

Nginx
-----

Expand Down