WordPress 5.4 对REST API 的更改

Posts Controller现在支持分类法“OR”关系

查询/wp/v2/posts?tags=1&categories=2返回了分配了ID为1的标签，并且分配了ID为2的分类下的所有文章。自WordPress 4.7以来，Posts Controller一直只支持这种AND关系（必须同时满足多个分类法的分类关系。

REST API /wp/v2/posts端点以及从扩展过来的自定义文章类型端点WP_REST_Posts_Controller（包括指定的自定义文章类型"show_in_rest" => true）现在支持一个新参数tax_relation，该参数可用于返回与任一分类过滤器（而不是两者）匹配的文章，也就是“或者（ OR ）” 关系。

例如，在WordPress 5.4中，posts端点查询

/wp/v2/posts?tags=1&categories=2&tax_relation=OR

现在将返回标签ID为 1 或与分类ID为 2的所有文章。

选择性链接嵌入

REST API现在支持使用_embed参数返回有限的一组嵌入式对象。例如，在WordPress 5.4中，以下查询仅嵌入作者信息，而不包括所有评论，媒体等。

/wp/v2/posts/?_embed=author

如果_embed省略参数值或将其设置为true或 1 ，则将返回所有嵌入。

WP_REST_Server方法更改

WordPress 5.4更改了WP_REST_Server类中两个方法的签名。扩展WP_REST_Server和覆盖这些方法的开发人员应更新其代码以匹配新的签名，以避免出现PHP警告。

1. WP_REST_Server::embed_links()的签名现在为embed_links( $data, $embed = true )。新参数$embed接受链接关系（例如array( 'author', 'wp:term' )）的数组，并在响应这些关系时限制嵌入的链接。默认设置为true将保留以前在响应中嵌入所有链接的行为。有关更多详细信息，请参见＃39696。
2. WP_REST_Server::get_routes()的签名现在为get_routes( $namespace = '' )。新参数$namespace接受一个字符串，并将返回的路由限制为名称空间与该字符串匹配的路由。在内部，WP_REST_Server使用此新参数来提高性能，WP_REST_Server::dispatch()方法是减少将请求与注册路由相匹配所需的正则表达式检查次数。有关更多详细信息，请参见＃48530。

出于性能原因，WP_REST_Server::embed_links()现在还将响应数据缓存在内存中。此缓存由WP_REST_Server::response_to_data()管理。直接调用被保护embed_links方法的代码可能需要更新，以确保不返回旧的数据。