xmlrpc_pingback_error()
云策文档标注
概述
xmlrpc_pingback_error() 是 WordPress 中一个默认附加到 xmlrpc_pingback_error 钩子的过滤器函数。它处理 Pingback 错误,通常返回通用错误代码,但针对特定错误码 48(表示 Pingback 已注册)会保留原错误。
关键要点
- 这是一个过滤器函数,用于处理 XML-RPC Pingback 错误。
- 当错误码为 48 时,返回原 IXR_Error 对象;否则返回一个代码为 0、消息为空的 IXR_Error 对象。
- 函数在 WordPress 3.5.1 版本中引入。
代码示例
function xmlrpc_pingback_error( $ixr_error ) {
if ( 48 === $ixr_error->code ) {
return $ixr_error;
}
return new IXR_Error( 0, '' );
}注意事项
- 参数 $ixr_error 是必需的 IXR_Error 对象。
- 返回类型为 IXR_Error。
- 相关类:IXR_Error::__construct() 在 wp-includes/IXR/class-IXR-error.php 中定义。
原文内容
Default filter attached to xmlrpc_pingback_error.
Description
Returns a generic pingback error code unless the error code is 48, which reports that the pingback is already registered.
Parameters
$ixr_errorIXR_Errorrequired
Source
function xmlrpc_pingback_error( $ixr_error ) {
if ( 48 === $ixr_error->code ) {
return $ixr_error;
}
return new IXR_Error( 0, '' );
}
Changelog
| Version | Description |
|---|---|
| 3.5.1 | Introduced. |