Override location / for use with php-fpm and allow serving static files

with nginx instead of passing them to fastcgi

Dockerfile

@@ -31,7 +31,7 @@ WORKDIR /app/
 
 ENV DOCKER_HOST unix:///tmp/docker.sock
 
-VOLUME ["/etc/nginx/certs", "/etc/nginx/dhparam"]
+VOLUME ["/etc/nginx/certs", "/etc/nginx/dhparam", "/etc/nginx/static_files"]
 
 ENTRYPOINT ["/app/docker-entrypoint.sh"]
 CMD ["forego", "start", "-r"]

README.md

@@ -137,6 +137,23 @@ than a socket and expose that port.
 
 If you use fastcgi, you can set `VIRTUAL_ROOT=xxx`  for your root directory
 
+### FastCGI Serving static files
+
+If you use fastcgi, you can set `LOCATION_PATH=xxx` (eg: "~ \.php$") and use the vhost.d/default or vhost.d/{VIRTUAL_HOST}
+to add:
+```
+location / {
+    try_files $uri /index.php?$query_string;
+    limit_rate_after 1000k;
+    limit_rate 50k;
+}
+```
+
+You can then bind your files in "/etc/nginx/static_files/{VIRTUAL_HOST}" and they'll be served by nginx instead of passing them
+to your fastcgi.
+
+**You should also set the VIRTUAL_ROOT if using static_files binding.**
+
 
 ### Default Host
 
@@ -179,6 +196,7 @@ $ docker run --volumes-from nginx \
 Finally, start your containers with `VIRTUAL_HOST` environment variables.
 
     $ docker run -e VIRTUAL_HOST=foo.bar.com  ...
+
 ### SSL Support using letsencrypt
 
 [letsencrypt-nginx-proxy-companion](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) is a lightweight companion container for the nginx-proxy. It allows the creation/renewal of Let's Encrypt certificates automatically.
@@ -187,6 +205,7 @@ Set `DHPARAM_GENERATION` environment variable to `false` to disabled Diffie-Hell
 The default value is `true`
 
      $ docker run -e DHPARAM_GENERATION=false ....
+
 ### SSL Support
 
 SSL is supported using single host, wildcard and SNI certificates using naming conventions for

nginx.tmpl

@@ -1,5 +1,6 @@
 {{ $CurrentContainer := where $ "ID" .Docker.CurrentContainerID | first }}
 
+{{ $location_path := coalesce $.Env.LOCATION_PATH "/" }}
 {{ $external_http_port := coalesce $.Env.HTTP_PORT "80" }}
 {{ $external_https_port := coalesce $.Env.HTTPS_PORT "443" }}
 
@@ -275,6 +276,10 @@ server {
 	{{ end }}
 	{{ $access_log }}
 
+    {{ if (exists (printf "/etc/nginx/static_files/%s" $host)) }}
+    root {{ printf "/etc/nginx/static_files/%s" $host }};
+    {{ end }}
+
 	{{ if eq $network_tag "internal" }}
 	# Only allow traffic from internal clients
 	include /etc/nginx/network_internal.conf;
@@ -309,7 +314,7 @@ server {
 	include /etc/nginx/vhost.d/default;
 	{{ end }}
 
-	location / {
+	location {{ $location_path }} {
 		{{ if eq $proto "uwsgi" }}
 		include uwsgi_params;
 		uwsgi_pass {{ trim $proto }}://{{ trim $upstream_name }};
@@ -347,6 +352,10 @@ server {
 	{{ end }}
 	{{ $access_log }}
 
+    {{ if (exists (printf "/etc/nginx/static_files/%s" $host)) }}
+    root {{ printf "/etc/nginx/static_files/%s" $host }};
+    {{ end }}
+
 	{{ if eq $network_tag "internal" }}
 	# Only allow traffic from internal clients
 	include /etc/nginx/network_internal.conf;
@@ -358,7 +367,7 @@ server {
 	include /etc/nginx/vhost.d/default;
 	{{ end }}
 
-	location / {
+	location {{ $location_path }} {
 		{{ if eq $proto "uwsgi" }}
 		include uwsgi_params;
 		uwsgi_pass {{ trim $proto }}://{{ trim $upstream_name }};