Changeset 60258

Timestamp:

05/27/2025 03:51:39 PM (5 months ago)

Author:

jorbin

Message:

Plugins: Clarify documentation for when current_action and current_filter can return false.

If current_action or current_filter is called outside of an action/filter, then these functions will return false.

Props debarghyabanerjee, mukesh27, peterwilsoncc, SirLouen.
Fixes #63479.

File:

• trunk/src/wp-includes/plugin.php (modified) (2 diffs)

trunk/src/wp-includes/plugin.php

@@ -360 +360 @@
  * @global string[] $wp_current_filter Stores the list of current filters with the current one last
  *
- * @return string Hook name of the current filter.
+ * @return string|false Hook name of the current filter, false if no filter is running.
  */
 function current_filter() {
@@ -633 +633 @@
  * @since 3.9.0
  *
- * @return string Hook name of the current action.
+ * @return string|false Hook name of the current action, false if no action is running.
  */
 function current_action() {