initial version 1.0

Author: LamentXU123

NEWS

@@ -179,6 +179,7 @@ PHP                                                                        NEWS
     (Weilin Du)
   . getenv() and putenv() now raises a ValueError when the first argument
     contains null bytes. (Weilin Du)
+  . metaphone() is now deprecated. (Weilin Du)
 
 - Streams:
   . Added so_keepalive, tcp_keepidle, tcp_keepintvl and tcp_keepcnt stream

UPGRADING

@@ -154,6 +154,11 @@ PHP 8.6 UPGRADE NOTES
 4. Deprecated Functionality
 ========================================
 
+- Standard:
+  . metaphone() is deprecated.
+    Please use a userland phonetic matching library instead.
+    RFC: https://wiki.php.net/rfc/deprecate-metaphone
+
 ========================================
 5. Changed Functions
 ========================================

ext/standard/basic_functions.stub.php

@@ -2239,6 +2239,7 @@ function inet_pton(string $ip): string|false {}
 /* metaphone.c */
 
 /** @refcount 1 */
+#[\Deprecated(since: '8.6')]
 function metaphone(string $string, int $max_phonemes = 0): string {}
 
 /* {{{ head.c */

ext/standard/tests/strings/bug44242.phpt

@@ -3,9 +3,9 @@ Bug #44242 (metaphone('CMXFXM') crashes PHP)
 --FILE--
 <?php
 
-echo metaphone('CMXFXZ'), "\n";
-echo metaphone('CMXFXV'), "\n";
-echo metaphone('CMXFXZXZ'), "\n";
+echo @metaphone('CMXFXZ'), "\n";
+echo @metaphone('CMXFXV'), "\n";
+echo @metaphone('CMXFXZXZ'), "\n";
 
 ?>
 --EXPECT--

ext/standard/tests/strings/bug47443.phpt

@@ -3,9 +3,9 @@ Bug #47443 (metaphone('scratch') returns wrong result)
 --FILE--
 <?php
 
-var_dump(metaphone("scratch"));
-var_dump(metaphone("scrath"));
-var_dump(metaphone("scratc"));
+var_dump(@metaphone("scratch"));
+var_dump(@metaphone("scrath"));
+var_dump(@metaphone("scratc"));
 
 ?>
 --EXPECT--

ext/standard/tests/strings/bug48709.phpt

@@ -16,7 +16,7 @@ $exceptions = array(
 );
 
 foreach ($exceptions as $letter) {
-    printf("%s => %s\n", $letter, metaphone($letter));
+    printf("%s => %s\n", $letter, @metaphone($letter));
 }
 
 ?>

ext/standard/tests/strings/metaphone.phpt

@@ -3,16 +3,16 @@ metaphone() tests
 --FILE--
 <?php
 
-var_dump(metaphone(""));
-var_dump(metaphone(-1));
+var_dump(@metaphone(""));
+var_dump(@metaphone(-1));
 
 try {
-    var_dump(metaphone("valid phrase", -1));
+    var_dump(@metaphone("valid phrase", -1));
 } catch (ValueError $e) {
     echo $e->getMessage(), "\n";
 }
-var_dump(metaphone("valid phrase", 0));
-var_dump(metaphone("valid phrase", 10000));
+var_dump(@metaphone("valid phrase", 0));
+var_dump(@metaphone("valid phrase", 10000));
 
 $array = array(
 "They fell forward, grovelling heedlessly on the cold earth.",
@@ -22,7 +22,7 @@ $array = array(
 );
 
 foreach($array as $str) {
-    var_dump(metaphone($str));
+    var_dump(@metaphone($str));
 }
 
 echo "Done\n";

ext/standard/tests/strings/metaphone_deprecation.phpt

@@ -0,0 +1,11 @@
+--TEST--
+metaphone() deprecation
+--FILE--
+<?php
+
+var_dump(metaphone("programming"));
+
+?>
+--EXPECTF--
+Deprecated: Function metaphone() is deprecated since 8.6 in %s on line %d
+string(7) "PRKRMNK"