本番から複製した作業環境で、あるサイトのトップだけが Parse error で表示されませんでした(本番では、同じファイルで問題なく表示されています)。
調べると、テーマの front-page.php の 1 か所が、<?php ではなく、短い開きタグの <? だけになっていました。
直したのは <? を <?php にする 1 か所だけで、テーマのほかの PHP のファイル(77 個)に同じ書き方が残っていないことも、grep で確認しました。
起きたこと
作業環境は PHP 8.3 です。
記事のページやカテゴリーのページは表示されましたが、トップだけが Parse error になりました。
トップは、テーマの front-page.php で作っています。
原因の行
front-page.php の 612 行目が、<? だけの行でした。
トップの記事の一覧で、5 件目のあとに広告を挿入する所です。
形を簡単にすると、次のようになっていました。
<?php
$post_cnt = 0;
while ( $cb_posts->have_posts() ) :
$cb_posts->the_post();
?>
<li class="article">(記事を 1 件出す)</li>
<?php
if ( $post_cnt == 5 ) {
?>
</ol>
<div class="sp">(広告のタグ)</div>
<ol>
<?
}
$post_cnt++;
endwhile;
wp_reset_postdata();
?>
上の <? のあとに、if を閉じる } と、endwhile があります。
- 短い開きタグが有効なら、
<?から?>までが PHP のコードとして動きます。 - 無効なら、
<?から?>までは、ただの文字(HTML)として扱われます。
すると、} と endwhile が PHP から見えなくなり、if と while が閉じられないまま、ファイルの終わりのほうまで進みます。
そこで PHP の構文が合わなくなり、ファイル全体が読めずに Parse error になります。
出ていたエラー
直す前のファイルを git から取り出して、短い開きタグを無効にして php -l(文法のチェック)に通すと、次のように出ました。
PHP Parse error: syntax error, unexpected token "endif" in Standard input code on line 651
エラーの行は 651 行目ですが、本当の原因は 612 行目です。
閉じ忘れのエラーは、原因より後ろの行で出ることがあります。
同じファイルを、短い開きタグを有効にして php -l に通すと、「No syntax errors detected」でした。
short_open_tag とは
PHP には、short_open_tag という設定があります。
これが有効だと、<?php の代わりに <? だけでも、PHP のコードの始まりになります。
サーバーによって、有効だったり無効だったりします。
今回は、次のとおりでした。
- 本番のサーバー:有効
- 作業環境の php.ini:
short_open_tag = Off(無効)
そのため、同じテーマでも、本番では動き、作業環境では止まりました。
PHP のマニュアルでも、短い開きタグは無効にできるので、どの環境でも動くように <?php と <?= を使うことがすすめられています。
今の設定の見方
php -i | grep short_open_tag
short_open_tag => Off => Off
| 書き方 | 役目 |
|---|---|
php -i |
PHP の設定を全部出す(phpinfo() と同じ内容) |
grep short_open_tag |
その中から、short_open_tag の行だけを出す |
Off => Off |
左が今の値、右が php.ini の値。どちらも無効 |
php -i はコマンドで動かす PHP の設定で、ブラウザーから動く PHP は、別の php.ini を読んでいることがあります。
作業環境では、ブラウザーで開いたトップも Parse error になったので、ブラウザーから動く PHP でも無効だったことが分かります。
本番のサーバーでの値の見方は、サーバーごとに違うので、この記事では試していません。
直し方:<?php にする
直し方は、<? を <?php にするだけです。
// 前
<?
}
// 後
<?php
}
<?php は、short_open_tag が有効でも無効でも同じに動くので、本番の動きは変わりません。
作業環境の php.ini を On にしても表示はされますが、それでは別の環境に移したときに、また同じことが起きます。
ファイルの方を直しておけば、どの環境でも同じに動きます。
作業環境で確認した
作業環境の PHP 8.3.32 で、短い開きタグの検証用のファイルを 3 つ作り、-d short_open_tag=0(無効)と =1(有効)で、php -l と実行をしました。
<?php
$items = array( 'a', 'b' );
foreach ( $items as $item ) {
?>
<li><?php echo $item; ?></li>
<?
}
?>
<p>end</p>
<p><? echo 'hello'; ?></p>
<?php $name = 'hello'; ?> <p><?= $name ?></p>
php -d short_open_tag=0 -l loop-short.php php -d short_open_tag=0 loop-short.php php -d short_open_tag=1 -l loop-short.php php -d short_open_tag=1 loop-short.php
$ php -d short_open_tag=0 -l loop-short.php
PHP Parse error: Unclosed '{' on line 3 in loop-short.php on line 10
Errors parsing loop-short.php
$ php -d short_open_tag=1 -l loop-short.php
No syntax errors detected in loop-short.php
$ php -d short_open_tag=1 loop-short.php
<li>a</li>
<li>b</li>
<p>end</p>
| ファイル | short_open_tag=0(無効) | short_open_tag=1(有効) |
|---|---|---|
| loop-short.php | php -l も実行も Parse error(Unclosed '{' on line 3) |
エラーなし。<li>a</li> と <li>b</li> が出る |
loop-short.php を <?php に直したもの |
エラーなし。a と b が出る | エラーなし。a と b が出る |
| echo-short.php | php -l はエラーなし。実行すると <p><? echo 'hello'; ?></p> と、コードがそのまま出る |
<p>hello</p> |
short-echo.php(<?=) |
<p>hello</p> |
<p>hello</p> |
短い開きタグが無効のときの動きは、2 つに分かれました。
ループや if の途中に <? があると、閉じる所が見えなくなって Parse error になります。
文字を出すだけの <? なら、エラーにはならず、コードがそのまま画面に出ます。
エラーにならない分、気づきにくく、コードが外から見えてしまいます。
<?= は設定に関係なく使える
<?= $name ?> は、<?php echo $name; ?> を短く書く形です。
PHP 5.4 から、<?= は short_open_tag の設定に関係なく使えます(PHP 5.4.0 の変更履歴と、マニュアルの short_open_tag の説明に書かれています)。
上の表のとおり、無効のときも有効のときも同じに hello が出たので、直すのは <? だけで、<?= はそのままで大丈夫です。
ほかに短い開きタグがないか探す
1 か所あれば、ほかにも残っているかもしれません。
テーマのフォルダで、grep で探します。
cd wp-content/themes/(テーマのフォルダ)/ grep -rniP --include='*.php' '<\?(?!php|=|xml)' .
| 書き方 | 役目 |
|---|---|
-r |
フォルダの中を全部探す |
-n |
見つかった行の番号を出す |
-i |
大文字と小文字を区別しない(<?PHP も外す) |
-P |
Perl と同じ形の正規表現を使う(下の (?!…) を使うため) |
--include='*.php' |
PHP のファイルだけを見る |
<\? |
<? の 2 文字(? は正規表現の記号なので \ を付ける) |
(?!php|=|xml) |
すぐ後ろが php・=・xml のものは外す |
<?php と <?= は正しい書き方なので外します。
<?xml は、XML の宣言を文字として出している所なので外します。
流した結果
直したあとのテーマ(PHP のファイル 77 個)で流すと、0 件でした。
直す前のコミットでも同じ正規表現で探せるかを、git grep で確認しました。
git grep -niP '<\?(?!php|=|xml)' (直す前のコミット) -- '*.php'
(直す前のコミット):front-page.php:612:<?
直す前は 612 行目の 1 件が見つかり、直したあとは 0 件です。
php -l でまとめて確認する
短い開きタグを無効にして、テーマの PHP のファイルを全部 php -l に通す方法もあります。
find . -name '*.php' -print0 | xargs -0 -n1 php -d short_open_tag=0 -l 2>&1 | grep -v '^No syntax errors'
エラーのないファイルの行を外しているので、何も出なければ、Parse error になるファイルはありません。
直したあとのテーマでは、77 個とも「No syntax errors detected」でした。
ただし、上の echo-short.php のように、エラーにならずにコードが出るだけの書き方は、php -l では見つからないので、grep で探すほうが、もれがありません。
気をつけること
本番の設定が有効でも、サーバーの引っ越しや PHP のバージョンを上げたときに、設定が変わることがあります。動いているうちに直しておきます。
- Windows の Git Bash で
grep -Pを使うと、「-P supports only unibyte and UTF-8 locales」と出て探せませんでした。LC_ALL=C.UTF-8を付けて流すと探せました - grep の正規表現は、PHP の文字列の中の
<?も拾います。見つかった行は、1 つずつ内容を見てから直します - テーマだけでなく、自作のプラグインにも同じ書き方が残っていることがあります。探すフォルダを変えて流します
まとめ
ほかに管理しているサイトのテーマと自作のプラグインでも、同じ grep を流します。見つかった <? は <?php に直し、short_open_tag を無効にした php -l に通してから本番に出します。

