WordPressで”Cannot modify header information”の警告が出たときの解決方法

2017年4月9日 2017年5月22日
WordPress

WordPressテーマの制作中、管理画面のJetpackメニューの部分に

cannot-modify-header-information-01

Warning:Cannot modify header information

このような警告が出るようになりました。

Warningは警告なので重大な不具合が出るわけではありません。無視しても問題はなさそうですが、ずっと出た状態なのですごく気になります。

警告文を続けて読むと、headers already sent by ( output started at ~)となっています。

下記サイトによると、この警告はheader関数よりも前に余計な処理が割り込んでしまうことによって起こるものだそうです。

「headers already sent」と表示されるとき | PHPプログラミングの教科書 [php1st.com]

ということは、それを見つけて修正すれば「Warning:Cannot modify header information」は直りそうです。

「Warning:Cannot modify header information」の解決方法

原因のある箇所はrest-api.phpの513行目と書いています。

確認してみると下記のようなコードでした。

header( sprintf( 'X-WP-DeprecatedParam: %s', $string ) );

PHPマニュアルによると空白もダメということが書いてあり、このコードの上にも1行空白がありました。

覚えておいて頂きたいのは、header() 関数は、通常の HTML タグまたは PHP からの出力にかかわらず、すべての実際の出力の前にコールする必要があることです。頻出するエラーとして、include または require 関数、他のファイルをアクセスする関数に空白または空行があり、header() の前に出力が行われてしまうというものがあります。同じ問題は、単一の PHP/HTML ファイルを使用している場合でも存在します。

PHP: header – Manual

ということで、とりあえず空白を以下のように詰めてみましたが警告は消えませんでした。

function rest_handle_deprecated_argument( $function, $message, $version ) {
	if ( ! empty( $message ) ) {
		/* translators: 1: function name, 2: WordPress version number, 3: error message */
		$string = sprintf( __( '%1$s (since %2$s; %3$s)' ), $function, $version, $message );
	} else {
		/* translators: 1: function name, 2: WordPress version number */
		$string = sprintf( __( '%1$s (since %2$s; no alternative available)' ), $function, $version );
	}
	header( sprintf( 'X-WP-DeprecatedParam: %s', $string ) );
}

そもそもこのファイルはいじったことがないし、STINGER8では問題もなくJetpackが使えているので他を疑うことにしました。

WordPressは全然違う箇所をエラー報告したりするのでハマる原因にもなります。本当に厄介です。

Google先生に頼って調べていると、また一つ解決方法が見つかりました。