Add PHP-FPM user/group configuration script and update documentation for environment variables. Introduced 5-fpm-pool-user.sh to set user and group for PHP-FPM processes when running as root. Updated documentation to include PHP_FPM_CHILD_PROCESS_USER and PHP_FPM_CHILD_PROCESS_GROUP variables.

Author: jaydrogers

docs/content/docs/1.getting-started/5.default-configurations.md

@@ -116,6 +116,8 @@ We also provide a few default scripts to help you get started.
 |------------|-----------------|----------------------|
 | `0-container-info.sh` | Shows basic execution information, such as Docker User, UID, GID, etc. | all |
 | `1-log-output-level.sh` | Sets PHP log output level to match `LOG_OUTPUT_LEVEL` | all |
+| `5-generate-ssl.sh` | Generates a self-signed SSL certificate and key for the container. | fpm-nginx, fpm-apache, frankenphp |
+| `5-fpm-pool-user.sh` | Sets the user and group of the PHP-FPM child processes to the values of `PHP_FPM_CHILD_PROCESS_USER` and `PHP_FPM_CHILD_PROCESS_GROUP` if the container is running as root. | fpm |
 | `10-init-unit.sh` | Processes Unit templates, configures SSL (if enabled), and prepares NGINX Unit for launch | unit |
 | `10-init-webserver-config.sh` | Processes web server configuration templates, configures SSL (if enabled), and prepares web server for launch | *-nginx <br/> *-apache |
 | `50-laravel-automations.sh` | If `AUTORUN_ENABLED` is set to true, and a Laravel installation is detected, the following commands will automatically execute on container start: <br/> - `php artisan config:cache` <br/> - `php artisan route:cache` <br/> - `php artisan view:cache` <br/> - `php artisan event:cache` <br/> - `php artisan migrate --force` | all |

docs/content/docs/8.reference/1.environment-variable-specification.md

@@ -79,6 +79,8 @@ Setting environment variables all depends on what method you're using to run you
 `PHP_DISPLAY_STARTUP_ERRORS`<br />*Default: Off*|Even when display_errors is on, errors that occur during PHP's startup sequence are not displayed. (<a target="_blank" href="https://www.php.net/manual/en/errorfunc.configuration.php#ini.display-startup-errors">Official docs</a>)| all
 `PHP_ERROR_LOG`<br />*Default: "/dev/stderr"*|Name of the file where script errors should be logged. . (<a target="_blank" href="https://www.php.net/manual/en/errorfunc.configuration.php#ini.error-log">Official docs</a>)|all
 `PHP_ERROR_REPORTING`<br />*Default: "22527"*|Set PHP error reporting level. Must be a number. <a target="_blank" href="https://maximivanov.github.io/php-error-reporting-calculator/">Use this tool for help.</a> (<a target="_blank" href="https://www.php.net/manual/en/errorfunc.configuration.php#ini.error-reporting">Official docs</a>)|all
+`PHP_FPM_CHILD_PROCESS_USER`<br />*Default: "www-data"*| ⚠️ Only used if container is running as root. Set the user of the PHP-FPM child processes. (<a target="_blank" href="https://www.php.net/manual/en/install.fpm.configuration.php">Official docs</a>)|fpm*
+`PHP_FPM_CHILD_PROCESS_GROUP`<br />*Default: "www-data"*| ⚠️ Only used if container is running as root. Set the group of the PHP-FPM child processes. (<a target="_blank" href="https://www.php.net/manual/en/install.fpm.configuration.php">Official docs</a>)|fpm*
 `PHP_FPM_PM_CONTROL`<br />*Defaults:<br />fpm: dynamic<br />fpm-apache: ondemand<br />fpm-nginx: ondemand*|Choose how the process manager will control the number of child processes. (<a target="_blank" href="https://www.php.net/manual/en/install.fpm.configuration.php">Official docs</a>)|fpm*
 `PHP_FPM_PM_MAX_CHILDREN`<br />*Default: "20"*|The number of child processes to be created when pm is set to static and the maximum number of child processes to be created when pm is set to dynamic. (<a target="_blank" href="https://www.php.net/manual/en/install.fpm.configuration.php">Official docs</a>)|fpm*
 `PHP_FPM_PM_MAX_REQUESTS`<br />*Default: "0"*|The number of requests each child process should execute before respawning. This can be useful to work around memory leaks in 3rd party libraries. (<a target="_blank" href="https://www.php.net/manual/en/install.fpm.configuration.php">Official docs</a>)|fpm*

src/php-fpm.d/etc/entrypoint.d/5-fpm-pool-user.sh

@@ -0,0 +1,30 @@
+#!/bin/sh
+###################################################
+# Usage: 5-fpm-pool-user.sh
+###################################################
+# This script checks if the container is running as root and adds
+# the proper user/group configuration to the PHP-FPM pool.
+script_name="fpm-pool-user"
+
+: "${PHP_FPM_CHILD_PROCESS_USER:=www-data}"
+: "${PHP_FPM_CHILD_PROCESS_GROUP:=www-data}"
+
+# Check if running as root
+if [ "$(id -u)" -ne 0 ]; then
+    exit 0 # Exit if not running as root
+fi
+
+# Exit if default config is disabled
+if [ "$DISABLE_DEFAULT_CONFIG" = true ]; then
+    if [ "$LOG_OUTPUT_LEVEL" = "debug" ]; then
+        echo "👉 $script_name: DISABLE_DEFAULT_CONFIG is true, skipping FPM user/group configuration."
+    fi
+    exit 0
+fi
+
+# Add user and group configuration to PHP-FPM pool
+{
+    echo ""
+    echo "user = $PHP_FPM_CHILD_PROCESS_USER"
+    echo "group = $PHP_FPM_CHILD_PROCESS_GROUP"
+} >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf