Add a comment about where PHP error_log() output goes. #2680

examples/development/php/latest/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/flakes/php/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/plugins/builtin/devbox.d/php82/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/stacks/drupal/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/stacks/lapp-stack/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/stacks/laravel/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 
 [www]
@@ -14,3 +15,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

examples/stacks/lepp-stack/devbox.d/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+

plugins/php/php-fpm.conf

@@ -1,5 +1,6 @@
 [global]
 pid = ${PHPFPM_PID_FILE}
+; Note: this is PHP-FPM's error log, not PHP's (see below)
 error_log = ${PHPFPM_ERROR_LOG_FILE}
 daemonize = yes
 
@@ -15,3 +16,9 @@ pm.start_servers = 2
 pm.min_spare_servers = 1
 pm.max_spare_servers = 3
 chdir = /
+
+; Note: PHP's error_log() output is typically found in your webserver error log, not in PHP-FPM's. By default error_log() writes to stderr (unless 'error_log' is set in php.log), and then on to the FastCGI client (the webserver), which logs it. If you want error_log() logged at the PHP-FPM layer, set a file here:
+;
+; php_admin_value[error_log] = ...
+; php_admin_flag[log_errors] = on
+