rest_get_endpoint_args_for_schema

函式
rest_get_endpoint_args_for_schema ( $schema, $method = WP_REST_Server::CREATABLE )
引數
  • (array) $schema The full JSON schema for the endpoint.
    Required:
  • (string) $method Optional. HTTP method of the endpoint. The arguments for `CREATABLE` endpoints are checked for required values and may fall-back to a given default, this is not done on `EDITABLE` endpoints. Default WP_REST_Server::CREATABLE.
    Required:
    Default: WP_REST_Server::CREATABLE
返回值
  • (array) The endpoint arguments.
定義位置
相關方法
rest_get_route_for_termrest_get_best_type_for_valueget_admin_users_for_domainrest_get_avatar_urlsrest_get_route_for_post
引入
5.6.0
棄用
-

rest_get_endpoint_args_for_schema: 這個函式用於檢索特定模式的端點引數。它接受兩個引數,第一個是需要端點引數的模式,第二個是一個布林值,表示是否在響應中包括模式描述。它返回一個指定模式的端點引數陣列。

從專案模式和端點方法中檢索一個端點引數陣列。

function rest_get_endpoint_args_for_schema( $schema, $method = WP_REST_Server::CREATABLE ) {

	$schema_properties       = ! empty( $schema['properties'] ) ? $schema['properties'] : array();
	$endpoint_args           = array();
	$valid_schema_properties = rest_get_allowed_schema_keywords();
	$valid_schema_properties = array_diff( $valid_schema_properties, array( 'default', 'required' ) );

	foreach ( $schema_properties as $field_id => $params ) {

		// Arguments specified as `readonly` are not allowed to be set.
		if ( ! empty( $params['readonly'] ) ) {
			continue;
		}

		$endpoint_args[ $field_id ] = array(
			'validate_callback' => 'rest_validate_request_arg',
			'sanitize_callback' => 'rest_sanitize_request_arg',
		);

		if ( WP_REST_Server::CREATABLE === $method && isset( $params['default'] ) ) {
			$endpoint_args[ $field_id ]['default'] = $params['default'];
		}

		if ( WP_REST_Server::CREATABLE === $method && ! empty( $params['required'] ) ) {
			$endpoint_args[ $field_id ]['required'] = true;
		}

		foreach ( $valid_schema_properties as $schema_prop ) {
			if ( isset( $params[ $schema_prop ] ) ) {
				$endpoint_args[ $field_id ][ $schema_prop ] = $params[ $schema_prop ];
			}
		}

		// Merge in any options provided by the schema property.
		if ( isset( $params['arg_options'] ) ) {

			// Only use required / default from arg_options on CREATABLE endpoints.
			if ( WP_REST_Server::CREATABLE !== $method ) {
				$params['arg_options'] = array_diff_key(
					$params['arg_options'],
					array(
						'required' => '',
						'default'  => '',
					)
				);
			}

			$endpoint_args[ $field_id ] = array_merge( $endpoint_args[ $field_id ], $params['arg_options'] );
		}
	}

	return $endpoint_args;
}

常見問題

FAQs
檢視更多 >