php/WP_CLI/Dispatcher/CommandFactory.php
private static function get_doc_comment( $reflection ) {
		$doc_comment = $reflection->getDocComment();

		if ( false !== $doc_comment || ! ( ini_get( 'opcache.enable_cli' ) && ! ini_get( 'opcache.save_comments' ) ) ) {
			// Either have doc comment, or no doc comment and save comments enabled - standard situation.
			if ( ! getenv( 'WP_CLI_TEST_GET_DOC_COMMENT' ) ) {
				return $doc_comment;
			}
		}

		$filename = $reflection->getFileName();

		if ( isset( self::$file_contents[ $filename ] ) ) {
			$contents = self::$file_contents[ $filename ];
		} elseif ( is_readable( $filename ) ) {
			$contents = file_get_contents( $filename );
			if ( is_string( $contents ) && '' !== $contents ) {
				$contents                         = explode( "\n", $contents );
				self::$file_contents[ $filename ] = $contents;
			}
		}

		if ( ! empty( $contents ) ) {
			return self::extract_last_doc_comment( implode( "\n", array_slice( $contents, 0, $reflection->getStartLine() ) ) );
		}

		\WP_CLI::debug( "Could not read contents for filename '{$filename}'.", 'commandfactory' );
		return null;
	}
private static function get_doc_comment( $reflection ) {
		$doc_comment = $reflection->getDocComment();

		if ( false !== $doc_comment || ! ( ini_get( 'opcache.enable_cli' ) && ! ini_get( 'opcache.save_comments' ) ) ) {
			// Either have doc comment, or no doc comment and save comments enabled - standard situation.
			if ( ! getenv( 'WP_CLI_TEST_GET_DOC_COMMENT' ) ) {
				return $doc_comment;
			}
		}

		$filename = $reflection->getFileName();

		if ( isset( self::$file_contents[ $filename ] ) ) {
			$contents = self::$file_contents[ $filename ];
		} elseif ( is_readable( $filename ) ) {
			$contents = file_get_contents( $filename );
			if ( is_string( $contents ) && '' !== $contents ) {
				$contents                         = explode( "\n", $contents );
				self::$file_contents[ $filename ] = $contents;
			}
		}

		if ( ! empty( $contents ) ) {
			return self::extract_last_doc_comment( implode( "\n", array_slice( $contents, 0, $reflection->getStartLine() ) ) );
		}

		\WP_CLI::debug( "Could not read contents for filename '{$filename}'.", 'commandfactory' );
		return null;
	}
private static function get_doc_comment ( $ reflection ) { $ doc_comment = $ reflection -> getDocComment ( ) ; if ( false !== $ doc_comment || ! ( ini_get ( 'opcache.enable_cli' ) && ! ini_get ( 'opcache.save_comments' ) ) ) { // Either have doc comment, or no doc comment and save comments enabled - standard situation. if ( ! getenv ( 'WP_CLI_TEST_GET_DOC_COMMENT' ) ) { return $ doc_comment ; } } $ filename = $ reflection -> getFileName ( ) ; if ( isset ( self :: $ file_contents [ $ filename ] ) ) { $ contents = self :: $ file_contents [ $ filename ] ; } elseif ( is_readable ( $ filename ) ) { $ contents = file_get_contents ( $ filename ) ; if ( is_string ( $ contents ) && '' !== $ contents ) { $ contents = explode ( "\n" , $ contents ) ; self :: $ file_contents [ $ filename ] = $ contents ; } } if ( ! empty ( $ contents ) ) { return self :: extract_last_doc_comment ( implode ( "\n" , array_slice ( $ contents , 0 , $ reflection -> getStartLine ( ) ) ) ) ; } \ WP_CLI :: debug ( "Could not read contents for filename '{$filename}'." , 'commandfactory' ) ; return null ; }
Gets the document comment. Caters for PHP directive `opcache.save comments` being disabled.

@param ReflectionMethod|ReflectionClass|ReflectionFunction $reflection Reflection instance.
@return string|false|null Doc comment string if any, false if none (same as `Reflection*::getDocComment()`), null if error.
Gets the document comment . Caters for PHP directive opcache . save comments being disabled .