wpseek.com
WordPress开发者和主题制作者的搜索引擎
rest_filter_response_fields › WordPress Function
Since4.8.0
已弃用n/a
› rest_filter_response_fields ( $response, $server, $request )
| 参数: (3) |
|
| 返回: |
|
| 定义在: |
|
| 文档: | |
| Change Log: |
|
Filters the REST API response to include only an allow-listed set of response object fields.
源码
function rest_filter_response_fields( $response, $server, $request ) {
if ( ! isset( $request['_fields'] ) || $response->is_error() ) {
return $response;
}
$processing = $response->get_data_processing();
if ( ! $processing['fields'] ) {
return $response;
}
$data = $response->get_data();
// Only arrays have fields to filter.
if ( ! is_array( $data ) ) {
return $response;
}
$fields = wp_parse_list( $request['_fields'] );
if ( 0 === count( $fields ) ) {
return $response;
}
// Trim off outside whitespace from the comma delimited list.
$fields = array_map( 'trim', $fields );
// Create nested array of accepted field hierarchy.
/** @var array<string, mixed> $fields_as_keyed */
$fields_as_keyed = array();
foreach ( $fields as $field ) {
$parts = explode( '.', $field );
$ref = &$fields_as_keyed;
while ( count( $parts ) > 1 ) {
$next = array_shift( $parts );
if ( isset( $ref[ $next ] ) && true === $ref[ $next ] ) {
// Skip any sub-properties if their parent prop is already marked for inclusion.
break 2;
}
$ref[ $next ] ??= array();
$ref = &$ref[ $next ];
}
$last = array_shift( $parts );
$ref[ $last ] = true;
}
if ( wp_is_numeric_array( $data ) ) {
$new_data = array();
foreach ( $data as $item ) {
$new_data[] = is_array( $item ) ? _rest_array_intersect_key_recursive( $item, $fields_as_keyed ) : $item;
}
} else {
$new_data = _rest_array_intersect_key_recursive( $data, $fields_as_keyed );
}
$response->set_data( $new_data );
return $response;
}