Add a PREG_THROW_ON_ERROR flag that makes the preg functions throw on error.

Author: aldemeery

NEWS

@@ -789,6 +789,10 @@ PHP                                                                        NEWS
   . pcntl_exec() now throws a ValueError if the $args array is not a list
     array. (Weilin Du)
 
+- PCRE:
+  . Added the PREG_THROW_ON_ERROR flag to make the preg_*() functions throw a
+    \PregException on any PCRE error. (aldemeery)
+
 - PDO_DBLIB:
   . Added dblib_handle_check_liveness handler. (freddy77)
 

UPGRADING

@@ -427,6 +427,20 @@ PHP 8.6 UPGRADE NOTES
     outcome is reported as 'accepted', 'rejected' or 'not_sent' in the
     early_data key of the crypto stream_get_meta_data() array.
 
+- PCRE:
+  . Added the PREG_THROW_ON_ERROR flag. When passed to a preg_*() function that
+    accepts a $flags argument, any PCRE error reported by preg_last_error()
+    throws a \PregException instead of emitting a warning or returning
+    false/null. The exception's code and message are exactly what
+    preg_last_error() and preg_last_error_msg() report for the same call: the
+    flag changes how an error is delivered, not the error itself. This covers
+    both compilation errors (such as a malformed pattern) and execution errors
+    (such as an exhausted backtrack limit or malformed UTF-8 input under the /u
+    modifier). preg_replace() and preg_filter() gained a $flags parameter to
+    accept it. As on the non-flag path, by-reference outputs (the $matches and
+    $count arguments) may already have been written when the \PregException is
+    thrown, so a catch block should not assume they are left untouched.
+
 - PDO_PGSQL:
   . Added Pdo\Pgsql::ATTR_CHUNK_SIZE, the number of rows a statement fetches
     per chunk. A value of 1 or more enters the lazy fetch mode of
@@ -669,6 +683,10 @@ PHP 8.6 UPGRADE NOTES
     when OPENSSL_PKCS1_PSS_PADDING is used. It accepts an explicit length or
     one of the new OPENSSL_RSA_PSS_SALTLEN_* constants.
 
+- PCRE:
+  . preg_replace() and preg_filter() now accept an optional $flags argument
+    (for PREG_THROW_ON_ERROR).
+
 - PDO_DBLIB:
   . When using persistent connections, there is now a liveness check in the
     constructor.
@@ -782,6 +800,9 @@ PHP 8.6 UPGRADE NOTES
     RFC: https://wiki.php.net/rfc/tls_session_resumption
   . Openssl\Psk
 
+- PCRE:
+  . PregException
+
 - SNMP:
   . enum: Snmp\Mib
   . enum: Snmp\OidOutput
@@ -856,6 +877,9 @@ PHP 8.6 UPGRADE NOTES
   . OPENSSL_RSA_PSS_SALTLEN_AUTO.
   . OPENSSL_RSA_PSS_SALTLEN_MAX.
 
+- PCRE:
+  . PREG_THROW_ON_ERROR.
+
 - Sockets:
   . TCP_USER_TIMEOUT (Linux only).
   . AF_UNSPEC.

ext/fileinfo/libmagic/funcs.c

@@ -663,7 +663,7 @@ file_replace(struct magic_set *ms, const char *pat, const char *rep)
 
 	opts |= PCRE2_MULTILINE;
 	pattern = convert_libmagic_pattern(pat, strlen(pat), opts);
-	pce = pcre_get_compiled_regex_cache_ex(pattern, 0);
+	pce = pcre_get_compiled_regex_cache_ex(pattern, 0, 0);
 	zend_string_release_ex(pattern, 0);
 	if (pce == NULL) {
 		rep_cnt = -1;

ext/fileinfo/libmagic/softmagic.c

@@ -497,7 +497,7 @@ check_fmt(struct magic_set *ms, const char *fmt)
 		return 0;
 
 	pattern = ZSTR_INIT_LITERAL("~%[-0-9\\.]*s~", 0);
-	if ((pce = pcre_get_compiled_regex_cache_ex(pattern, 0)) == NULL) {
+	if ((pce = pcre_get_compiled_regex_cache_ex(pattern, 0, 0)) == NULL) {
 		rv = -1;
 	} else {
 		pcre2_code *re = php_pcre_pce_re(pce);