函数文档

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.