xmlrpc_removepostdata()
云策文档标注
概述
xmlrpc_removepostdata() 是一个 WordPress 函数，用于从 XML-RPC XML 请求内容中移除标题和分类元素。它通过正则表达式处理输入字符串，返回清理后的内容。
关键要点
- 函数参数：$content（字符串，必需），表示 XML-RPC XML 请求内容。
- 返回值：字符串，移除标题和分类元素后的 XML-RPC XML 请求内容。
- 内部实现：使用 preg_replace() 正则表达式移除
和 <category> 标签及其内容，然后使用 trim() 清理空白。</li><li>相关用途：在 wp_xmlrpc_server 类的 blogger_newPost() 和 blogger_editPost() 方法中使用，用于创建和编辑帖子。</li><li>版本历史：自 WordPress 0.71 版本引入。</li></ul><h2>代码示例</h2><pre class="hljs language-php"><code class="hljs language-php"><span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">xmlrpc_removepostdata</span><span class="hljs-params">( $content )</span> </span>{ $content = preg_replace( <span class="hljs-string">'/(<title>.+?</title>)/si'</span>, <span class="hljs-string">''</span>, $content ); $content = preg_replace( <span class="hljs-string">'/(<category>.+?</category>)/si'</span>, <span class="hljs-string">''</span>, $content ); $content = trim( $content ); <span class="hljs-keyword">return</span> $content; }</code></pre> </div> </section> <hr class="doc-separator"> <section class="original-content"> <div class="original-header"> <span class="original-icon">📄</span> <span class="original-label">原文内容</span> </div> <div class="original-body"> <section class="wp-block-wporg-code-reference-summary"> <p>XML-RPC XML content without title and category elements.</p> </section> <section class="wp-block-wporg-code-reference-parameters"> <h2 id="parameters" class="is-toc-heading wp-block-heading has-heading-5-font-size"><a href="#parameters">Parameters</a></h2> <dl> <dt><code class="hljs language-php">$content</code><span class="type"><span class="string">string</span></span><span class="required">required</span></dt> <dd> <div class="desc"><span class="description">XML-RPC XML Request content.</span></div> </dd> </dl> </section> <section class="wporg-has-embedded-code wp-block-wporg-code-reference-return-value"> <h2 id="return" class="is-toc-heading wp-block-heading has-heading-5-font-size"><a href="#return">Return</a></h2> <p> <span class='return-type'>string</span> XML-RPC XML Request content without title and category elements.</section> <section class="wp-block-wporg-code-reference-source"> <h2 id="source" class="is-toc-heading wp-block-heading has-heading-5-font-size"><a href="#source">Source</a></h2> <pre class="wp-block-code hljs language-php"><code class="wp-block-code hljs language-php"><span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">xmlrpc_removepostdata</span><span class="hljs-params">( $content )</span> </span>{ $content = preg_replace( <span class="hljs-string">'/<title>(.+?)</title>/si'</span>, <span class="hljs-string">''</span>, $content ); $content = preg_replace( <span class="hljs-string">'/<category>(.+?)</category>/si'</span>, <span class="hljs-string">''</span>, $content ); $content = trim( $content ); <span class="hljs-keyword">return</span> $content; } </code></pre> <p class="wporg-dot-link-list"><a href="https://developer.wordpress.org/reference/files/wp-includes/functions.php/">View all references</a> <a href="https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/functions.php#L820">View on Trac</a> <a href="https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/functions.php#L820-L825">View on GitHub</a></p> </section> <section class="wp-block-wporg-code-reference-related" data-nosnippet="true"> <h2 id="related" class="is-toc-heading wp-block-heading has-heading-5-font-size"><a href="#related">Related</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table" id="used-by"> <figure class="wp-block-table "> <table> <thead> <tr> <th scope="col">Used by</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr class=""> <td><a href="https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/blogger_newpost/">wp_xmlrpc_server::blogger_newPost()</a><code class="hljs language-javascript">wp-includes/<span class="hljs-class"><span class="hljs-keyword">class</span>-<span class="hljs-title">wp</span>-<span class="hljs-title">xmlrpc</span>-<span class="hljs-title">server</span>.<span class="hljs-title">php</span></span></code></td> <td> <p>Creates a new post.</p> </td> </tr> <tr class=""> <td><a href="https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/blogger_editpost/">wp_xmlrpc_server::blogger_editPost()</a><code class="hljs language-javascript">wp-includes/<span class="hljs-class"><span class="hljs-keyword">class</span>-<span class="hljs-title">wp</span>-<span class="hljs-title">xmlrpc</span>-<span class="hljs-title">server</span>.<span class="hljs-title">php</span></span></code></td> <td> <p>Edits a post.</p> </td> </tr> </tbody> </table> </figure> </section> </section> <section class="wp-block-wporg-code-reference-changelog"> <h2 id="changelog" class="is-toc-heading wp-block-heading has-heading-5-font-size"><a href="#changelog">Changelog</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table"> <figure class="wp-block-table "> <table> <thead> <tr> <th scope="col">Version</th> <th scope="col">Description</th> </tr> </thead> <tbody> <tr class=""> <td><a href="https://developer.wordpress.org/reference/since/0.71/">0.71</a></td> <td>Introduced.</td> </tr> </tbody> </table> </figure> </section> </section> </div> </section> </article> </div> <footer class="site-footer"> <div class="container"> <div class="footer-content"> <div class="footer-info"> <p>© 2026 云策 WordPress 开发者社区（WordPress中文社区）</p> </div> <div class="footer-links"> <ul id="menu-%e5%ba%95%e9%83%a8%e8%8f%9c%e5%8d%95" class="footer-menu"><li id="menu-item-7870" class="menu-item menu-item-type-custom menu-item-object-custom menu-item-7870"><a target="_blank" href="https://www.yun-wp.com/">云策 WordPress 建站</a></li> <li id="menu-item-7871" class="menu-item menu-item-type-custom menu-item-object-custom menu-item-7871"><a target="_blank" href="https://cn.wordpress.org/">WordPress 中国</a></li> <li id="menu-item-7872" class="menu-item menu-item-type-custom menu-item-object-custom menu-item-7872"><a target="_blank" href="https://developer.wordpress.org/">WordPress官方社区</a></li> <li id="menu-item-7866" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-privacy-policy menu-item-7866"><a target="_self" rel="privacy-policy" href="https://developer.yun-wp.com/privacy-policy/">站点声明</a></li> </ul> </div> </div> </div> </footer> <script type="speculationrules"> {"prefetch":[{"source":"document","where":{"and":[{"href_matches":"/*"},{"not":{"href_matches":["/wp-*.php","/wp-admin/*","/wp-content/uploads/*","/wp-content/*","/wp-content/plugins/*","/wp-content/themes/wp-dev-docs/*","/*\\?(.+)"]}},{"not":{"selector_matches":"a[rel~=\"nofollow\"]"}},{"not":{"selector_matches":".no-prefetch, .no-prefetch a"}}]},"eagerness":"conservative"}]} </script> <script type="text/javascript" src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/highlight.min.js?ver=11.9.0" id="highlightjs-js"></script> <script type="text/javascript" src="https://developer.yun-wp.com/wp-content/themes/wp-dev-docs/assets/js/main.js?ver=1.0.0" id="wp-dev-docs-script-js"></script> <script id="wp-emoji-settings" type="application/json"> {"baseUrl":"https://s.w.org/images/core/emoji/17.0.2/72x72/","ext":".png","svgUrl":"https://s.w.org/images/core/emoji/17.0.2/svg/","svgExt":".svg","source":{"concatemoji":"https://developer.yun-wp.com/wp-includes/js/wp-emoji-release.min.js?ver=6.9.4"}} </script> <script type="module"> /* <![CDATA[ */ /*! This file is auto-generated */ const a=JSON.parse(document.getElementById("wp-emoji-settings").textContent),o=(window._wpemojiSettings=a,"wpEmojiSettingsSupports"),s=["flag","emoji"];function i(e){try{var t={supportTests:e,timestamp:(new Date).valueOf()};sessionStorage.setItem(o,JSON.stringify(t))}catch(e){}}function c(e,t,n){e.clearRect(0,0,e.canvas.width,e.canvas.height),e.fillText(t,0,0);t=new Uint32Array(e.getImageData(0,0,e.canvas.width,e.canvas.height).data);e.clearRect(0,0,e.canvas.width,e.canvas.height),e.fillText(n,0,0);const a=new Uint32Array(e.getImageData(0,0,e.canvas.width,e.canvas.height).data);return t.every((e,t)=>e===a[t])}function p(e,t){e.clearRect(0,0,e.canvas.width,e.canvas.height),e.fillText(t,0,0);var n=e.getImageData(16,16,1,1);for(let e=0;e<n.data.length;e++)if(0!==n.data[e])return!1;return!0}function u(e,t,n,a){switch(t){case"flag":return n(e,"\ud83c\udff3\ufe0f\u200d\u26a7\ufe0f","\ud83c\udff3\ufe0f\u200b\u26a7\ufe0f")?!1:!n(e,"\ud83c\udde8\ud83c\uddf6","\ud83c\udde8\u200b\ud83c\uddf6")&&!n(e,"\ud83c\udff4\udb40\udc67\udb40\udc62\udb40\udc65\udb40\udc6e\udb40\udc67\udb40\udc7f","\ud83c\udff4\u200b\udb40\udc67\u200b\udb40\udc62\u200b\udb40\udc65\u200b\udb40\udc6e\u200b\udb40\udc67\u200b\udb40\udc7f");case"emoji":return!a(e,"\ud83e\u1fac8")}return!1}function f(e,t,n,a){let r;const o=(r="undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?new OffscreenCanvas(300,150):document.createElement("canvas")).getContext("2d",{willReadFrequently:!0}),s=(o.textBaseline="top",o.font="600 32px Arial",{});return e.forEach(e=>{s[e]=t(o,e,n,a)}),s}function r(e){var t=document.createElement("script");t.src=e,t.defer=!0,document.head.appendChild(t)}a.supports={everything:!0,everythingExceptFlag:!0},new Promise(t=>{let n=function(){try{var e=JSON.parse(sessionStorage.getItem(o));if("object"==typeof e&&"number"==typeof e.timestamp&&(new Date).valueOf()<e.timestamp+604800&&"object"==typeof e.supportTests)return e.supportTests}catch(e){}return null}();if(!n){if("undefined"!=typeof Worker&&"undefined"!=typeof OffscreenCanvas&&"undefined"!=typeof URL&&URL.createObjectURL&&"undefined"!=typeof Blob)try{var e="postMessage("+f.toString()+"("+[JSON.stringify(s),u.toString(),c.toString(),p.toString()].join(",")+"));",a=new Blob([e],{type:"text/javascript"});const r=new Worker(URL.createObjectURL(a),{name:"wpTestEmojiSupports"});return void(r.onmessage=e=>{i(n=e.data),r.terminate(),t(n)})}catch(e){}i(n=f(s,u,c,p))}t(n)}).then(e=>{for(const n in e)a.supports[n]=e[n],a.supports.everything=a.supports.everything&&a.supports[n],"flag"!==n&&(a.supports.everythingExceptFlag=a.supports.everythingExceptFlag&&a.supports[n]);var t;a.supports.everythingExceptFlag=a.supports.everythingExceptFlag&&!a.supports.flag,a.supports.everything||((t=a.source||{}).concatemoji?r(t.concatemoji):t.wpemoji&&t.twemoji&&(r(t.twemoji),r(t.wpemoji)))}); //# sourceURL=https://developer.yun-wp.com/wp-includes/js/wp-emoji-loader.min.js /* ]]> */ </script> </body> </html>