Pass option name to pre_option_OPTION and pre_update_option_OPTION filters

[Viper007Bond]

If you want to hook a common callback function onto multiple pre_option_OPTION or pre_update_option_OPTION filters, you have to parse current_filter() to get what option is currently being modified. Instead we could just pass $option as another parameter.

[Viper007Bond]

Hmm, PhpStorm injected some stuff into the top of the patch file. Sorry about that.

[SergeyBiryukov]

28402.2.patch​ is a (probably overzealous) attempt to do this for other option filters.

[MikeHansenMe]

Refresh based on Sergey's patch and tried to make code sniffer happy

[MikeHansenMe]

28402.4.diff​ is a refresh of .3.diff since it would not apply cleanly.

[wonderboymusic]

In 33738:

Pass option name to option and transient filters with dynamic names.

Props Viper007Bond, SergeyBiryukov, MikeHansenMe.
Fixes #28402.

[SergeyBiryukov]

I guess we'll need @since 4.4.0 Added ... parameter. docs for each hook.

[DrewAPicture]

In 33768:

Docs: Add a changelog entry to the pre_option_$option hook doc for the $option parameter, added in [33738].

See #28402

[DrewAPicture]

In 33778:

Docs: Add a changelog entry to the default_option_$option hook doc for the $option parameter, added in [33738].

See #28402

[DrewAPicture]

In 33779:

Docs: Add a changelog entry to the option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33780:

Docs: Add a changelog entry to the pre_update_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33781:

Docs: Add a changelog entry to the update_option_{$option} hook doc for the $option parameter, introduced in [33738].

See #28402.

[DrewAPicture]

In 33782:

Docs: Add a changelog entry to the pre_transient_$transient hook doc for the $transient parameter, introduced in [33738].

See #28402.

[DrewAPicture]

In 33783:

Docs: Add a changelog entry to the transient_$transient hook doc for the $transient parameter, introduced in [33738].

See #28402.

[DrewAPicture]

In 33784:

Docs: Add a changelog entry to the pre_set_transient_$transient hook doc for the $transient parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33785:

Docs: Add a changelog entry to the pre_site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33786:

Docs: Add a changelog entry to the default_site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33787:

Docs: Add a changelog entry to the site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33788:

Docs: Add a changelog entry to the pre_add_site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33789:

Docs: Add a changelog entry to the pre_delete_site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33790:

Docs: Add a changelog entry to the pre_update_site_option_$option hook doc for the $option parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33791:

Docs: Add a changelog entry to the pre_site_transient_$transient hook doc for the $transient parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33792:

Docs: Add a changelog entry to the site_transient_$transient hook doc for the $transient parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33793:

Docs: Add a changelog entry to the pre_set_site_transient_$transient hook doc for the $transient parameter, added in [33738].

See #28402.

[DrewAPicture]

In 33794:

Docs: Add a changelog entry to the set_site_transient_$transient hook doc for the $transient parameter, added in [33738].

Fixes #28402.

[westonruter]

In 62933:

XML-RPC: Pass the missing args to the enable_xmlrpc filters.

The option_{$option} filter has documented an $option parameter since 4.4.0, when r33738 added it, and pre_option_{$option} has documented both $option and, since 4.9.0, $default_value, added in r41013. However, WP_XMLRPC_Server::set_is_enabled() applies the enable_xmlrpc instances of these filters directly, in order to respect callbacks left over from before the option was deprecated in 3.5.0, and those calls were left passing only the value. A callback declaring the later parameters therefore raised an ArgumentCountError here, even though the very same callback works when the filter is reached through get_option().

The option name and the default are passed explicitly, since there is no $option variable in scope. The default matches what the filter would receive from get_option( 'enable_xmlrpc', false ).

Also add the standard reference comments pointing at the canonical docblocks in wp-includes/option.php.

These call sites were surfaced by the PHPStan extensions under development for this ticket, which are committed separately.

Developed as subset of ​https://github.com/WordPress/wordpress-develop/pull/12022.
Follow-up to r21804, r33738, r41013.

See #65376, #28402, #41254.