fix(agent): Fix error reporting when EH_THROW is enabled

agent/php_error.c

@@ -561,12 +561,36 @@ static int nr_php_should_record_error(int type, const char* format TSRMLS_DC) {
     return 0;
   }
 
+  /*
+   * For a the following error types:
+   * E_WARNING || E_CORE_WARNING || E_COMPILE_WARNING || E_USER_WARNING
+   * PHP triggers an exception if EH_THROW is toggled on and then immediately
+   * returns after throwing the exception. PHP 7 additionally triggers an exception 
+   * for E_RECOVERABLE_ERROR.
+   * See for more info:
+   * https://github.com/php/php-src/blob/master/main/main.c In that case, we
+   * should not handle it, but we should exit and let the exception handler
+   * deal with it; otherwise, we could record an error even if an exception is
+   * caught.
+   */
+#if ZEND_MODULE_API_NO < ZEND_8_0_X_API_NO
+#define E_ERRORS_THROWING_EXCEPTIONS (E_WARNING | E_CORE_WARNING | E_COMPILE_WARNING | E_USER_WARNING | E_RECOVERABLE_ERROR)
+#else
+#define E_ERRORS_THROWING_EXCEPTIONS (E_WARNING | E_CORE_WARNING | E_COMPILE_WARNING | E_USER_WARNING)
+#endif
+
+#define E_THROWS_EXCEPTION(e) ((E_ERRORS_THROWING_EXCEPTIONS & e) == e)
+
+  if (EG(error_handling) == EH_THROW && E_THROWS_EXCEPTION(type)) {
+    // let the exception handler deal with this error
+    return 0;
+  }
+
   errprio = nr_php_error_get_priority(type);
 
   if (0 == errprio) {
     return 0;
   }
-
   if (NR_SUCCESS != nr_txn_record_error_worthy(NRPRG(txn), errprio)) {
     return 0;
   }
@@ -625,7 +649,6 @@ void nr_php_error_cb(int type,
 
     stack_json = nr_php_backtrace_to_json(0 TSRMLS_CC);
     errclass = nr_php_error_get_type_string(type);
-
     nr_txn_record_error(NRPRG(txn), nr_php_error_get_priority(type), true,
                         msg, errclass, stack_json);
 

tests/integration/errors/test_EH_THROW_errors_caught_exception.php

@@ -0,0 +1,69 @@
+<?php
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*DESCRIPTION
+For a certain number of error types, PHP triggers an exception if EH_THROW is toggled on.
+Verify we don't record the error if the exception is thrown and caught.
+There should be no traced errors, error events, or errors attached to span events.
+*/
+
+/*INI
+display_errors=1
+log_errors=0
+error_reporting=E_ALL
+*/
+
+/*EXPECT_SPAN_EVENTS
+[
+  "?? agent run id",
+  {
+    "reservoir_size": 10000,
+    "events_seen": 1
+  },
+  [
+    [
+      {
+        "traceId": "??",
+        "duration": "??",
+        "transactionId": "??",
+        "name": "OtherTransaction\/php__FILE__",
+        "guid": "??",
+        "type": "Span",
+        "category": "generic",
+        "priority": "??",
+        "sampled": true,
+        "nr.entryPoint": true,
+        "timestamp": "??",
+        "transaction.name": "OtherTransaction\/php__FILE__"
+      },
+      {},
+      {}
+    ]
+  ]
+]
+*/
+
+
+/*EXPECT_REGEX
+Exception caught*
+*/
+
+/*EXPECT_TRACED_ERRORS
+null
+*/
+
+/*EXPECT_ERROR_EVENTS
+null
+*/
+
+$base_directory = __DIR__ . '/nonexist';;
+
+try {
+       $n = new RecursiveDirectoryIterator( $base_directory ) ;
+}
+catch (\Exception $e) {
+       echo ("Exception caught: " . $e->getMessage());
+}

tests/integration/errors/test_EH_THROW_errors_uncaught_exception.php

@@ -0,0 +1,112 @@
+<?php
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*DESCRIPTION
+For a certain number of error types, PHP triggers an exception if EH_THROW is toggled on.
+Verify we record the error if the exception is thrown and NOT caught.
+There should be  traced errors, error events, and an error attached to span events.
+*/
+
+/*INI
+display_errors=1
+log_errors=0
+error_reporting=E_ALL
+*/
+
+/*EXPECT_SPAN_EVENTS
+[
+  "?? agent run id",
+  {
+    "reservoir_size": 10000,
+    "events_seen": 1
+  },
+  [
+    [
+      {
+        "traceId": "??",
+        "duration": "??",
+        "transactionId": "??",
+        "name": "OtherTransaction\/php__FILE__",
+        "guid": "??",
+        "type": "Span",
+        "category": "generic",
+        "priority": "??",
+        "sampled": true,
+        "nr.entryPoint": true,
+        "timestamp": "??",
+        "transaction.name": "OtherTransaction\/php__FILE__"
+      },
+      {},
+      {
+        "error.message": "?? Uncaught exception ??",
+        "error.class": "UnexpectedValueException"
+      }
+    ]
+  ]
+]
+*/
+
+
+
+/*EXPECT_REGEX
+Fatal error*
+*/
+
+/*EXPECT_TRACED_ERRORS
+[
+  "?? agent run id",
+  [
+    [
+      "?? when",
+      "OtherTransaction/php__FILE__",
+      "?? Uncaught exception ??",
+      "UnexpectedValueException",
+      {
+        "stack_trace": "??",
+        "agentAttributes": "??",
+        "intrinsics": "??"
+      },
+      "?? transaction ID"
+    ]
+  ]
+]
+*/
+
+/*EXPECT_ERROR_EVENTS
+[
+  "?? agent run id",
+  {
+    "reservoir_size": "??",
+    "events_seen": 1
+  },
+  [
+    [
+      {
+        "type": "TransactionError",
+        "timestamp": "??",
+        "error.class": "UnexpectedValueException",
+        "error.message": "?? Uncaught exception ??",
+        "transactionName": "OtherTransaction\/php__FILE__",
+        "duration": "??",
+        "nr.transactionGuid": "??",
+        "guid": "??",
+        "sampled": true,
+        "priority": "??",
+        "traceId": "??",
+        "spanId": "??"
+      },
+      {},
+      {}
+    ]
+  ]
+]
+*/
+
+$base_directory = __DIR__ . '/nonexist';;
+
+$n = new RecursiveDirectoryIterator( $base_directory );
+
+echo("Should not get here");