Added feature to log the request uri when fatal errors encountered. (#…

…324)

images/php/log-fatals.php

@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * @file
+ *
+ * Adds a shutdown function that logs fatal errors along with the REQUEST_URI.
+ *
+ * Intention is to allow tracking of specific routes that exhaust memory limit.
+ */
+
+/**
+ * Returns a list of error types the custom error handler should respond to.
+ */
+function bay_fatal_error_types() {
+  return [
+    E_ERROR => 'E_ERROR',
+    E_PARSE => 'E_PARSE',
+    E_CORE_ERROR => 'E_CORE_ERROR',
+    E_COMPILE_ERROR => 'E_COMPILE_ERROR',
+  ];
+}
+
+register_shutdown_function(function() {
+  $error = error_get_last();
+  $types = bay_fatal_error_types();
+  if ($error && in_array($error['type'], array_keys($types))) {
+    $data = [
+      'type' => $types[$error['type']],
+      'message' => $error['message'],
+      'request_uri' => $_SERVER['REQUEST_URI'] ?: 'N/A',
+    ];
+    error_log("[BAY_FATAL] " . json_encode($data));
+  }
+});

images/php/settings.php

@@ -21,6 +21,11 @@
 $contrib_path = $app_root . DIRECTORY_SEPARATOR . (is_dir('modules/contrib') ? 'modules/contrib' : 'modules');
 $lagoon_env_type = getenv('LAGOON_ENVIRONMENT_TYPE') ?: 'local';
 
+// Feature flag that enables some enhanced logging of fatal errors.
+if (getenv('BAY_PHP_FATAL_LOGS') == "true") {
+  include $bay_settings_path . '/log-fatals.php';
+}
+
 // Database connection.
 $connection_info = [
   'driver' => 'mysql',