edyan/nginx repository overview

⁠Nginx Docker Image for PHP FPM

Docker Hub: https://hub.docker.com/r/edyan/nginx⁠

Docker container containing Nginx that connects to an FPM service and redirects all requests to /index.php. If the FPM service is not available, nginx will still start but throws 500 errors when the actual file does not exist.

WARNING : If you have an index.php, everything will be redirected to it. If your index.php is not able to manage routes, you'll have a strange behavior.

Also it has a "rewrite rule" that sends everything to index.php.

⁠Usage

Add the following to your docker-compose.yml, assuming that your PHP VM is named php (see edyan/php⁠).

nginx:
    image: edyan/nginx:1.10-debian
    volumes:
        - ./www:/var/www/html
    ports:
        - 80:80

If you have no php container, nginx will start without any upstream configuration (1.6 will throw a 500, others work).

⁠Versions

• 1.17-alpine : A light version.
• 1.14-debian : A production lookalike version with Debian 10 (also latest).
• 1.10-debian : A production lookalike version with Debian 9
• 1.6-debian : A production lookalike version with Debian 8 (throws an error if there are no upstream).

⁠Environment variables

Two variables have been created, to override the user and group that owns Nginx (and all its files). That's useful if you need to mount a volume and own the files. These environment variables are NGINX_UID and NGINX_GID.

Another two environment variables lets anybody override the php container name : PHP_HOST (default "php") and PHP_PORT (default "9000").

Finally:

• To set your own document root, you can use NGINX_DOCUMENT_ROOT (default : /var/www)
• To fine tune the fastcgi timeout you can change FASTCGI_READ_TIMEOUT (default 20s) and FASTCGI_SEND_TIMEOUT (default 20s).

⁠Tests

Tests are made with goss⁠. After downloading it, run :

scripts/test.sh 1.6-debian
scripts/test.sh 1.10-debian
scripts/test.sh 1.14-debian
scripts/test.sh 1.17-alpine