[doc-en] master: Define attribute signatures (#5631)

Author: Jordi Kroon (jordikroon) Committer: GitHub (web-flow) Pusher: jordikroon Date: 2026-09-11T16:32:34+02:00 Commit: https://github.com/php/doc-en/commit/8dc5bef8981ffd33c8c51f7f33414fcf5c03767a Raw diff: https://github.com/php/doc-en/commit/8dc5bef8981ffd33c8c51f7f33414fcf5c03767a.diff Define attribute signatures (#5631) * Define complete attribute definition Changed paths: M language/predefined/attributes/allowdynamicproperties.xml M language/predefined/attributes/attribute.xml M language/predefined/attributes/delayedtargetvalidation.xml M language/predefined/attributes/deprecated.xml M language/predefined/attributes/nodiscard.xml M language/predefined/attributes/override.xml M language/predefined/attributes/returntypewillchange.xml M language/predefined/attributes/sensitiveparameter.xml M reference/curl/functions/curl-close.xml M reference/curl/functions/curl-share-close.xml M reference/datetime/datetimeinterface/wakeup.xml M reference/datetime/functions/date-sunrise.xml M reference/datetime/functions/date-sunset.xml M reference/datetime/functions/gmstrftime.xml M reference/datetime/functions/strftime.xml M reference/datetime/functions/strptime.xml M reference/enchant/functions/enchant-broker-free-dict.xml M reference/enchant/functions/enchant-broker-free.xml M reference/enchant/functions/enchant-broker-get-dict-path.xml M reference/enchant/functions/enchant-broker-set-dict-path.xml M reference/fileinfo/functions/finfo-close.xml M reference/image/functions/imagedestroy.xml M reference/ldap/functions/ldap-connect-wallet.xml M reference/libxml/functions/libxml-disable-entity-loader.xml M reference/mhash/functions/mhash-count.xml M reference/mhash/functions/mhash-get-block-size.xml M reference/mhash/functions/mhash-get-hash-name.xml M reference/mhash/functions/mhash-keygen-s2k.xml M reference/mhash/functions/mhash.xml M reference/mysqli/mysqli/get-client-info.xml M reference/mysqli/mysqli/init.xml M reference/mysqli/mysqli/kill.xml M reference/mysqli/mysqli/ping.xml M reference/mysqli/mysqli/refresh.xml M reference/openssl/functions/openssl-free-key.xml M reference/openssl/functions/openssl-password-hash.xml M reference/openssl/functions/openssl-password-verify.xml M reference/openssl/functions/openssl-pkey-free.xml M reference/openssl/functions/openssl-x509-free.xml M reference/pgsql/functions/pg-change-password.xml M reference/random/functions/lcg-value.xml M reference/reflection/reflectionfunction/isdisabled.xml M reference/reflection/reflectionmethod/setaccessible.xml M reference/reflection/reflectionparameter/getclass.xml M reference/reflection/reflectionparameter/isarray.xml M reference/reflection/reflectionparameter/iscallable.xml M reference/reflection/reflectionproperty/setaccessible.xml M reference/shmop/functions/shmop-close.xml M reference/spl/splfixedarray/wakeup.xml M reference/spl/splobjectstorage/attach.xml M reference/spl/splobjectstorage/contains.xml M reference/spl/splobjectstorage/detach.xml M reference/strings/functions/utf8-decode.xml M reference/strings/functions/utf8-encode.xml M reference/uodbc/functions/odbc-result-all.xml M reference/xml/functions/xml-parser-free.xml M reference/xml/functions/xml-set-object.xml M reference/zip/functions/zip-close.xml M reference/zip/functions/zip-entry-close.xml M reference/zip/functions/zip-entry-compressedsize.xml M reference/zip/functions/zip-entry-compressionmethod.xml M reference/zip/functions/zip-entry-filesize.xml M reference/zip/functions/zip-entry-name.xml M reference/zip/functions/zip-entry-open.xml M reference/zip/functions/zip-entry-read.xml M reference/zip/functions/zip-open.xml M reference/zip/functions/zip-read.xml Diff: diff --git a/language/predefined/attributes/allowdynamicproperties.xml b/language/predefined/attributes/allowdynamicproperties.xml index 463f3b4bb4f2..f3410a5e7ea6 100644 --- a/language/predefined/attributes/allowdynamicproperties.xml +++ b/language/predefined/attributes/allowdynamicproperties.xml @@ -27,7 +27,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_CLASS)]</modifier> <modifier>final</modifier> <classname>AllowDynamicProperties</classname> </ooclass> diff --git a/language/predefined/attributes/attribute.xml b/language/predefined/attributes/attribute.xml index 97c9dbebc3a9..db3b0cccb217 100644 --- a/language/predefined/attributes/attribute.xml +++ b/language/predefined/attributes/attribute.xml @@ -23,7 +23,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_CLASS)]</modifier> <modifier>final</modifier> <classname>Attribute</classname> </ooclass> diff --git a/language/predefined/attributes/delayedtargetvalidation.xml b/language/predefined/attributes/delayedtargetvalidation.xml index 8f291b2cb258..1467f994c018 100644 --- a/language/predefined/attributes/delayedtargetvalidation.xml +++ b/language/predefined/attributes/delayedtargetvalidation.xml @@ -29,7 +29,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_ALL)]</modifier> <modifier>final</modifier> <classname>DelayedTargetValidation</classname> </ooclass> diff --git a/language/predefined/attributes/deprecated.xml b/language/predefined/attributes/deprecated.xml index ec4b125fa7b0..9501d11e03f7 100644 --- a/language/predefined/attributes/deprecated.xml +++ b/language/predefined/attributes/deprecated.xml @@ -22,7 +22,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION | \Attribute::TARGET_CLASS_CONSTANT | \Attribute::TARGET_CONSTANT | \Attribute::TARGET_CLASS)]</modifier> <modifier>final</modifier> <classname>Deprecated</classname> </ooclass> diff --git a/language/predefined/attributes/nodiscard.xml b/language/predefined/attributes/nodiscard.xml index 83ee33fa8b55..f14bd4c6c5db 100644 --- a/language/predefined/attributes/nodiscard.xml +++ b/language/predefined/attributes/nodiscard.xml @@ -52,7 +52,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION)]</modifier> <modifier>final</modifier> <classname>NoDiscard</classname> </ooclass> diff --git a/language/predefined/attributes/override.xml b/language/predefined/attributes/override.xml index aa7101f256f1..041dceadfdf3 100644 --- a/language/predefined/attributes/override.xml +++ b/language/predefined/attributes/override.xml @@ -29,7 +29,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY)]</modifier> <modifier>final</modifier> <classname>Override</classname> </ooclass> diff --git a/language/predefined/attributes/returntypewillchange.xml b/language/predefined/attributes/returntypewillchange.xml index df9213e7832e..714304fa856a 100644 --- a/language/predefined/attributes/returntypewillchange.xml +++ b/language/predefined/attributes/returntypewillchange.xml @@ -52,7 +52,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD)]</modifier> <modifier>final</modifier> <classname>ReturnTypeWillChange</classname> </ooclass> diff --git a/language/predefined/attributes/sensitiveparameter.xml b/language/predefined/attributes/sensitiveparameter.xml index 2b52261e45a2..c8fc77b52d0b 100644 --- a/language/predefined/attributes/sensitiveparameter.xml +++ b/language/predefined/attributes/sensitiveparameter.xml @@ -19,7 +19,7 @@ <classsynopsis class="class"> <ooclass> - <modifier role="attribute">#[\Attribute]</modifier> + <modifier role="attribute">#[\Attribute(\Attribute::TARGET_PARAMETER)]</modifier> <modifier>final</modifier> <classname>SensitiveParameter</classname> </ooclass> diff --git a/reference/curl/functions/curl-close.xml b/reference/curl/functions/curl-close.xml index 207b3b1d8e7d..2cf94b043148 100644 --- a/reference/curl/functions/curl-close.xml +++ b/reference/curl/functions/curl-close.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier> <type>void</type><methodname>curl_close</methodname> <methodparam><type>CurlHandle</type><parameter>handle</parameter></methodparam> </methodsynopsis> diff --git a/reference/curl/functions/curl-share-close.xml b/reference/curl/functions/curl-share-close.xml index 1dde32aa473c..a86af4c5effb 100644 --- a/reference/curl/functions/curl-share-close.xml +++ b/reference/curl/functions/curl-share-close.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier> <type>void</type><methodname>curl_share_close</methodname> <methodparam><type>CurlShareHandle</type><parameter>share_handle</parameter></methodparam> </methodsynopsis> diff --git a/reference/datetime/datetimeinterface/wakeup.xml b/reference/datetime/datetimeinterface/wakeup.xml index 1c1a521e569c..716dce125543 100644 --- a/reference/datetime/datetimeinterface/wakeup.xml +++ b/reference/datetime/datetimeinterface/wakeup.xml @@ -15,17 +15,17 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="DateTime"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier> <modifier>public</modifier> <type>void</type><methodname>DateTime::__wakeup</methodname> <void/> </methodsynopsis> <methodsynopsis role="DateTimeImmutable"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier> <modifier>public</modifier> <type>void</type><methodname>DateTimeImmutable::__wakeup</methodname> <void/> </methodsynopsis> <methodsynopsis role="DateTimeInterface"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier> <modifier>public</modifier> <type>void</type><methodname>DateTimeInterface::__wakeup</methodname> <void/> </methodsynopsis> diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml index 4223ab3c479d..c75205af4d20 100644 --- a/reference/datetime/functions/date-sunrise.xml +++ b/reference/datetime/functions/date-sunrise.xml @@ -19,7 +19,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use date_sun_info() instead')]</modifier> <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname> <methodparam><type>int</type><parameter>timestamp</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml index a7da44a69b05..d97266daf48e 100644 --- a/reference/datetime/functions/date-sunset.xml +++ b/reference/datetime/functions/date-sunset.xml @@ -21,7 +21,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use date_sun_info() instead')]</modifier> <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname> <methodparam><type>int</type><parameter>timestamp</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> diff --git a/reference/datetime/functions/gmstrftime.xml b/reference/datetime/functions/gmstrftime.xml index 2520f3737850..fb691dacfb34 100644 --- a/reference/datetime/functions/gmstrftime.xml +++ b/reference/datetime/functions/gmstrftime.xml @@ -17,7 +17,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use IntlDateFormatter::format() instead')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam> diff --git a/reference/datetime/functions/strftime.xml b/reference/datetime/functions/strftime.xml index 07a39f3b4b8c..8b7439e77a2b 100644 --- a/reference/datetime/functions/strftime.xml +++ b/reference/datetime/functions/strftime.xml @@ -17,7 +17,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use IntlDateFormatter::format() instead')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam> diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml index 4b622f8d8207..7bc0128093b4 100644 --- a/reference/datetime/functions/strptime.xml +++ b/reference/datetime/functions/strptime.xml @@ -15,7 +15,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.2', message: 'use date_parse_from_format() (for locale-independent parsing), or IntlDateFormatter::parse() (for locale-dependent parsing) instead')]</modifier> <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname> <methodparam><type>string</type><parameter>timestamp</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> diff --git a/reference/enchant/functions/enchant-broker-free-dict.xml b/reference/enchant/functions/enchant-broker-free-dict.xml index ce40ead5f6a1..f0defac2d7dc 100644 --- a/reference/enchant/functions/enchant-broker-free-dict.xml +++ b/reference/enchant/functions/enchant-broker-free-dict.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free-dict"> +<refentry xml:id="function.enchant-broker-free-dict" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>enchant_broker_free_dict</refname> <refpurpose>Free a dictionary resource</refpurpose> @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as EnchantDictionary objects are freed automatically')]</modifier> <type>bool</type><methodname>enchant_broker_free_dict</methodname> <methodparam><type>EnchantDictionary</type><parameter>dictionary</parameter></methodparam> </methodsynopsis> diff --git a/reference/enchant/functions/enchant-broker-free.xml b/reference/enchant/functions/enchant-broker-free.xml index 7867a9d4e2ce..ce2393b7cad0 100644 --- a/reference/enchant/functions/enchant-broker-free.xml +++ b/reference/enchant/functions/enchant-broker-free.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free"> +<refentry xml:id="function.enchant-broker-free" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>enchant_broker_free</refname> <refpurpose>Free the broker resource and its dictionaries</refpurpose> @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as EnchantBroker objects are freed automatically')]</modifier> <type>bool</type><methodname>enchant_broker_free</methodname> <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam> </methodsynopsis> diff --git a/reference/enchant/functions/enchant-broker-get-dict-path.xml b/reference/enchant/functions/enchant-broker-get-dict-path.xml index 9b74978ac835..3e6a1de36f31 100644 --- a/reference/enchant/functions/enchant-broker-get-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-get-dict-path.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-get-dict-path"> +<refentry xml:id="function.enchant-broker-get-dict-path" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>enchant_broker_get_dict_path</refname> <refpurpose>Get the directory path for a given backend</refpurpose> @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>enchant_broker_get_dict_path</methodname> <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam> <methodparam><type>int</type><parameter>type</parameter></methodparam> diff --git a/reference/enchant/functions/enchant-broker-set-dict-path.xml b/reference/enchant/functions/enchant-broker-set-dict-path.xml index 0b560fa87828..acf22f2d0349 100644 --- a/reference/enchant/functions/enchant-broker-set-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-set-dict-path.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-set-dict-path"> +<refentry xml:id="function.enchant-broker-set-dict-path" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>enchant_broker_set_dict_path</refname> <refpurpose>Set the directory path for a given backend</refpurpose> @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier> <type>bool</type><methodname>enchant_broker_set_dict_path</methodname> <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam> <methodparam><type>int</type><parameter>type</parameter></methodparam> diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml index 13fffa61781c..5c5545b033c1 100644 --- a/reference/fileinfo/functions/finfo-close.xml +++ b/reference/fileinfo/functions/finfo-close.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-close"> +<refentry xml:id="function.finfo-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_close</refname> <refpurpose>Close finfo instance</refpurpose> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'as finfo objects are freed automatically')]</modifier> <type>true</type><methodname>finfo_close</methodname> <methodparam><type>finfo</type><parameter>finfo</parameter></methodparam> </methodsynopsis> diff --git a/reference/image/functions/imagedestroy.xml b/reference/image/functions/imagedestroy.xml index cb99c5b7b0a5..99db24da082e 100644 --- a/reference/image/functions/imagedestroy.xml +++ b/reference/image/functions/imagedestroy.xml @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier> <type>true</type><methodname>imagedestroy</methodname> <methodparam><type>GdImage</type><parameter>image</parameter></methodparam> </methodsynopsis> diff --git a/reference/ldap/functions/ldap-connect-wallet.xml b/reference/ldap/functions/ldap-connect-wallet.xml index 6fc4db3e581e..ce4cfc20df1e 100644 --- a/reference/ldap/functions/ldap-connect-wallet.xml +++ b/reference/ldap/functions/ldap-connect-wallet.xml @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: "8.5", message: "as it is broken since PHP 8.0")]</modifier> <type class="union"><type>LDAP\Connection</type><type>false</type></type><methodname>ldap_connect_wallet</methodname> <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>uri</parameter><initializer>&null;</initializer></methodparam> <methodparam><type>string</type><parameter>wallet</parameter></methodparam> diff --git a/reference/libxml/functions/libxml-disable-entity-loader.xml b/reference/libxml/functions/libxml-disable-entity-loader.xml index 50b2ecf63cc3..d5417155d5d0 100644 --- a/reference/libxml/functions/libxml-disable-entity-loader.xml +++ b/reference/libxml/functions/libxml-disable-entity-loader.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as external entity loading is disabled by default')]</modifier> <type>bool</type><methodname>libxml_disable_entity_loader</methodname> <methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam> </methodsynopsis> diff --git a/reference/mhash/functions/mhash-count.xml b/reference/mhash/functions/mhash-count.xml index b2e747a8c06d..9738d9e5a319 100644 --- a/reference/mhash/functions/mhash-count.xml +++ b/reference/mhash/functions/mhash-count.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type>int</type><methodname>mhash_count</methodname> <void/> </methodsynopsis> diff --git a/reference/mhash/functions/mhash-get-block-size.xml b/reference/mhash/functions/mhash-get-block-size.xml index 3d0cdbaf3475..c0e9f1dae825 100644 --- a/reference/mhash/functions/mhash-get-block-size.xml +++ b/reference/mhash/functions/mhash-get-block-size.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>mhash_get_block_size</methodname> <methodparam><type>int</type><parameter>algo</parameter></methodparam> </methodsynopsis> diff --git a/reference/mhash/functions/mhash-get-hash-name.xml b/reference/mhash/functions/mhash-get-hash-name.xml index 0752fd2c3eef..acfbc6ed0977 100644 --- a/reference/mhash/functions/mhash-get-hash-name.xml +++ b/reference/mhash/functions/mhash-get-hash-name.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>mhash_get_hash_name</methodname> <methodparam><type>int</type><parameter>algo</parameter></methodparam> </methodsynopsis> diff --git a/reference/mhash/functions/mhash-keygen-s2k.xml b/reference/mhash/functions/mhash-keygen-s2k.xml index 9a8eef7fbc44..1fdff08a982b 100644 --- a/reference/mhash/functions/mhash-keygen-s2k.xml +++ b/reference/mhash/functions/mhash-keygen-s2k.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>mhash_keygen_s2k</methodname> <methodparam><type>int</type><parameter>algo</parameter></methodparam> <methodparam><type>string</type><parameter>password</parameter></methodparam> diff --git a/reference/mhash/functions/mhash.xml b/reference/mhash/functions/mhash.xml index 61c56c179f62..dc0ac7ff6b26 100644 --- a/reference/mhash/functions/mhash.xml +++ b/reference/mhash/functions/mhash.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>mhash</methodname> <methodparam><type>int</type><parameter>algo</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> diff --git a/reference/mysqli/mysqli/get-client-info.xml b/reference/mysqli/mysqli/get-client-info.xml index 9b78245a7aef..d871b2fe02ab 100644 --- a/reference/mysqli/mysqli/get-client-info.xml +++ b/reference/mysqli/mysqli/get-client-info.xml @@ -13,7 +13,7 @@ <para>&style.oop;</para> <fieldsynopsis><type>string</type><varname linkend="mysqli.get-client-info">mysqli-&gt;client_info</varname></fieldsynopsis> <methodsynopsis role="mysqli"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use mysqli_get_client_info() instead')]</modifier> <modifier>public</modifier> <type>string</type><methodname>mysqli::get_client_info</methodname> <void/> </methodsynopsis> diff --git a/reference/mysqli/mysqli/init.xml b/reference/mysqli/mysqli/init.xml index bd95347d4b01..dcf1ce4203b6 100644 --- a/reference/mysqli/mysqli/init.xml +++ b/reference/mysqli/mysqli/init.xml @@ -11,7 +11,7 @@ &reftitle.description; <para>&style.oop;</para> <methodsynopsis role="mysqli"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'replace calls to parent::init() with parent::__construct()')]</modifier> <modifier>public</modifier> <type class="union"><type>bool</type><type>null</type></type><methodname>mysqli::init</methodname> <void/> </methodsynopsis> diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml index da68d2318eb0..f177d2f5a992 100644 --- a/reference/mysqli/mysqli/kill.xml +++ b/reference/mysqli/mysqli/kill.xml @@ -15,13 +15,13 @@ &reftitle.description; <para>&style.oop;</para> <methodsynopsis role="mysqli"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use KILL CONNECTION/QUERY SQL statement instead')]</modifier> <modifier>public</modifier> <type>bool</type><methodname>mysqli::kill</methodname> <methodparam><type>int</type><parameter>process_id</parameter></methodparam> </methodsynopsis> <para>&style.procedural;</para> <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use KILL CONNECTION/QUERY SQL statement instead')]</modifier> <type>bool</type><methodname>mysqli_kill</methodname> <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam> <methodparam><type>int</type><parameter>process_id</parameter></methodparam> diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml index ab108cf65e55..9100c1a8781d 100644 --- a/reference/mysqli/mysqli/ping.xml +++ b/reference/mysqli/mysqli/ping.xml @@ -15,13 +15,13 @@ &reftitle.description; <para>&style.oop;</para> <methodsynopsis role="mysqli"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'because the reconnect feature has been removed in PHP 8.2 and this method is now redundant')]</modifier> <modifier>public</modifier> <type>bool</type><methodname>mysqli::ping</methodname> <void/> </methodsynopsis> <para>&style.procedural;</para> <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'because the reconnect feature has been removed in PHP 8.2 and this function is now redundant')]</modifier> <type>bool</type><methodname>mysqli_ping</methodname> <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam> </methodsynopsis> diff --git a/reference/mysqli/mysqli/refresh.xml b/reference/mysqli/mysqli/refresh.xml index dbff59bf7868..e5bee9103af2 100644 --- a/reference/mysqli/mysqli/refresh.xml +++ b/reference/mysqli/mysqli/refresh.xml @@ -15,13 +15,13 @@ &reftitle.description; <para>&style.oop;</para> <methodsynopsis role="mysqli"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use FLUSH SQL statement instead')]</modifier> <modifier>public</modifier> <type>bool</type><methodname>mysqli::refresh</methodname> <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para>&style.procedural;</para> <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use FLUSH SQL statement instead')]</modifier> <type>bool</type><methodname>mysqli_refresh</methodname> <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam> <methodparam><type>int</type><parameter>flags</parameter></methodparam> diff --git a/reference/openssl/functions/openssl-free-key.xml b/reference/openssl/functions/openssl-free-key.xml index bf2d0f36fdb6..500292162bd3 100644 --- a/reference/openssl/functions/openssl-free-key.xml +++ b/reference/openssl/functions/openssl-free-key.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as OpenSSLAsymmetricKey objects are freed automatically')]</modifier> <type>void</type><methodname>openssl_free_key</methodname> <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam> </methodsynopsis> diff --git a/reference/openssl/functions/openssl-password-hash.xml b/reference/openssl/functions/openssl-password-hash.xml index 652044de6d40..96f33a6b5cdb 100644 --- a/reference/openssl/functions/openssl-password-hash.xml +++ b/reference/openssl/functions/openssl-password-hash.xml @@ -10,7 +10,7 @@ <methodsynopsis> <type>string</type><methodname>openssl_password_hash</methodname> <methodparam><type>string</type><parameter>algo</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>password</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam> </methodsynopsis> <para> diff --git a/reference/openssl/functions/openssl-password-verify.xml b/reference/openssl/functions/openssl-password-verify.xml index d44a41e22dd7..f2c4d61bf4ab 100644 --- a/reference/openssl/functions/openssl-password-verify.xml +++ b/reference/openssl/functions/openssl-password-verify.xml @@ -10,7 +10,7 @@ <methodsynopsis> <type>bool</type><methodname>openssl_password_verify</methodname> <methodparam><type>string</type><parameter>algo</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>password</parameter></methodparam> <methodparam><type>string</type><parameter>hash</parameter></methodparam> </methodsynopsis> <para> diff --git a/reference/openssl/functions/openssl-pkey-free.xml b/reference/openssl/functions/openssl-pkey-free.xml index 6bbf358cd30f..14cf2bfefc47 100644 --- a/reference/openssl/functions/openssl-pkey-free.xml +++ b/reference/openssl/functions/openssl-pkey-free.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as OpenSSLAsymmetricKey objects are freed automatically')]</modifier> <type>void</type><methodname>openssl_pkey_free</methodname> <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam> </methodsynopsis> diff --git a/reference/openssl/functions/openssl-x509-free.xml b/reference/openssl/functions/openssl-x509-free.xml index 340590c99fbb..08999730d831 100644 --- a/reference/openssl/functions/openssl-x509-free.xml +++ b/reference/openssl/functions/openssl-x509-free.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as OpenSSLCertificate objects are freed automatically')]</modifier> <type>void</type><methodname>openssl_x509_free</methodname> <methodparam><type>OpenSSLCertificate</type><parameter>certificate</parameter></methodparam> </methodsynopsis> diff --git a/reference/pgsql/functions/pg-change-password.xml b/reference/pgsql/functions/pg-change-password.xml index 07b11cdf3310..06b18fd49c88 100644 --- a/reference/pgsql/functions/pg-change-password.xml +++ b/reference/pgsql/functions/pg-change-password.xml @@ -11,7 +11,7 @@ <type>bool</type><methodname>pg_change_password</methodname> <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>password</parameter></methodparam> </methodsynopsis> <simpara> <function>pg_change_password</function> changes the password of a diff --git a/reference/random/functions/lcg-value.xml b/reference/random/functions/lcg-value.xml index c267aee749e1..500c46245c8a 100644 --- a/reference/random/functions/lcg-value.xml +++ b/reference/random/functions/lcg-value.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: "use \\Random\\Randomizer::getFloat() instead")]</modifier> <type>float</type><methodname>lcg_value</methodname> <void/> </methodsynopsis> diff --git a/reference/reflection/reflectionfunction/isdisabled.xml b/reference/reflection/reflectionfunction/isdisabled.xml index c1bad04c5e9c..6f8a70c2401f 100644 --- a/reference/reflection/reflectionfunction/isdisabled.xml +++ b/reference/reflection/reflectionfunction/isdisabled.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionFunction"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: "as ReflectionFunction can no longer be constructed for disabled functions")]</modifier> <modifier>public</modifier> <type>bool</type><methodname>ReflectionFunction::isDisabled</methodname> <void/> </methodsynopsis> diff --git a/reference/reflection/reflectionmethod/setaccessible.xml b/reference/reflection/reflectionmethod/setaccessible.xml index f054a456603e..3a6719c28495 100644 --- a/reference/reflection/reflectionmethod/setaccessible.xml +++ b/reference/reflection/reflectionmethod/setaccessible.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionMethod"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.1")]</modifier> <modifier>public</modifier> <type>void</type><methodname>ReflectionMethod::setAccessible</methodname> <methodparam><type>bool</type><parameter>accessible</parameter></methodparam> </methodsynopsis> diff --git a/reference/reflection/reflectionparameter/getclass.xml b/reference/reflection/reflectionparameter/getclass.xml index f65f0ba0f30a..b52583726a32 100644 --- a/reference/reflection/reflectionparameter/getclass.xml +++ b/reference/reflection/reflectionparameter/getclass.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionParameter"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: "use ReflectionParameter::getType() instead")]</modifier> <modifier>public</modifier> <type class="union"><type>ReflectionClass</type><type>null</type></type><methodname>ReflectionParameter::getClass</methodname> <void/> </methodsynopsis> diff --git a/reference/reflection/reflectionparameter/isarray.xml b/reference/reflection/reflectionparameter/isarray.xml index 69cf86ac5178..c0b2c39917ce 100644 --- a/reference/reflection/reflectionparameter/isarray.xml +++ b/reference/reflection/reflectionparameter/isarray.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionParameter"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: "use ReflectionParameter::getType() instead")]</modifier> <modifier>public</modifier> <type>bool</type><methodname>ReflectionParameter::isArray</methodname> <void/> </methodsynopsis> diff --git a/reference/reflection/reflectionparameter/iscallable.xml b/reference/reflection/reflectionparameter/iscallable.xml index d00c4bbc3347..b723bc287929 100644 --- a/reference/reflection/reflectionparameter/iscallable.xml +++ b/reference/reflection/reflectionparameter/iscallable.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionParameter"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: "use ReflectionParameter::getType() instead")]</modifier> <modifier>public</modifier> <type>bool</type><methodname>ReflectionParameter::isCallable</methodname> <void/> </methodsynopsis> diff --git a/reference/reflection/reflectionproperty/setaccessible.xml b/reference/reflection/reflectionproperty/setaccessible.xml index f3d160dc834f..516b800ab2f7 100644 --- a/reference/reflection/reflectionproperty/setaccessible.xml +++ b/reference/reflection/reflectionproperty/setaccessible.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="ReflectionProperty"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.1")]</modifier> <modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::setAccessible</methodname> <methodparam><type>bool</type><parameter>accessible</parameter></methodparam> </methodsynopsis> diff --git a/reference/shmop/functions/shmop-close.xml b/reference/shmop/functions/shmop-close.xml index 3474659e4782..7ab854e91573 100644 --- a/reference/shmop/functions/shmop-close.xml +++ b/reference/shmop/functions/shmop-close.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shmop-close"> +<refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>shmop_close</refname> <refpurpose>Close shared memory block</refpurpose> @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as Shmop objects are freed automatically')]</modifier> <type>void</type><methodname>shmop_close</methodname> <methodparam><type>Shmop</type><parameter>shmop</parameter></methodparam> </methodsynopsis> diff --git a/reference/spl/splfixedarray/wakeup.xml b/reference/spl/splfixedarray/wakeup.xml index 78a4caa40b00..4f8d777bd58e 100644 --- a/reference/spl/splfixedarray/wakeup.xml +++ b/reference/spl/splfixedarray/wakeup.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="SplFixedArray"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier> <modifier>public</modifier> <type>void</type><methodname>SplFixedArray::__wakeup</methodname> <void/> </methodsynopsis> diff --git a/reference/spl/splobjectstorage/attach.xml b/reference/spl/splobjectstorage/attach.xml index 602f6cd8c25f..3cffa77ee379 100644 --- a/reference/spl/splobjectstorage/attach.xml +++ b/reference/spl/splobjectstorage/attach.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="SplObjectStorage"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "use method SplObjectStorage::offsetSet() instead")]</modifier> <modifier>public</modifier> <type>void</type><methodname>SplObjectStorage::attach</methodname> <methodparam><type>object</type><parameter>object</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>info</parameter><initializer>&null;</initializer></methodparam> diff --git a/reference/spl/splobjectstorage/contains.xml b/reference/spl/splobjectstorage/contains.xml index a693ef1a6c6e..1f011f844ee3 100644 --- a/reference/spl/splobjectstorage/contains.xml +++ b/reference/spl/splobjectstorage/contains.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="SplObjectStorage"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "use method SplObjectStorage::offsetExists() instead")]</modifier> <modifier>public</modifier> <type>bool</type><methodname>SplObjectStorage::contains</methodname> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> diff --git a/reference/spl/splobjectstorage/detach.xml b/reference/spl/splobjectstorage/detach.xml index bed7c19a85e1..3916c68f3fff 100644 --- a/reference/spl/splobjectstorage/detach.xml +++ b/reference/spl/splobjectstorage/detach.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis role="SplObjectStorage"> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "use method SplObjectStorage::offsetUnset() instead")]</modifier> <modifier>public</modifier> <type>void</type><methodname>SplObjectStorage::detach</methodname> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> diff --git a/reference/strings/functions/utf8-decode.xml b/reference/strings/functions/utf8-decode.xml index 85463d972715..1ab0594b3ad5 100644 --- a/reference/strings/functions/utf8-decode.xml +++ b/reference/strings/functions/utf8-decode.xml @@ -16,7 +16,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.2', message: 'visit the php.net documentation for various alternatives')]</modifier> <type>string</type><methodname>utf8_decode</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> </methodsynopsis> diff --git a/reference/strings/functions/utf8-encode.xml b/reference/strings/functions/utf8-encode.xml index 23b3188a9bab..1fc13cadf895 100644 --- a/reference/strings/functions/utf8-encode.xml +++ b/reference/strings/functions/utf8-encode.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.2', message: 'visit the php.net documentation for various alternatives')]</modifier> <type>string</type><methodname>utf8_encode</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> </methodsynopsis> diff --git a/reference/uodbc/functions/odbc-result-all.xml b/reference/uodbc/functions/odbc-result-all.xml index 95c0470d6ee1..0414fed67ed8 100644 --- a/reference/uodbc/functions/odbc-result-all.xml +++ b/reference/uodbc/functions/odbc-result-all.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>odbc_result_all</methodname> <methodparam><type>Odbc\Result</type><parameter>statement</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>format</parameter><initializer>""</initializer></methodparam> diff --git a/reference/xml/functions/xml-parser-free.xml b/reference/xml/functions/xml-parser-free.xml index 09d3accc5d1d..1775dd318b8d 100644 --- a/reference/xml/functions/xml-parser-free.xml +++ b/reference/xml/functions/xml-parser-free.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier> <type>bool</type><methodname>xml_parser_free</methodname> <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam> </methodsynopsis> diff --git a/reference/xml/functions/xml-set-object.xml b/reference/xml/functions/xml-set-object.xml index 96fa1c55d57c..76bb18175e3a 100644 --- a/reference/xml/functions/xml-set-object.xml +++ b/reference/xml/functions/xml-set-object.xml @@ -13,7 +13,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'provide a proper method callable to xml_set_*_handler() functions')]</modifier> <type>true</type><methodname>xml_set_object</methodname> <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam> <methodparam><type>object</type><parameter>object</parameter></methodparam> diff --git a/reference/zip/functions/zip-close.xml b/reference/zip/functions/zip-close.xml index 29e69b26dcb0..14aa7e5c5002 100644 --- a/reference/zip/functions/zip-close.xml +++ b/reference/zip/functions/zip-close.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::close() instead')]</modifier> <type>void</type><methodname>zip_close</methodname> <methodparam><type>resource</type><parameter>zip</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-close.xml b/reference/zip/functions/zip-entry-close.xml index 58f58aebf559..f6ad34646836 100644 --- a/reference/zip/functions/zip-entry-close.xml +++ b/reference/zip/functions/zip-entry-close.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier> <type>bool</type><methodname>zip_entry_close</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-compressedsize.xml b/reference/zip/functions/zip-entry-compressedsize.xml index 7a1c0653535d..ad6d36c352e6 100644 --- a/reference/zip/functions/zip-entry-compressedsize.xml +++ b/reference/zip/functions/zip-entry-compressedsize.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::statIndex() instead')]</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_compressedsize</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-compressionmethod.xml b/reference/zip/functions/zip-entry-compressionmethod.xml index a4155d965224..6d4ba990e865 100644 --- a/reference/zip/functions/zip-entry-compressionmethod.xml +++ b/reference/zip/functions/zip-entry-compressionmethod.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::statIndex() instead')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_compressionmethod</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-filesize.xml b/reference/zip/functions/zip-entry-filesize.xml index 901c3dec07cc..a2449c7058ea 100644 --- a/reference/zip/functions/zip-entry-filesize.xml +++ b/reference/zip/functions/zip-entry-filesize.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::statIndex() instead')]</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_filesize</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-name.xml b/reference/zip/functions/zip-entry-name.xml index 9260a265a884..c2a1d62024fb 100644 --- a/reference/zip/functions/zip-entry-name.xml +++ b/reference/zip/functions/zip-entry-name.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::statIndex() instead')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_name</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-entry-open.xml b/reference/zip/functions/zip-entry-open.xml index b608b97c905c..76c209a7f785 100644 --- a/reference/zip/functions/zip-entry-open.xml +++ b/reference/zip/functions/zip-entry-open.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier> <type>bool</type><methodname>zip_entry_open</methodname> <methodparam><type>resource</type><parameter>zip_dp</parameter></methodparam> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> diff --git a/reference/zip/functions/zip-entry-read.xml b/reference/zip/functions/zip-entry-read.xml index d77d3b8de707..1d733fcadfe3 100644 --- a/reference/zip/functions/zip-entry-read.xml +++ b/reference/zip/functions/zip-entry-read.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::getFromIndex() instead')]</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_read</methodname> <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>len</parameter><initializer>1024</initializer></methodparam> diff --git a/reference/zip/functions/zip-open.xml b/reference/zip/functions/zip-open.xml index 80192dad078f..50a07af0a87f 100644 --- a/reference/zip/functions/zip-open.xml +++ b/reference/zip/functions/zip-open.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::open() instead')]</modifier> <type class="union"><type>resource</type><type>int</type><type>false</type></type><methodname>zip_open</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> diff --git a/reference/zip/functions/zip-read.xml b/reference/zip/functions/zip-read.xml index 1ddd70378f78..2f5dc6104a59 100644 --- a/reference/zip/functions/zip-read.xml +++ b/reference/zip/functions/zip-read.xml @@ -14,7 +14,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <modifier role="attribute">#[\Deprecated]</modifier> + <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'use ZipArchive::statIndex() instead')]</modifier> <type class="union"><type>resource</type><type>false</type></type><methodname>zip_read</methodname> <methodparam><type>resource</type><parameter>zip</parameter></methodparam> </methodsynopsis>