Changeset 44978

Timestamp:

03/22/2019 12:36:30 AM (6 years ago)

Author:

SergeyBiryukov

Message:

Plugins: Block plugin activation if it requires a higher version of PHP or WordPress.

Introduce validate_plugin_requirements() for validating a plugin's WordPress and PHP version requirements.

Introduce wp_is_wp_compatible() and wp_is_php_compatible() for checking compatibility with the current WordPress or PHP version.

Props afragen, joyously, DrewAPicture, TimothyBlynJacobs, desrosj, flixos90, SergeyBiryukov.
See #43992.

Location:

trunk/src

Files:

• wp-admin/includes/plugin.php (modified) (3 diffs)
• wp-includes/functions.php (modified) (1 diff)

trunk/src/wp-admin/includes/plugin.php

@@ -598 +598 @@
  *
  * @since 2.5.0
+ * @since 5.2.0 Test for WordPress version and PHP version compatibility.
  *
  * @param string $plugin       Path to the plugin file relative to the plugins directory.
@@ -620 +621 @@
     if ( is_wp_error( $valid ) ) {
         return $valid;
+    }
+
+    $requirements = validate_plugin_requirements( $plugin );
+    if ( is_wp_error( $requirements ) ) {
+        return $requirements;
     }
 
@@ -1059 +1065 @@
     }
     return 0;
+}
+
+/**
+ * Validate the plugin requirements for WP version and PHP version.
+ *
+ * @since 5.2.0
+ *
+ * @param string $plugin Path to the plugin file relative to the plugins directory.
+ * @return true|WP_Error True if requirements are met, WP_Error on failure.
+ */
+function validate_plugin_requirements( $plugin ) {
+    $readme_file = WP_PLUGIN_DIR . '/' . dirname( $plugin ) . '/readme.txt';
+
+    if ( file_exists( $readme_file ) ) {
+        $plugin_data = get_file_data(
+            $readme_file,
+            array(
+                'requires'     => 'Requires at least',
+                'requires_php' => 'Requires PHP',
+            ),
+            'plugin'
+        );
+    } else {
+        return true;
+    }
+
+    $plugin_data['wp_compatible']  = wp_is_wp_compatible( $plugin_data['requires'] );
+    $plugin_data['php_compatible'] = wp_is_php_compatible( $plugin_data['requires_php'] );
+
+    $plugin_data = array_merge( $plugin_data, get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin ) );
+
+    if ( ! $plugin_data['wp_compatible'] && ! $plugin_data['php_compatible'] ) {
+        return new WP_Error( 'plugin_wp_php_incompatible', sprintf(
+            /* translators: %s: plugin name */
+            __( '<strong>Error:</strong> Current WordPress and PHP versions do not meet minimum requirements for %s.' ), $plugin_data['Name'] )
+        );
+    } elseif ( ! $plugin_data['php_compatible'] ) {
+        return new WP_Error( 'plugin_php_incompatible', sprintf(
+            /* translators: %s: plugin name */
+            __( '<strong>Error:</strong> Current PHP version does not meet minimum requirements for %s.' ), $plugin_data['Name'] )
+        );
+    } elseif ( ! $plugin_data['wp_compatible'] ) {
+        return new WP_Error( 'plugin_wp_incompatible', sprintf(
+            /* translators: %s: plugin name */
+            __( '<strong>Error:</strong> Current WordPress version does not meet minimum requirements for %s.' ), $plugin_data['Name'] )
+        );
+    }
+
+    return true;
 }
 

trunk/src/wp-includes/functions.php

@@ -6898 +6898 @@
     echo '</p>';
 }
+
+/**
+ * Checks compatibility with the current WordPress version.
+ *
+ * @since 5.2.0
+ *
+ * @param string $required Minimum required WordPress version.
+ * @return bool True if required version is compatible or empty, false if not.
+ */
+function wp_is_wp_compatible( $required ) {
+    $wp_version = get_bloginfo( 'version' );
+
+    return empty( $required ) || version_compare( $wp_version, $required, '>=' );
+}
+
+/**
+ * Checks compatibility with the current PHP version.
+ *
+ * @since 5.2.0
+ *
+ * @param string $required Minimum required PHP version.
+ * @return bool True if required version is compatible or empty, false if not.
+ */
+function wp_is_php_compatible( $required ) {
+    return empty( $required ) || version_compare( phpversion(), $required, '>=' );
+}