Changeset 61281

Timestamp:

11/23/2025 05:37:23 AM (3 months ago)

Author:

westonruter

Message:

Docs: Explicitly return null when documented instead of void in link-template.php functions.

The phpdoc @return tags for these functions indicate they may return null. This also fixes "Missing return argument" warnings which an IDE may also complain about.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8955

Props justlevine.
See #64238.

File:

• trunk/src/wp-includes/link-template.php (modified) (5 diffs)

trunk/src/wp-includes/link-template.php

@@ -1083 +1083 @@
     $term = get_term( $term, $taxonomy );
     if ( ! $term || is_wp_error( $term ) ) {
-        return;
+        return null;
     }
 
@@ -1089 +1089 @@
     $term_id = $term->term_id;
     if ( ! $tax || ! current_user_can( 'edit_term', $term_id ) ) {
-        return;
+        return null;
     }
 
@@ -1411 +1411 @@
 
     if ( ! $post ) {
-        return;
+        return null;
     }
 
@@ -1455 +1455 @@
 
     if ( ! $post ) {
-        return;
+        return null;
     }
 
@@ -1469 +1469 @@
 
     if ( ! $post_type_object ) {
-        return;
+        return null;
     }
 
     if ( ! current_user_can( 'edit_post', $post->ID ) ) {
-        return;
+        return null;
     }