WordPressで「致命的なエラーをチェックするために…」エラーが解決できない場合の対処法

WordPressのテーマエディタでファイルの更新に失敗する場合の対処法を読んでも問題解決できない場合の対処法に関して記述します。

WordPressのテーマの作り方を学ぼうと考え、Kindle unlimitedで見つけた
「グーテンベルク時代のWordPressノートテーマの作り方（入門編） (EP NOTE SERIES)」という本を読んでいます。

書籍に書いてあるとおり、テーマエディタで「index.php」にコードを書き、「ファイルを更新」をクリックした所、次のエラーが発生して更新できません。

致命的なエラーをチェックするためにサイトと通信できないため、PHP の変更は取り消されました。SFTP を使うなど、他の手段で PHP ファイルの変更をアップロードする必要があります。

調べてみた所、wp-admin/includes/file.phpの以下の部分をコメントアウトすると問題が解決すると書いてあります。
多くのブログで492〜599行目と記述されていますが、WordPressのバージョンにより行番号は異なるようです。

	if ( $is_active && 'php' === $extension ) {

		$scrape_key   = md5( rand() );
		$transient    = 'scrape_key_' . $scrape_key;
		$scrape_nonce = strval( rand() );
		set_transient( $transient, $scrape_nonce, 60 ); // It shouldn't take more than 60 seconds to make the two loopback requests.

		$cookies       = wp_unslash( $_COOKIE );
		$scrape_params = array(
			'wp_scrape_key'   => $scrape_key,
			'wp_scrape_nonce' => $scrape_nonce,
		);
		$headers       = array(
			'Cache-Control' => 'no-cache',
		);

		/** This filter is documented in wp-includes/class-wp-http-streams.php */
		$sslverify = apply_filters( 'https_local_ssl_verify', false );

		// Include Basic auth in loopback requests.
		if ( isset( $_SERVER['PHP_AUTH_USER'] ) && isset( $_SERVER['PHP_AUTH_PW'] ) ) {
			$headers['Authorization'] = 'Basic ' . base64_encode( wp_unslash( $_SERVER['PHP_AUTH_USER'] ) . ':' . wp_unslash( $_SERVER['PHP_AUTH_PW'] ) );
		}

		// Make sure PHP process doesn't die before loopback requests complete.
		set_time_limit( 300 );

		// Time to wait for loopback requests to finish.
		$timeout = 100;

		$needle_start = "###### wp_scraping_result_start:$scrape_key ######";
		$needle_end   = "###### wp_scraping_result_end:$scrape_key ######";

		// Attempt loopback request to editor to see if user just whitescreened themselves.
		if ( $plugin ) {
			$url = add_query_arg( compact( 'plugin', 'file' ), admin_url( 'plugin-editor.php' ) );
		} elseif ( isset( $stylesheet ) ) {
			$url = add_query_arg(
				array(
					'theme' => $stylesheet,
					'file'  => $file,
				),
				admin_url( 'theme-editor.php' )
			);
		} else {
			$url = admin_url();
		}
		$url                    = add_query_arg( $scrape_params, $url );
		$r                      = wp_remote_get( $url, compact( 'cookies', 'headers', 'timeout', 'sslverify' ) );
		$body                   = wp_remote_retrieve_body( $r );
		$scrape_result_position = strpos( $body, $needle_start );

		$loopback_request_failure = array(
			'code'    => 'loopback_request_failed',
			'message' => __( 'Unable to communicate back with site to check for fatal errors, so the PHP change was reverted. You will need to upload your PHP file change by some other means, such as by using SFTP.' ),
		);
		$json_parse_failure       = array(
			'code' => 'json_parse_error',
		);

		$result = null;
		if ( false === $scrape_result_position ) {
			$result = $loopback_request_failure;
		} else {
			$error_output = substr( $body, $scrape_result_position + strlen( $needle_start ) );
			$error_output = substr( $error_output, 0, strpos( $error_output, $needle_end ) );
			$result       = json_decode( trim( $error_output ), true );
			if ( empty( $result ) ) {
				$result = $json_parse_failure;
			}
		}

		// Try making request to homepage as well to see if visitors have been whitescreened.
		if ( true === $result ) {
			$url                    = home_url( '/' );
			$url                    = add_query_arg( $scrape_params, $url );
			$r                      = wp_remote_get( $url, compact( 'cookies', 'headers', 'timeout' ) );
			$body                   = wp_remote_retrieve_body( $r );
			$scrape_result_position = strpos( $body, $needle_start );

			if ( false === $scrape_result_position ) {
				$result = $loopback_request_failure;
			} else {
				$error_output = substr( $body, $scrape_result_position + strlen( $needle_start ) );
				$error_output = substr( $error_output, 0, strpos( $error_output, $needle_end ) );
				$result       = json_decode( trim( $error_output ), true );
				if ( empty( $result ) ) {
					$result = $json_parse_failure;
				}
			}
		}

		delete_transient( $transient );

		if ( true !== $result ) {

			// Roll-back file change.
			file_put_contents( $real_file, $previous_content );
			if ( function_exists( 'opcache_invalidate' ) ) {
				opcache_invalidate( $real_file, true );
			}

			if ( ! isset( $result['message'] ) ) {
				$message = __( 'Something went wrong.' );
			} else {
				$message = $result['message'];
				unset( $result['message'] );
			}
			return new WP_Error( 'php_error', $message, $result );
		}
	}

100

101

102

103

104

105

106

107

108

109

110

111

if ( $is_active && 'php' === $extension ) {

$scrape_key = md5( rand() );

$transient = 'scrape_key_' . $scrape_key;

$scrape_nonce = strval( rand() );

set_transient( $transient, $scrape_nonce, 60 ); // It shouldn't take more than 60 seconds to make the two loopback requests.

$cookies = wp_unslash( $_COOKIE );

$scrape_params = array(

'wp_scrape_key' => $scrape_key,

'wp_scrape_nonce' => $scrape_nonce,

);

$headers = array(

'Cache-Control' => 'no-cache',

);

/** This filter is documented in wp-includes/class-wp-http-streams.php */

$sslverify = apply_filters( 'https_local_ssl_verify', false );

// Include Basic auth in loopback requests.

if ( isset( $_SERVER['PHP_AUTH_USER'] ) && isset( $_SERVER['PHP_AUTH_PW'] ) ) {

$headers['Authorization'] = 'Basic ' . base64_encode( wp_unslash( $_SERVER['PHP_AUTH_USER'] ) . ':' . wp_unslash( $_SERVER['PHP_AUTH_PW'] ) );

}

// Make sure PHP process doesn't die before loopback requests complete.

set_time_limit( 300 );

// Time to wait for loopback requests to finish.

$timeout = 100;

$needle_start = "###### wp_scraping_result_start:$scrape_key ######";

$needle_end = "###### wp_scraping_result_end:$scrape_key ######";

// Attempt loopback request to editor to see if user just whitescreened themselves.

if ( $plugin ) {

$url = add_query_arg( compact( 'plugin', 'file' ), admin_url( 'plugin-editor.php' ) );

} elseif ( isset( $stylesheet ) ) {

$url = add_query_arg(

array(

'theme' => $stylesheet,

'file' => $file,

admin_url( 'theme-editor.php' )

);

} else {

$url = admin_url();

}

$url = add_query_arg( $scrape_params, $url );

$r = wp_remote_get( $url, compact( 'cookies', 'headers', 'timeout', 'sslverify' ) );

$body = wp_remote_retrieve_body( $r );

$scrape_result_position = strpos( $body, $needle_start );

$loopback_request_failure = array(

'code' => 'loopback_request_failed',

'message' => __( 'Unable to communicate back with site to check for fatal errors, so the PHP change was reverted. You will need to upload your PHP file change by some other means, such as by using SFTP.' ),

);

$json_parse_failure = array(

'code' => 'json_parse_error',

);

$result = null;

if ( false === $scrape_result_position ) {

$result = $loopback_request_failure;

} else {

$error_output = substr( $body, $scrape_result_position + strlen( $needle_start ) );

$error_output = substr( $error_output, 0, strpos( $error_output, $needle_end ) );

$result = json_decode( trim( $error_output ), true );

if ( empty( $result ) ) {

$result = $json_parse_failure;

}

// Try making request to homepage as well to see if visitors have been whitescreened.

if ( true === $result ) {

$url = home_url( '/' );

$url = add_query_arg( $scrape_params, $url );

$r = wp_remote_get( $url, compact( 'cookies', 'headers', 'timeout' ) );

$body = wp_remote_retrieve_body( $r );

$scrape_result_position = strpos( $body, $needle_start );

if ( false === $scrape_result_position ) {

$result = $loopback_request_failure;

} else {

$error_output = substr( $body, $scrape_result_position + strlen( $needle_start ) );

$error_output = substr( $error_output, 0, strpos( $error_output, $needle_end ) );

$result = json_decode( trim( $error_output ), true );

if ( empty( $result ) ) {

$result = $json_parse_failure;

}

delete_transient( $transient );

if ( true !== $result ) {

// Roll-back file change.

file_put_contents( $real_file, $previous_content );

if ( function_exists( 'opcache_invalidate' ) ) {

opcache_invalidate( $real_file, true );

}

if ( ! isset( $result['message'] ) ) {

$message = __( 'Something went wrong.' );

} else {

$message = $result['message'];

unset( $result['message'] );

}

return new WP_Error( 'php_error', $message, $result );

}

「if ( $is_active && 'php' === $extension ) {」の前の行に「/*」、
一番最後の行の次（「if ( $theme instanceof WP_Theme ) {」の前）に「*/」と入力してから、再度、テーマエディタで「ファイルの更新」をクリックしたところ、
次のエラーに変わりました。

何かうまくいかなかったようです。変更が保存されていないかもしれません。手動で修正し、FTP 経由でファイルをアップロードすることもできます。

試しに、該当部分を全部削除してみてからやってみたら、うまくいきました。
なので、コメントアウトがうまく言ってないと言うことになります。

以下の行があるせいで、コメントアウトに失敗しています。

/** This filter is documented in wp-includes/class-wp-http-streams.php */

この行を次のように書き換えます。

//This filter is documented in wp-includes/class-wp-http-streams.php

「ファイルを更新」をクリックすると、「ファイルの編集に成功しました。」
というメッセージが出て、うまくいくようになりました。