Configuring a web server
Edit this pageWarning: You are browsing the documentation for Symfony 2.0, which is no longer maintained.
Read the updated version of this page for Symfony 6.2 (the current stable version).
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 Creating Pages in Symfony2.
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/.
Apache2
For advanced Apache configuration options, see the official Apache documentation. The minimum basics to get your application running under Apache2 are:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
<VirtualHost *:80>
ServerName domain.tld
ServerAlias www.domain.tld
DocumentRoot /var/www/project/web
<Directory /var/www/project/web>
# enable the .htaccess rewrites
AllowOverride All
Order allow,deny
Allow from All
</Directory>
ErrorLog /var/log/apache2/project_error.log
CustomLog /var/log/apache2/project_access.log combined
</VirtualHost>Note
For performance reasons, you will probably want to set
AllowOverride None and implement the rewrite rules in the web/.htaccess
into the virtualhost config.
Nginx
For advanced Nginx configuration options, see the official Nginx documentation. The minimum basics to get your application running under Nginx are:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
server {
server_name domain.tld www.domain.tld;
root /var/www/project/web;
location / {
# try to serve file directly, fallback to rewrite
try_files $uri @rewriteapp;
}
location @rewriteapp {
# rewrite all to app.php
rewrite ^(.*)$ /app.php/$1 last;
}
location ~ ^/(app|app_dev|config)\.php(/|$) {
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTPS off;
}
error_log /var/log/nginx/project_error.log;
access_log /var/log/nginx/project_access.log;
}Note
Depending on your PHP-FPM config, the fastcgi_pass can also be
fastcgi_pass 127.0.0.1:9000.
Tip
This executes only app.php, app_dev.php and config.php in
the web directory. All other files will be served as text. You must
also make sure that if you do deploy app_dev.php or config.php
that these files are secured and not available to any outside user (the
IP checking code at the top of each file does this by default).
If you have other PHP files in your web directory that need to be executed,
be sure to include them in the location block above.
