Provide a default nginx-app.conf

php-nginx/Dockerfile

@@ -82,6 +82,7 @@ RUN mkdir -p $APP_DIR $LOG_DIR $UPLOAD_DIR $SESSION_SAVE_PATH \
 
 # Put config files into place.
 COPY nginx.conf fastcgi_params gzip_params $NGINX_DIR/conf/
+COPY nginx-app.conf $NGINX_USER_CONF_DIR
 COPY php.ini $PHP56_DIR/lib/php.ini
 COPY php.ini $PHP7_DIR/lib/php.ini
 COPY php-fpm.conf $PHP56_DIR/etc/php-fpm.conf

php-nginx/README.md

@@ -112,28 +112,26 @@ runtime_config:
 
 ## How to change nginx.config
 
-Put `nginx-app.conf` file which includes piece of nginx configuration
-for the `server` section in the project top directory. Then it will be
-moved to an appropriate directory and included from the main nginx
-configuration file.
+We put `nginx-app.conf` file which is included in the `server` section
+of the main configuration file. Here is the default configuration file
+which will likely just work with most of the modern web frameworks in
+simple cases.
 
-Assumption is that you don't often need to entirely modify the
-[default nginx file](nginx.conf).
-There is an `include` directive in the `server` section and your
-configuration file will be included there.
-
-Here is an example configuration for silex.
-
-nginx-app.conf:
+The default nginx-app.conf:
 
 ```ini
 location / {
-  # try to serve file directly, fallback to front controller
+  # try to serve files directly, fallback to the front controller
   try_files $uri /index.php$is_args$args;
 }
 ```
 
-I hope this mechanism can cover most of the web frameworks, but let us
+You might need to add some rewrite rules, or you might want to change
+the behavior. In those cases, put a file named `nginx-app.conf` in the
+project root directory. Then the runtime will override the default
+file with the file you provided.
+
+I hope this mechanism can cover most of your use cases, but let us
 know if you found otherwise.
 
 ## Change the PHP version

php-nginx/nginx-app.conf

@@ -0,0 +1,4 @@
+location / {
+  # try to serve files directly, fallback to the front controller
+  try_files $uri /index.php$is_args$args;
+}

tests/ServingTest.php

@@ -53,6 +53,16 @@ public function testIndex()
         $this->assertContains('Hello World', $resp->getBody()->getContents());
     }
 
+    public function testNonExistentPath()
+    {
+        // Non-existent paths should be served by the `index.php` too, thanks
+        // to the default nginx-app.conf.
+        $resp = $this->client->get('non-existent-path');
+        $this->assertEquals('200', $resp->getStatusCode(),
+                            'non-existent-path status code');
+        $this->assertContains('Hello World', $resp->getBody()->getContents());
+    }
+
     public function testPhpInfo()
     {
         // Access to phpinfo.php, while phpinfo() is disabled by default.