Add deprecation notices to utf8_encode and utf8_decode

Implements initial stage of accepted RFC to remove them:
https://wiki.php.net/rfc/remove_utf8_decode_and_utf8_encode

Author: IMSoP

ext/soap/tests/interop/Round2/Base/r2_base_005p.phpt

@@ -11,7 +11,8 @@ $HTTP_RAW_POST_DATA = $client->__getlastrequest();
 include("round2_base.inc");
 echo "ok\n";
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_encode() is deprecated in %s on line %d
 <?xml version="1.0" encoding="UTF-8"?>
 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://soapinterop.org/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><ns1:echoString><param0 xsi:type="xsd:string">ỗÈéóÒ₧⅜ỗỸ</param0></ns1:echoString></SOAP-ENV:Body></SOAP-ENV:Envelope>
 <?xml version="1.0" encoding="UTF-8"?>

ext/soap/tests/interop/Round2/Base/r2_base_005s.phpt

@@ -11,7 +11,8 @@ $HTTP_RAW_POST_DATA = $client->__getlastrequest();
 include("round2_base.inc");
 echo "ok\n";
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_encode() is deprecated in %s on line %d
 <?xml version="1.0" encoding="UTF-8"?>
 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://soapinterop.org/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><ns1:echoString><inputString xsi:type="xsd:string">ỗÈéóÒ₧⅜ỗỸ</inputString></ns1:echoString></SOAP-ENV:Body></SOAP-ENV:Envelope>
 <?xml version="1.0" encoding="UTF-8"?>

ext/soap/tests/interop/Round2/Base/r2_base_005w.phpt

@@ -13,7 +13,8 @@ $HTTP_RAW_POST_DATA = $client->__getlastrequest();
 include("round2_base.inc");
 echo "ok\n";
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_encode() is deprecated in %s on line %d
 <?xml version="1.0" encoding="UTF-8"?>
 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://soapinterop.org/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><ns1:echoString><inputString xsi:type="xsd:string">ỗÈéóÒ₧⅜ỗỸ</inputString></ns1:echoString></SOAP-ENV:Body></SOAP-ENV:Envelope>
 <?xml version="1.0" encoding="UTF-8"?>

ext/standard/basic_functions.stub.php

@@ -1021,10 +1021,16 @@ function strpbrk(string $string, string $characters): string|false {}
 
 function substr_compare(string $haystack, string $needle, int $offset, ?int $length = null, bool $case_insensitive = false): int {}
 
-/** @refcount 1 */
+/**
+ * @refcount 1
+ * @deprecated
+ */
 function utf8_encode(string $string): string {}
 
-/** @refcount 1 */
+/**
+ * @refcount 1
+ * @deprecated
+ */
 function utf8_decode(string $string): string {}
 
 /* dir.c */

ext/standard/basic_functions_arginfo.h

@@ -6,6 +6,11 @@ $str = utf8_encode("\xe0\xe1");
 var_dump(utf8_decode($str));
 var_dump(utf8_decode(htmlspecialchars($str, ENT_COMPAT, "UTF-8")));
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_encode() is deprecated in %s on line %d
+
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 string(2) "àá"
+
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 string(2) "àá"

ext/standard/tests/strings/bug20934.phpt

@@ -4,5 +4,6 @@ Bug #43957 (utf8_decode() bogus conversion on multibyte indicator near end of st
 <?php
   echo utf8_decode('abc'.chr(0xe0));
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 abc?

ext/standard/tests/strings/bug43957.phpt

@@ -13,8 +13,13 @@ foreach ($tests as $t) {
 }
 echo "Done.\n";
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 413f3e42
+
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 3f22
+
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 413f3f423f433f3f
 Done.

ext/standard/tests/strings/bug49687.phpt

@@ -5,6 +5,9 @@ UTF-8<->ISO Latin 1 encoding/decoding test
 printf("%s -> %s\n", urlencode("æ"), urlencode(utf8_encode("æ")));
 printf("%s <- %s\n", urlencode(utf8_decode(urldecode("%C3%A6"))), "%C3%A6");
 ?>
---EXPECT--
+--EXPECTF--
+Deprecated: Function utf8_encode() is deprecated in %s on line %d
 %E6 -> %C3%A6
+
+Deprecated: Function utf8_decode() is deprecated in %s on line %d
 %E6 <- %C3%A6