Changeset 44789

Timestamp:

03/04/2019 09:22:30 PM (6 years ago)

Author:

flixos90

Message:

General: Introduce wp_is_php_version_acceptable filter to make the check for triggering PHP version warnings stricter.

The filter is only run if the wordpress.org API considers the PHP version acceptable. This ensures that other plugins or hosting providers can only make this check stricter, but not loosen it.

Merges [44788] to the 5.1 branch.

Props j-falk, mikeschroder.
Fixes #46065.

Location:

branches/5.1

Files:

• . (modified) (1 prop)
• src/wp-admin/includes/misc.php (modified) (2 diffs)

branches/5.1/src/wp-admin/includes/misc.php

@@ -2017 +2017 @@
  *
  * @since 5.1.0
+ * @since 5.1.1 Added the {@see 'wp_is_php_version_acceptable'} filter.
  *
  * @return array|false $response Array of PHP version data. False on failure.
@@ -2055 +2056 @@
     }
 
+    if ( isset( $response['is_acceptable'] ) && $response['is_acceptable'] ) {
+        /**
+         * Filters whether the active PHP version is considered acceptable by WordPress.
+         *
+         * Returning false will trigger a PHP version warning to show up in the admin dashboard to administrators.
+         *
+         * This filter is only run if the wordpress.org Serve Happy API considers the PHP version acceptable, ensuring
+         * that this filter can only make this check stricter, but not loosen it.
+         *
+         * @since 5.1.1
+         *
+         * @param bool   $is_acceptable Whether the PHP version is considered acceptable. Default true.
+         * @param string $version       PHP version checked.
+         */
+        $response['is_acceptable'] = (bool) apply_filters( 'wp_is_php_version_acceptable', true, $version );
+    }
+
     return $response;
 }