mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
0e0597f8cd
Conflicts: control/Director.php dev/Backtrace.php docs/en/installation/nginx.md model/HTMLValue.php tests/model/SQLQueryTest.php
97 lines
2.5 KiB
Markdown
97 lines
2.5 KiB
Markdown
# Nginx
|
|
|
|
These instructions are also covered on the
|
|
[Nginx Wiki](http://wiki.nginx.org/SilverStripe).
|
|
|
|
The prerequisite is that you have already installed Nginx and you are
|
|
able to run PHP files via the FastCGI-wrapper from Nginx.
|
|
|
|
Now you need to set up a virtual host in Nginx with configuration settings
|
|
that are similar to those shown below.
|
|
<div class="notice" markdown='1'>
|
|
If you don't fully understand the configuration presented here, consult the
|
|
[nginx documentation](http://nginx.org/en/docs/).
|
|
|
|
Especially be aware of [accidental php-execution](https://nealpoole.com/blog/2011/04/setting-up-php-fastcgi-and-nginx-dont-trust-the-tutorials-check-your-configuration/ "Don't trust the tutorials") when extending the configuration.
|
|
</div>
|
|
But enough of the disclaimer, on to the actual configuration — typically in `nginx.conf`:
|
|
|
|
server {
|
|
listen 80;
|
|
root /path/to/ss/folder;
|
|
|
|
server_name site.com www.site.com;
|
|
|
|
location / {
|
|
try_files $uri /framework/main.php?url=$uri&$query_string;
|
|
}
|
|
|
|
error_page 404 /assets/error-404.html;
|
|
error_page 500 /assets/error-500.html;
|
|
|
|
location ^~ /assets/ {
|
|
sendfile on;
|
|
try_files $uri =404;
|
|
}
|
|
|
|
location ~ /framework/.*(main|rpc|tiny_mce_gzip)\.php$ {
|
|
fastcgi_keep_conn on;
|
|
fastcgi_pass 127.0.0.1:9000;
|
|
fastcgi_index index.php;
|
|
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
|
include fastcgi_params;
|
|
}
|
|
|
|
location ~ /(mysite|framework|cms)/.*\.(php|php3|php4|php5|phtml|inc)$ {
|
|
deny all;
|
|
}
|
|
|
|
location ~ /\.. {
|
|
deny all;
|
|
}
|
|
|
|
location ~ \.ss$ {
|
|
satisfy any;
|
|
allow 127.0.0.1;
|
|
deny all;
|
|
}
|
|
|
|
location ~ web\.config$ {
|
|
deny all;
|
|
}
|
|
|
|
location ~ \.ya?ml$ {
|
|
deny all;
|
|
}
|
|
|
|
location ^~ /vendor/ {
|
|
deny all;
|
|
}
|
|
|
|
location ~* /silverstripe-cache/ {
|
|
deny all;
|
|
}
|
|
|
|
location ~* composer\.(json|lock)$ {
|
|
deny all;
|
|
}
|
|
|
|
location ~* /(cms|framework)/silverstripe_version$ {
|
|
deny all;
|
|
}
|
|
|
|
location ~ \.php$ {
|
|
fastcgi_keep_conn on;
|
|
fastcgi_pass 127.0.0.1:9000;
|
|
fastcgi_index index.php;
|
|
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
|
include fastcgi_params;
|
|
}
|
|
}
|
|
|
|
The above configuration sets up a virtual host `site.com` with
|
|
rewrite rules suited for SilverStripe. The location block for php files
|
|
passes all php scripts to the FastCGI-wrapper via a TCP socket.
|
|
|
|
Now you can proceed with the SilverStripe installation normally.
|