短い開きタグのせいで、作業環境だけ Parse error になる:short_open_tag の違いと直し方

トラブル・エラー対応
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

本番から複製した作業環境で、あるサイトのトップだけが 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 件目のあとに広告を挿入する所です。

形を簡単にすると、次のようになっていました。

front-page.php(形を簡単にしたもの)
<?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 -l の結果(直す前の front-page.php)
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 と <?= を使うことがすすめられています。

今の設定の見方

今の short_open_tag の値を見る
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 にするだけです。

front-page.php(612 行目)
// 前
<?
    }

// 後
<?php
    }

<?php は、short_open_tag が有効でも無効でも同じに動くので、本番の動きは変わりません。

作業環境の php.ini を On にしても表示はされますが、それでは別の環境に移したときに、また同じことが起きます。

ファイルの方を直しておけば、どの環境でも同じに動きます。

作業環境で確認した

作業環境の PHP 8.3.32 で、短い開きタグの検証用のファイルを 3 つ作り、-d short_open_tag=0(無効)と =1(有効)で、php -l と実行をしました。

loop-short.php(ループの中に短い開きタグ)
<?php
$items = array( 'a', 'b' );
foreach ( $items as $item ) {
?>
    <li><?php echo $item; ?></li>
<?
}
?>
<p>end</p>
echo-short.php(短い開きタグで文字を出すだけ)
<p><? echo 'hello'; ?></p>
short-echo.php(<?= を使う)
<?php $name = 'hello'; ?>
<p><?= $name ?></p>
流したコマンド(loop-short.php の例)
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
出た結果(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 に通す方法もあります。

short_open_tag を無効にして、全部のファイルを 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 に通してから本番に出します。

参考

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。