Changeset 34059 for trunk/src/wp-includes/functions.php

Timestamp:

09/11/2015 09:07:45 PM (9 years ago)

Author:

wonderboymusic

Message:

Introduce wp_validate_action( $action = '' ), a helper function that checks $_REQUEST for action and returns it, or empty string if not present. If $action is passed, it checks to make sure they match before returning it, or an empty string. Strings are always returned to avoid returning multiple types.

Implementing this removes 27 uses of direct superglobal access in the admin.

For more reading:
​https://codeclimate.com/github/WordPress/WordPress/wp-admin/edit-comments.php

See #33837.

File:

• trunk/src/wp-includes/functions.php (modified) (1 diff)

trunk/src/wp-includes/functions.php

@@ -4981 +4981 @@
     <?php
 }
+
+/**
+ * Retrieve and, optionally, validate, an `action` query var
+ *
+ * @since 4.4.0
+ *
+ * @param string $action Optional. Action to validate.
+ * @return string Empty string if there is no action in the request or it doesn't
+ *                match the passed `$action`. Returns the [passed `$action` or
+ *                request action on succcess.
+ */
+function wp_validate_action( $action = '' ) {
+    $r = $_REQUEST;
+    if ( ! isset( $r['action'] ) ) {
+        return '';
+    }
+
+    if ( ! empty( $action ) ) {
+        return $action === $r['action'] ? $action : '';
+    }
+
+    return $r['action'];
+}