Improvement of Timezone Handling and Caddy Log Formatting

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

@@ -27,6 +27,7 @@ Setting environment variables all depends on what method you're using to run you
 `APACHE_START_SERVERS`<br />*Default: "2"*|Sets the number of child server processes created on startup.(<a target="_blank" href="https://httpd.apache.org/docs/2.4/mod/mpm_common.html#startservers">Official docs</a>)|fpm-apache
 `APACHE_THREAD_LIMIT`<br />*Default: "64"*|Set the maximum configured value for ThreadsPerChild for the lifetime of the Apache httpd process. (<a target="_blank" href="https://httpd.apache.org/docs/2.4/mod/mpm_common.html#threadlimit">Official docs</a>)|fpm-apache
 `APACHE_THREADS_PER_CHILD`<br />*Default: "25"*|This directive sets the number of threads created by each child process. (<a target="_blank" href="https://httpd.apache.org/docs/2.4/mod/mpm_common.html#threadsperchild">Official docs</a>)|fpm-apache
+`TZ`<br />*Default: "UTC"*|Operate your container in your local Time Zone.|all
 `APP_BASE_DIR`<br />*Default: "/var/www/html"*|Change this only if you mount your application to a different directory within the container. ℹ️ Be sure to change `NGINX_WEBROOT`, `APACHE_DOCUMENT_ROOT`, or `CADDY_SERVER_ROOT` if it applies to your use case as well.|all
 `AUTORUN_DEBUG`<br />*Default: "false"*|Enable debug mode for the Laravel automations. | all
 `AUTORUN_ENABLED`<br />*Default: "false"*|Enable or disable all automations. It's advised to set this to `false` in certain CI environments (especially during a composer install). If this is set to `false`, all `AUTORUN_*` behaviors will also be disabled.| all
@@ -52,6 +53,7 @@ Setting environment variables all depends on what method you're using to run you
 `CADDY_HTTPS_PORT`<br />*Default: "8443"*|Set the port for HTTPS. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/options#https-port">Official docs</a>)|frankenphp
 `CADDY_HTTPS_SERVER_ADDRESS`<br />*Default: "https://"*|Set the server address for HTTPS. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/concepts#addresses">Official docs</a>)|frankenphp
 `CADDY_LOG_FORMAT`<br />*Default: "console"*|Set the format for the Caddy log. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/directives/log#format-modules">Official docs</a>)|frankenphp
+`CADDY_LOG_DATETIME_FORMAT`<br />*Default: "wall_milli"*|Set the format of the timestamp in the Caddy logs. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/directives/log#format-modules">Official docs</a>)|frankenphp
 `CADDY_LOG_OUTPUT`<br />*Default: "stdout"*|Set the output for the Caddy log. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/directives/log#output-modules">Official docs</a>)|frankenphp
 `CADDY_PHP_SERVER_OPTIONS`<br />*Default: ""*|Set PHP server options for the Caddy server. (<a target="_blank" href="https://frankenphp.dev/docs/config/#caddyfile-config">Official docs</a>)|frankenphp
 `CADDY_SERVER_EXTRA_DIRECTIVES`<br />*Default: ""*|Set extra directives for the Caddy server. (<a target="_blank" href="https://caddyserver.com/docs/caddyfile/directives">Official docs</a>)|frankenphp

src/variations/cli/Dockerfile

@@ -22,7 +22,8 @@ LABEL org.opencontainers.image.title="serversideup/php (cli)" \
     org.opencontainers.image.version="${REPOSITORY_BUILD_VERSION}" \
     org.opencontainers.image.licenses="GPL-3.0-or-later"
 
-ENV APP_BASE_DIR=/var/www/html \
+ENV TZ=UTC \
+    APP_BASE_DIR=/var/www/html \
     COMPOSER_ALLOW_SUPERUSER=1 \
     COMPOSER_HOME=/composer \
     COMPOSER_MAX_PARALLEL_HTTP=24 \

src/variations/fpm-apache/Dockerfile

@@ -37,7 +37,8 @@ LABEL org.opencontainers.image.title="serversideup/php (fpm-apache)" \
     org.opencontainers.image.version="${REPOSITORY_BUILD_VERSION}" \
     org.opencontainers.image.licenses="GPL-3.0-or-later"
 
-ENV APACHE_DOCUMENT_ROOT=/var/www/html/public \
+ENV TZ=UTC \
+    APACHE_DOCUMENT_ROOT=/var/www/html/public \
     APACHE_HTTP_PORT="8080" \
     APACHE_HTTPS_PORT="8443" \
     APACHE_START_SERVERS="2" \

src/variations/fpm-nginx/Dockerfile

@@ -113,7 +113,8 @@ LABEL org.opencontainers.image.title="serversideup/php (fpm-nginx)" \
     org.opencontainers.image.version="${REPOSITORY_BUILD_VERSION}" \
     org.opencontainers.image.licenses="GPL-3.0-or-later"
 
-ENV APP_BASE_DIR=/var/www/html \
+ENV TZ=UTC \
+    APP_BASE_DIR=/var/www/html \
     COMPOSER_ALLOW_SUPERUSER=1 \
     COMPOSER_HOME=/composer \
     COMPOSER_MAX_PARALLEL_HTTP=24 \

src/variations/fpm/Dockerfile

@@ -22,7 +22,8 @@ LABEL org.opencontainers.image.title="serversideup/php (fpm)" \
     org.opencontainers.image.version="${REPOSITORY_BUILD_VERSION}" \
     org.opencontainers.image.licenses="GPL-3.0-or-later"
 
-ENV APP_BASE_DIR=/var/www/html \
+ENV TZ=UTC \
+    APP_BASE_DIR=/var/www/html \
     COMPOSER_ALLOW_SUPERUSER=1 \
     COMPOSER_HOME=/composer \
     COMPOSER_MAX_PARALLEL_HTTP=24 \

src/variations/frankenphp/Dockerfile

@@ -125,7 +125,8 @@ LABEL org.opencontainers.image.title="serversideup/php (frankenphp)" \
     org.opencontainers.image.version="${REPOSITORY_BUILD_VERSION}" \
     org.opencontainers.image.licenses="GPL-3.0-or-later"
 
-    ENV APP_BASE_DIR=/var/www/html \
+    ENV TZ=UTC \
+    APP_BASE_DIR=/var/www/html \
     CADDY_ADMIN="off" \
     CADDY_AUTO_HTTPS="off" \
     CADDY_GLOBAL_OPTIONS="" \
@@ -134,6 +135,7 @@ LABEL org.opencontainers.image.title="serversideup/php (frankenphp)" \
     CADDY_HTTP_SERVER_ADDRESS="http://" \
     CADDY_HTTPS_SERVER_ADDRESS="https://" \
     CADDY_LOG_FORMAT="console" \
+    CADDY_LOG_DATETIME_FORMAT="wall_milli" \
     CADDY_LOG_OUTPUT="stdout" \
     CADDY_PHP_SERVER_OPTIONS="" \
     CADDY_SERVER_EXTRA_DIRECTIVES="" \

src/variations/frankenphp/etc/frankenphp/log-level/address/alert.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+		time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/crit.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/debug.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:INFO}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/emerg.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/error.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/info.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:INFO}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/notice.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:INFO}
 }

src/variations/frankenphp/etc/frankenphp/log-level/address/warn.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:WARN}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/alert.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/crit.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/debug.caddyfile

@@ -1,6 +1,9 @@
 debug
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:DEBUG}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/emerg.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/error.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:ERROR}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/info.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:INFO}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/notice.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:INFO}
 }

src/variations/frankenphp/etc/frankenphp/log-level/global/warn.caddyfile

@@ -1,5 +1,8 @@
 log {
-	format {$CADDY_LOG_FORMAT:console}
+	format {$CADDY_LOG_FORMAT:console} {
+	    time_format {$CADDY_LOG_DATETIME_FORMAT:wall_milli}
+	    time_local
+    }
 	output {$CADDY_LOG_OUTPUT:stdout}
 	level {$CADDY_SERVER_LOG_LEVEL:WARN}
 }