函数文档

xmlrpc_getposttitle()

💡 云策文档标注

概述

xmlrpc_getposttitle() 函数用于从 XML-RPC XML 请求内容中提取文章标题。如果未找到标题元素,则使用全局变量 $post_default_title 的默认值。

关键要点

  • 函数从 XML-RPC XML 内容中解析文章标题,使用正则表达式匹配 <title> 元素。
  • 如果匹配失败,函数返回全局变量 $post_default_title 的值作为默认标题。
  • 函数返回字符串类型的文章标题,主要用于 XML-RPC 服务器处理新文章或编辑文章的场景。

代码示例

function xmlrpc_getposttitle( $content ) {
	global $post_default_title;
	if ( preg_match( '/<title>(.+?)</title>/is', $content, $matchtitle ) ) {
		$post_title = $matchtitle[1];
	} else {
		$post_title = $post_default_title;
	}
	return $post_title;
}

注意事项

  • 函数依赖于全局变量 $post_default_title,确保在使用前已正确定义该变量。
  • 正则表达式匹配区分大小写,但使用 'is' 修饰符使匹配不区分大小写并允许点号匹配换行符。
  • 此函数主要用于内部 XML-RPC 处理,如 wp_xmlrpc_server 类中的 blogger_newPost() 和 blogger_editPost() 方法。

📄 原文内容

Retrieves post title from XML-RPC XML.

Description

If the title element is not found in the XML, the default post title from the $post_default_title global will be used instead.

Parameters

$contentstringrequired
XML-RPC XML Request content.

Return

string Post title.

Source

function xmlrpc_getposttitle( $content ) {
	global $post_default_title;
	if ( preg_match( '/<title>(.+?)</title>/is', $content, $matchtitle ) ) {
		$post_title = $matchtitle[1];
	} else {
		$post_title = $post_default_title;
	}
	return $post_title;
}

Changelog

Version Description
0.71 Introduced.