云策 WordPress 开发者社区

函数文档

graceful_fail()

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

概述

graceful_fail() 是一个已弃用的 WordPress 函数，用于优雅地处理失败情况，现建议使用 wp_die() 替代。

关键要点

  • graceful_fail() 在 WordPress 3.0.0 版本中被弃用，应改用 wp_die() 函数。
  • 该函数通过 _deprecated_function() 标记为弃用，并允许通过过滤器钩子自定义错误消息和模板。
  • 相关函数包括 _deprecated_function() 和 apply_filters()，用于处理弃用通知和过滤器应用。

代码示例

function graceful_fail( $message ) {
    _deprecated_function( __FUNCTION__, '3.0.0', 'wp_die()' );
    $message = apply_filters( 'graceful_fail', $message );
    $message_template = apply_filters( 'graceful_fail_template',
'
Error!
%s
' );
    die( sprintf( $message_template, $message ) );
}

注意事项

在开发中应避免使用此弃用函数，转而使用 wp_die() 以确保代码兼容性和最佳实践。

📄 原文内容

Deprecated functionality to gracefully fail.

Description

See also

Source

function graceful_fail( $message ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'wp_die()' );
	$message = apply_filters( 'graceful_fail', $message );
	$message_template = apply_filters( 'graceful_fail_template',
'
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Error!</title>
<style type="text/css">
img {
	border: 0;
}
body {
line-height: 1.6em; font-family: Georgia, serif; width: 390px; margin: auto;
text-align: center;
}
.message {
	font-size: 22px;
	width: 350px;
	margin: auto;
}
</style>
</head>
<body>
<p class="message">%s</p>
</body>
</html>' );
	die( sprintf( $message_template, $message ) );
}

View all references View on Trac View on GitHub

Uses Description
_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Changelog

Version Description
3.0.0 Deprecated. Use wp_die()
MU (3.0.0) Introduced.