[doc-en] master: Sync 8.6 migration guide with php-src UPGRADING (#6025)

Author: Jordi Kroon (jordikroon) Committer: GitHub (web-flow) Pusher: jordikroon Date: 2026-11-01T20:52:43+01:00 Commit: https://github.com/php/doc-en/commit/5fc5cc44b0bacad862c0e2002e81b963ecc37c01 Raw diff: https://github.com/php/doc-en/commit/5fc5cc44b0bacad862c0e2002e81b963ecc37c01.diff Sync 8.6 migration guide with php-src UPGRADING (#6025) Changed paths: M appendices/migration86/constants.xml M appendices/migration86/new-classes.xml M appendices/migration86/new-features.xml M appendices/migration86/new-functions.xml Diff: diff --git a/appendices/migration86/constants.xml b/appendices/migration86/constants.xml index c3d4ced715a0..cdbc9dbb7f6c 100644 --- a/appendices/migration86/constants.xml +++ b/appendices/migration86/constants.xml @@ -149,6 +149,14 @@ <member><constant>SODIUM_CRYPTO_IPCRYPT_NDX_OUTPUTBYTES</constant></member> <member><constant>SODIUM_CRYPTO_IPCRYPT_PFX_KEYBYTES</constant></member> <member><constant>SODIUM_CRYPTO_IPCRYPT_PFX_BYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_SHAKE128_BLOCKBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_SHAKE128_STATEBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_SHAKE256_BLOCKBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_SHAKE256_STATEBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_TURBOSHAKE128_BLOCKBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_TURBOSHAKE128_STATEBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_TURBOSHAKE256_BLOCKBYTES</constant></member> + <member><constant>SODIUM_CRYPTO_XOF_TURBOSHAKE256_STATEBYTES</constant></member> <member><constant>SODIUM_CRYPTO_KEM_PUBLICKEYBYTES</constant> (libsodium >= 1.0.22)</member> <member><constant>SODIUM_CRYPTO_KEM_SECRETKEYBYTES</constant> (libsodium >= 1.0.22)</member> <member><constant>SODIUM_CRYPTO_KEM_CIPHERTEXTBYTES</constant> (libsodium >= 1.0.22)</member> diff --git a/appendices/migration86/new-classes.xml b/appendices/migration86/new-classes.xml index 6467a582d4b2..976871ea5d04 100644 --- a/appendices/migration86/new-classes.xml +++ b/appendices/migration86/new-classes.xml @@ -71,6 +71,16 @@ <!-- RFC: https://wiki.php.net/rfc/snmp_improvements_2026 --> </sect2> + <sect2 xml:id="migration86.new-classes.sodium"> + <title>Sodium</title> + <simplelist> + <member><classname>SodiumCryptoXofShake128State</classname></member> + <member><classname>SodiumCryptoXofShake256State</classname></member> + <member><classname>SodiumCryptoXofTurboshake128State</classname></member> + <member><classname>SodiumCryptoXofTurboshake256State</classname></member> + </simplelist> + </sect2> + <sect2 xml:id="migration86.new-classes.uri"> <title>URI</title> <simplelist> diff --git a/appendices/migration86/new-features.xml b/appendices/migration86/new-features.xml index ab2bdb8034bd..90c0e5946940 100644 --- a/appendices/migration86/new-features.xml +++ b/appendices/migration86/new-features.xml @@ -501,6 +501,24 @@ var_dump(unpack('s>value', "\xff\xfe")); // ["value" => int(-2)] </sect2> + <sect2 xml:id="migration86.new-features.soap"> + <title>SOAP</title> + + <simpara> + Added the <literal>"keep_headers"</literal> option to + <methodname>SoapClient::__construct</methodname> to specify which + <acronym>HTTP</acronym> headers a <classname>SoapClient</classname> should + keep when importing a <acronym>WSDL</acronym> from a host different from + the original one. + By default, the <literal>Authorization</literal>, + <literal>Proxy-Authorization</literal>, and <literal>Cookie</literal> + headers are redacted on such requests. + The option accepts an array of header names to keep, for example + <code>['keep_headers' => ['authorization']]</code>. + </simpara> + + </sect2> + <sect2 xml:id="migration86.new-features.streams"> <title>Streams</title> diff --git a/appendices/migration86/new-functions.xml b/appendices/migration86/new-functions.xml index a20e69c629a1..afb6f30c41ad 100644 --- a/appendices/migration86/new-functions.xml +++ b/appendices/migration86/new-functions.xml @@ -138,6 +138,22 @@ <member><function>sodium_crypto_ipcrypt_pfx_decrypt</function></member> <member><function>sodium_bin2ip</function></member> <member><function>sodium_ip2bin</function></member> + <member><function>sodium_crypto_xof_shake128</function></member> + <member><function>sodium_crypto_xof_shake128_init</function></member> + <member><function>sodium_crypto_xof_shake128_update</function></member> + <member><function>sodium_crypto_xof_shake128_squeeze</function></member> + <member><function>sodium_crypto_xof_shake256</function></member> + <member><function>sodium_crypto_xof_shake256_init</function></member> + <member><function>sodium_crypto_xof_shake256_update</function></member> + <member><function>sodium_crypto_xof_shake256_squeeze</function></member> + <member><function>sodium_crypto_xof_turboshake128</function></member> + <member><function>sodium_crypto_xof_turboshake128_init</function></member> + <member><function>sodium_crypto_xof_turboshake128_update</function></member> + <member><function>sodium_crypto_xof_turboshake128_squeeze</function></member> + <member><function>sodium_crypto_xof_turboshake256</function></member> + <member><function>sodium_crypto_xof_turboshake256_init</function></member> + <member><function>sodium_crypto_xof_turboshake256_update</function></member> + <member><function>sodium_crypto_xof_turboshake256_squeeze</function></member> </simplelist> <para>