WordPress at a glance
function is not described

WP_REST_Posts_Controller::check_read_permission() public WP 4.7.0

Checks if a post can be read.

Correctly handles posts with the inherit status.

It's a method of the class: WP_REST_Posts_Controller{}

No Hooks.

Return

true/false. Whether the post can be read.

Usage

$WP_REST_Posts_Controller = new WP_REST_Posts_Controller();
$WP_REST_Posts_Controller->check_read_permission( $post );
$post(WP_Post) (required)
Post object.

Changelog

Since 4.7.0 Introduced.

Code of WP_REST_Posts_Controller::check_read_permission() WP 5.5.1

<?php
public function check_read_permission( $post ) {
	$post_type = get_post_type_object( $post->post_type );
	if ( ! $this->check_is_post_type_allowed( $post_type ) ) {
		return false;
	}

	// Is the post readable?
	if ( 'publish' === $post->post_status || current_user_can( 'read_post', $post->ID ) ) {
		return true;
	}

	$post_status_obj = get_post_status_object( $post->post_status );
	if ( $post_status_obj && $post_status_obj->public ) {
		return true;
	}

	// Can we read the parent if we're inheriting?
	if ( 'inherit' === $post->post_status && $post->post_parent > 0 ) {
		$parent = get_post( $post->post_parent );
		if ( $parent ) {
			return $this->check_read_permission( $parent );
		}
	}

	/*
	 * If there isn't a parent, but the status is set to inherit, assume
	 * it's published (as per get_post_status()).
	 */
	if ( 'inherit' === $post->post_status ) {
		return true;
	}

	return false;
}