云策 WordPress 开发者社区

函数文档

wp_dashboard_php_nag()

查看官方原文 ↗
💡 云策文档标注

概述

wp_dashboard_php_nag() 函数用于在 WordPress 仪表板中显示 PHP 版本更新提醒。它通过检查 PHP 版本状态，根据安全更新支持和未来 WordPress 最低要求，生成相应的警告消息。

关键要点

  • 函数调用 wp_check_php_version() 来获取 PHP 版本状态信息。
  • 根据响应中的 is_secure 和 is_lower_than_future_minimum 键值，动态生成不同级别的警告消息。
  • 输出包含一个链接到更新 PHP 相关信息的 URL，使用 esc_url() 进行安全处理。
  • 该函数在 WordPress 5.1.0 版本中引入。

代码示例

function wp_dashboard_php_nag() {
    $response = wp_check_php_version();

    if ( ! $response ) {
        return;
    }

    if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {
        // The `is_secure` array key name doesn't actually imply this is a secure version of PHP. It only means it receives security updates.

        if ( $response['is_lower_than_future_minimum'] ) {
            $message = sprintf(
                /* translators: %s: The server PHP version. */
                __( 'Your site is running on an outdated version of PHP (%s), which does not receive security updates and soon will not be supported by WordPress. Ensure that PHP is updated on your server as soon as possible. Otherwise you will not be able to upgrade WordPress.' ),
                PHP_VERSION
            );
        } else {
            $message = sprintf(
                /* translators: %s: The server PHP version. */
                __( 'Your site is running on an outdated version of PHP (%s), which does not receive security updates. It should be updated.' ),
                PHP_VERSION
            );
        }
    } elseif ( $response['is_lower_than_future_minimum'] ) {
        $message = sprintf(
            /* translators: %s: The server PHP version. */
            __( 'Your site is running on an outdated version of PHP (%s), which soon will not be supported by WordPress. Ensure that PHP is updated on your server as soon as possible. Otherwise you will not be able to upgrade WordPress.' ),
            PHP_VERSION
        );
    } else {
        $message = sprintf(
            /* translators: %s: The server PHP version. */
            __( 'Your site is running on an outdated version of PHP (%s), which should be updated.' ),
            PHP_VERSION
        );
    }
    ?>
    <p><?php echo $message; ?></p>
    <p><a href="<?php echo esc_url( wp_get_update_php_url() ); ?>"><?php _e( 'Learn more about updating PHP' ); ?> <span class="screen-reader-text"><?php /* translators: Hidden accessibility text. */ _e( '(opens in a new tab)' ); ?></span></a></p>
    <?php
}

注意事项

  • is_secure 键仅表示 PHP 版本是否接收安全更新，而非版本本身是否安全。
  • 消息使用 __() 进行国际化处理，确保可翻译。
  • 链接 URL 通过 esc_url() 清理以防止安全漏洞。
📄 原文内容

Displays the PHP update nag.

Source

function wp_dashboard_php_nag() {

	$response = wp_check_php_version();


	if ( ! $response ) {

		return;

	}


	if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {

		// The `is_secure` array key name doesn't actually imply this is a secure version of PHP. It only means it receives security updates.


		if ( $response['is_lower_than_future_minimum'] ) {

			$message = sprintf(

				/* translators: %s: The server PHP version. */

				__( 'Your site is running on an outdated version of PHP (%s), which does not receive security updates and soon will not be supported by WordPress. Ensure that PHP is updated on your server as soon as possible. Otherwise you will not be able to upgrade WordPress.' ),

				PHP_VERSION

			);

		} else {

			$message = sprintf(

				/* translators: %s: The server PHP version. */

				__( 'Your site is running on an outdated version of PHP (%s), which does not receive security updates. It should be updated.' ),

				PHP_VERSION

			);

		}

	} elseif ( $response['is_lower_than_future_minimum'] ) {

		$message = sprintf(

			/* translators: %s: The server PHP version. */

			__( 'Your site is running on an outdated version of PHP (%s), which soon will not be supported by WordPress. Ensure that PHP is updated on your server as soon as possible. Otherwise you will not be able to upgrade WordPress.' ),

			PHP_VERSION

		);

	} else {

		$message = sprintf(

			/* translators: %s: The server PHP version. */

			__( 'Your site is running on an outdated version of PHP (%s), which should be updated.' ),

			PHP_VERSION

		);

	}

	?>

	<p class="bigger-bolder-text"></p>


	<p></p>

	<p>


	</p>


	<p class="button-container">

		%2$s<span class="screen-reader-text"> %3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',

			esc_url( wp_get_update_php_url() ),

			__( 'Learn more about updating PHP' ),

			/* translators: Hidden accessibility text. */

			__( '(opens in a new tab)' )

		);

		?>

	</p>

	</pre><p class="wporg-dot-link-list"><a href="https://developer.wordpress.org/reference/files/wp-admin/includes/dashboard.php/">View all references</a> <a href="https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/includes/dashboard.php#L1863">View on Trac</a> <a href="https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/includes/dashboard.php#L1863-L1931">View on GitHub</a></p></section>


		<section class="wp-block-wporg-code-reference-related" data-nosnippet="true"><h2 id="related" class="is-toc-heading wp-block-heading has-heading-5-font-size" tabindex="-1" ><a href="#related">Related</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table" id="uses"><figure class="wp-block-table "><table><thead><tr><th scope="col">Uses</th><th scope="col">Description</th></tr></thead><tbody><tr class=""><td><a href="https://developer.wordpress.org/reference/functions/wp_direct_php_update_button/">wp_direct_php_update_button()</a><code>wp-includes/functions.php


Displays a button directly linking to a PHP update process.




wp_get_update_php_url()wp-includes/functions.php


Gets the URL to learn more about updating the PHP version the site is running on.




wp_update_php_annotation()wp-includes/functions.php


Prints the default annotation for the web host altering the “Update PHP” page URL.




wp_check_php_version()wp-admin/includes/misc.php


Checks if the user needs to update PHP.




__()wp-includes/l10n.php


Retrieves the translation of $text.




_e()wp-includes/l10n.php


Displays translated text.




esc_url()wp-includes/formatting.php


Checks and cleans a URL.







Show 3 moreShow less

Changelog

Version Description
5.1.0 Introduced.