Ticket #45686: 45686.diff

src/wp-admin/includes/dashboard.php

@@ -1609 +1609 @@
 }
 
 /**
- * Displays the PHP upgrade nag.
+ * Displays the PHP update nag.
  *
- * @since 5.0.0
+ * @since 5.1.0
  */
 function wp_dashboard_php_nag() {
         $response = wp_check_php_version();
@@ -1636 +1636 @@
                 <?php
                         printf(
                                 '<a class="button button-primary" href="%1$s" target="_blank" rel="noopener noreferrer">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',
-                                esc_url( _x( 'https://wordpress.org/support/upgrade-php/', 'localized PHP upgrade information page' ) ),
+                                esc_url( wp_get_update_php_url() ),
                                 __( 'Learn more about updating PHP' ),
                                 /* translators: accessibility text */
                                 __( '(opens in a new tab)' )
@@ -1649 +1649 @@
 /**
  * Adds an additional class to the PHP nag if the current version is insecure.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param array $classes Metabox classes.
  * @return array Modified metabox classes.
@@ -1665 +1665 @@
 }
 
 /**
- * Checks if the user needs to upgrade PHP.
+ * Checks if the user needs to update PHP.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @return array|false $response Array of PHP version data. False on failure.
  */

src/wp-includes/functions.php

@@ -6519 +6519 @@
                 }
         }
 }
+
+/**
+ * Gets the URL to learn more about updating the PHP version the site is running on.
+ *
+ * This URL can be overridden by specifying an environment variable `WP_UPDATE_PHP_URL` or by using the
+ * {@see 'wp_update_php_url'} filter. Providing an empty string is not allowed and will result in the
+ * default URL being used. Furthermore the page the URL links to should preferably be localized in the
+ * site language.
+ *
+ * @since 5.1.0
+ *
+ * @return string URL to learn more about updating PHP.
+ */
+function wp_get_update_php_url() {
+        $default_url = _x( 'https://wordpress.org/support/update-php/', 'localized PHP upgrade information page' );
+
+        $update_url = $default_url;
+        if ( false !== getenv( 'WP_UPDATE_PHP_URL' ) ) {
+                $update_url = getenv( 'WP_UPDATE_PHP_URL' );
+        }
+
+        /**
+         * Filters the URL to learn more about updating the PHP version the site is running on.
+         *
+         * Providing an empty string is not allowed and will result in the default URL being used. Furthermore
+         * the page the URL links to should preferably be localized in the site language.
+         *
+         * @since 5.1.0
+         *
+         * @param string $update_url URL to learn more about updating PHP.
+         */
+        $update_url = apply_filters( 'wp_update_php_url', $update_url );
+
+        if ( empty( $update_url ) ) {
+                $update_url = $default_url;
+        }
+
+        return $update_url;
+}