trackback_response()
云策文档标注
概述
trackback_response() 函数用于响应 trackback 请求,根据错误状态输出 XML 消息。它设置内容类型为 XML,并根据参数决定返回成功或错误响应。
关键要点
- 函数 trackback_response() 处理 trackback 响应,输出 XML 格式消息。
- 参数 $error 控制是否错误,接受整数或布尔值,默认 '0'。
- 参数 $error_message 为错误消息字符串,默认空字符串。
- 函数内部使用 header() 设置 Content-Type,并根据 $error 值输出不同 XML 结构。
- 相关函数 get_option() 用于获取博客字符集设置。
代码示例
function trackback_response( $error = 0, $error_message = '' ) {
header( 'Content-Type: text/xml; charset=' . get_option( 'blog_charset' ) );
if ( $error ) {
echo '<?xml version="1.0" encoding="' . get_option( 'blog_charset' ) . '"?>
';
echo "<response>
";
echo "<error>1</error>
";
echo "<message>$error_message</message>
";
echo '</response>';
die();
} else {
echo '<?xml version="1.0" encoding="' . get_option( 'blog_charset' ) . '"?>
';
echo "<response>
";
echo "<error>0</error>
";
echo '</response>';
}
}注意事项
- 函数在 WordPress 0.71 版本引入,用于 trackback 协议响应。
- 错误时输出 XML 包含
1 和标签,成功时输出 0 。 - 使用 die() 在错误响应后终止脚本执行。
原文内容
Response to a trackback.
Description
Responds with an error or success XML message.
Parameters
$errorint|boolrequired-
Whether there was an error.
Default'0'. Accepts'0'or'1', true or false. $error_messagestringrequired-
Error message if an error occurred. Default empty string.
Source
function trackback_response( $error = 0, $error_message = '' ) {
header( 'Content-Type: text/xml; charset=' . get_option( 'blog_charset' ) );
if ( $error ) {
echo 'n";
echo "<response>n";
echo "<error>1</error>n";
echo "<message>$error_message</message>n";
echo '</response>';
die();
} else {
echo 'n";
echo "<response>n";
echo "<error>0</error>n";
echo '</response>';
}
}
Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |