Allow setting php.ini and php-fpm pool setting via individial env vars

Author: baschny

README.md

@@ -166,6 +166,24 @@ Application root is `/app`. Application runs as user `application` (uid=1000).
 | `PHP_FPM_OVERRIDE`                         | fpm      |             | Allow overriding php-fpm pool settings. The multiline content for php-fpm.conf here. Use "\n" for multiline i.e. in ECS                  |
 | `PHP_EXTENSIONS`                           | fpm, ssh | (all)       | Comma separated list of PHP extensions to enable (if this is not set, all are enabled).                                                  |
 | `PHP_DISABLE_EXTENSIONS`                   | fpm, ssh |             | Comma separated list of PHP extensions to disable (in case you keep all enabled, you can disable individual ones, i.e. igbinary).        |
+| `PHPINI__xxx__yyy`                         | fpm, ssh |             | Set php.ini setting `xxx.yyy` (always lower cased)                                                                                       |
+| `PHPFPM__xxx__yyy`                         | fpm      |             | Set php-fpm pool setting `xxx.yyy` (always lower cased)                                                                                  |
+
+The `PHPINI__...` and `PHPFPM__...` allow to set individual settings for `php.ini`
+and `php-fpm.conf` (pool settings) using individual environment variables. Just
+replace the `.` in the settings by `__`. Examples:
+
+Upper case allowed (will be lower-cased):
+```
+PHPINI__SESSION__SAVE_HANDLER=redis
+PHPINI__REDIS__SESSION__LOCKING_ENABLED=1
+```
+
+Or:
+```
+PHPFPM__request_terminate_timeout=30s
+PHPFPM__pm__max_children=15
+```
 
 ## Example usage
 

example-app/.env.example

@@ -42,3 +42,15 @@ slowlog = /tmp/slow.log
 request_slowlog_timeout = 3s
 pm.max_children = 5
 "
+
+# -----------------------------------------
+# PHP settings by env vars
+# -----------------------------------------
+
+# Example of setting php.ini settings
+PHPINI__SESSION__SAVE_HANDLER=redis
+PHPINI__REDIS__SESSION__LOCKING_ENABLED=1
+
+# Example of setting PHP-FPM settings
+PHPFPM__REQUEST_terminate_timeout=30s
+PHPFPM__pm__max_children=15

files/entrypoint-extras.sh

@@ -7,6 +7,8 @@
 
 # Controls which extensions are enabled.
 
+CUSTOM_INI="/usr/local/etc/php/conf.d/zz-02-custom.ini"
+
 if [ ! -z "${PHP_EXTENSIONS}" ]; then
   # If PHP_EXTENSIONS is set: only enable the ones specified
 
@@ -85,10 +87,39 @@ if [ ! -z "${APPLICATION_UID}" ] || [ ! -z "${APPLICATION_GID}" ]; then
 fi
 
 if [ ! -z "${PHP_INI_OVERRIDE}" ]; then
-  echo "${PHP_INI_OVERRIDE}" | sed -e 's/\\n/\n/g' > /usr/local/etc/php/conf.d/zz-02-custom.ini
+  echo "${PHP_INI_OVERRIDE}" | sed -e 's/\\n/\n/g' > "$CUSTOM_INI"
 fi
 unset PHP_INI_OVERRIDE
 
+# Fill from ENV variables prefixed with PHPINI__
+# Example: PHPINI__session__save_handler=redis -> session.save_handler = redis
+#          PHPINI__redis__session__locking_enabled=1 -> redis.session.locking_enabled = 1
+if env | grep -q '^PHPINI__'; then
+  # Ensure the custom ini exists (and keep any content already written above)
+  touch "$CUSTOM_INI"
+  # Iterate over all matching env var names only
+  for name in $(printenv | awk -F= '/^PHPINI__/ {print $1}'); do
+    value=$(printenv "$name")
+    # Transform key: PHPINI__this__setting => this.setting
+    key=${name#PHPINI__}
+    key=$(printf '%s' "$key" | sed 's/__/./g')
+    key=${key,,}
+    # Append as "key = value" (value is written as-is; quote in ENV if needed)
+    printf '* setting in php.ini: %s = %s\n' "$key" "$value"
+    printf '%s = %s\n' "$key" "$value" >> "$CUSTOM_INI"
+    # Unset them, not relevant to the running containers
+    unset "$name"
+  done
+fi
+
+if [ -s "$CUSTOM_INI" ]
+then
+  echo "* Custom php.ini settings ($CUSTOM_INI)"
+  echo "- - - 8< - - -"
+  cat $CUSTOM_INI
+  echo "- - - 8< - - -"
+fi
+
 # Remove ENV variables that are meant only for the SSH container
 
 unset SSH_PRIVATE_KEY

files/entrypoint.sh

@@ -32,5 +32,29 @@ if [ ! -z "${PHP_FPM_OVERRIDE}" ]; then
 fi
 unset PHP_FPM_OVERRIDE
 
+# Fill from ENV variables prefixed with PHPFPM__
+# Examples:
+#   PHPFPM__pm__max_children=15 => pm.max_children = 15
+#   PHPFPM__request_terminate_timeout=30s => request_terminate_timeout = 30s
+#   PHPFPM__slowlog=/data/php-logs/slow.log => slowlog = /data/php-logs/slow.log
+#
+if env | grep -q '^PHPFPM__'; then
+  # Ensure the custom ini exists (and keep any content already written above)
+  touch "$CUSTOM_INI"
+  # Iterate over all matching env var names only
+  for name in $(printenv | awk -F= '/^PHPFPM__/ {print $1}'); do
+    value=$(printenv "$name")
+    # Transform key: PHPINI__this__setting => this.setting
+    key=${name#PHPFPM__}
+    key=$(printf '%s' "$key" | sed 's/__/./g')
+    key=${key,,}
+    # Append as "key = value" (value is written as-is; quote in ENV if needed)
+    printf '* PHP-FPM pool setting: %s = %s\n' "$key" "$value"
+    printf '%s = %s\n' "$key" "$value" >> "$PHP_FPM_POOL_CONF"
+    # Unset them, not relevant to the running containers
+    unset "$name"
+  done
+fi
+
 # Start the "real" entrypoint
 . /usr/local/bin/docker-php-entrypoint