nginx stable with PHP FPM

An image with nginx stable installed from nginx' repository and PHP installed from Ondřej Surý's PPA for up to date packages.

phpinfo();

Why use this image?

• Latest PHP and nginx packages
• nginx and php-fpm is running as user app, fixing a lot of permission headaches
• UID and GID for user app can be changed (See below)

Usage

Tags

This image is available in five flavors: 5.6, 7.0, 7.1, 7.2, 7.3 and 7.4 corresponding to the PHP version. Version 5.6 and 7.0 are not supported by PHP thus will not receive security updates - but I will keep them around in case someone needs them (Ubuntu will still be updated).

Environment

General

• VIRTUAL_HOST: Sets the ServerName for the default vhost. Only needed if you do not provide your own vhost "site" config
• SERVER_ADMIN: Email address for the ServerAdmin variable
• GENERATE_DEFAULT_VHOST_CONFIG: By default a basic vhost configuration using the to variables above is generated. Use this switch to disable (true/false)
• CHOWN_WWWDIR: Change owner of /var/www to $PUID:$PGID. Default is true, disable if your document root is elsewhere or there is a large number of files in the directory
• NGINX_CLIENT_MAX_BODY_SIZE: Max allowed file size for upload. Default is 50M.
• PUID: Changes the uid of the app user, default 911
• PGID: Changes the gid of the app group, default 911
• SMTP_HOST: Change the SMTP relay server used by ssmtp (sendmail)
• SMTP_USER: Username for the SMTP relay server
• SMTP_PASS: Password for the SMTP relay server
• SMTP_PORT: Outgoing SMTP port, default 587
• SMTP_SECURE: Does the SMTP server requires a secure connection, default TRUE
• SMTP_TLS: Use STARTTLS, default TRUE (if SMTP_TLS is FALSE and SMTP_SECURE is true, SMTP over SSL will be used)
• SMTP_MASQ: Masquerade outbound emails using this domain, default empty

PHP/FPM configuration

• PHP_SESSION_SAVE_HANDLER: Sets session.save_handler. Default is files
• PHP_SESSION_SAVE_PATH: Sets the path for saving sessions. Default is /var/lib/php/sessions. Use the full URI for Redis or Memcached: tcp://10.133.14.9:6379?auth=yourverycomplexpasswordhere
• PHP_SESSION_GC_DIVISOR: Sets session.gc_divisor. Default is 100
• PHP_SESSION_GC_PROPABILITY: Sets session.gc_probability. Default is 0 if session handler is files otherwise 1.
• PHP_UPLOAD_MAX_FILESIZE: Sets upload_max_filesize. The default is 50M, same nginx
• PHP_POST_MAX_SIZE: Sets post_max_size. The default is 8MB.
• FPM_MAX_CHILDREN: Default is 5
• FPM_START_SERVER: Default is 2
• FPM_MIN_SPARE_SERVERS: Default is 1
• FPM_MAX_SPARE_SERVERS: Default is 2
• FPM_ERROR_LOG: Sets the error log of php-fpm. Default is /dev/fd/2 (stdout)

nginx configuration

• WORKER_PROCESSES: Number of processes to run. Default is auto which will set the number according to number of available CPU cores

Volumes

/var/www is defined as a volume; provide your own vhost configuration by adding -v ./conf.d:/etc/nginx/conf.d:ro.