技術資料

PHPの関数の戻り値や、ちょっとした計算結果だけを確認したいことがあります。そのためだけにPHPファイルを作るのも少し手間です。

そんなときは、php -rでコマンドラインからPHPコードを直接実行できます。今回はPowerShellでの基本的な使い方と、引用符でつまずきやすい点を紹介します。最後にBashの場合も少し補足します。

php -rの基本形

-rは、引数として渡したPHPコードを実行するCLI用のオプションです。PHPがインストールされ、PowerShellからphpを呼び出せる状態なら、次のように試せます。

php -r 'echo "Hello, PHP!", PHP_EOL;'

Hello, PHP!

-rの後ろが実行するコードです。外側のシングルクォート'はPowerShellでコード全体を一つの文字列として渡すためのもの、内側のダブルクォート"はPHPの文字列を書くためのものです。PHP_EOLで末尾に改行を付けています。

<?phpや?>は付けません。また、通常のPHPコードと同じように文末のセミコロン;が必要です。-rではPHPの終了タグによるセミコロンの省略もできないので、最後の文にも付けましょう。

今回の確認環境

WindowsのOSビルド10.0.26300、PowerShell 7.6.9、PHP 8.3.15（CLI）で、本文のPowerShell例を確認しました。環境は次のコマンドで調べられます。

$PSVersionTable.PSVersion
$PSNativeCommandArgumentPassing
Get-Command php -CommandType Application | Select-Object -ExpandProperty Source
php -v

今回の$PSNativeCommandArgumentPassingはWindowsでした。これは外部プログラムへ引数を渡す方法の設定です。PowerShell 7.3で引用符を含む引数の扱いが変わっているため、Windows PowerShell 5.1やLegacy設定で、以下の記述が同じように動くとは限りません。この記事では7.6.9の上記設定を対象にします。

phpが見つからない場合は、PHPの実行ファイルの場所とPATHを確認してください。また、CLIとWebサーバーで使うPHPは別の場合があります。詳しくはWindows版PHPの実行方式と環境の確認方法も参照してください。

変数や関数を使ってみる

コードは一つの文に限りません。例えば、単価と個数を変数へ入れて計算してみます。

php -r '$price = 1200; $quantity = 3; echo $price * $quantity, PHP_EOL;'

3600

この$priceと$quantityはPHP側の変数です。PowerShell側の変数として用意する必要はありません。

関数の戻り値を確認するなら、var_dump()を使うと型も分かります。例えば、文字列に.csvが含まれるか確認するなら、次のように書けます。

php -r 'var_dump(str_contains("invoice-2026.csv", ".csv"));'

bool(true)

これは「含まれるか」の確認で、拡張子の検証をするコードではありません。関数の細かい挙動を試したいときに、このくらいの短いコードで確認すると便利です。

外側の引用符を変えると、PHPへ渡るコードも変わる

PowerShellは、コマンドをそのままPHPへ丸投げするわけではありません。まずPowerShellが引用符や変数を処理し、その結果をPHPへ渡します。

シングルクォートで囲んだ文字列では変数を展開しませんが、ダブルクォートで囲むと$変数名がPowerShell側で展開されます。次は、あえて失敗させる例です。

$sampleValue = 99
php -r "$sampleValue = 20; echo $sampleValue, PHP_EOL;"

この場合、PHPへ渡るのは次の文字列です。

99 = 20; echo 99, PHP_EOL;

変数への代入ではなく、数値の99へ代入しようとする形になってしまいました。今回の環境では、unexpected token "="を含むPHPの構文エラーになりました。

PHPの変数をそのまま渡したいので、外側をシングルクォートに戻します。

php -r '$sampleValue = 20; echo $sampleValue, PHP_EOL;'

20

これならPHP側の$sampleValueとして処理されます。エラーが出たら、PHPの文法だけでなく、その前にシェルがコードを書き換えていないか確認すると切り分けやすいです。

PHPの文字列にもシングルクォートを使いたい場合

PowerShellでは、シングルクォートで囲んだ文字列の中にシングルクォートを入れるとき、''と二つ続けます。例えば次の形です。

php -r 'echo ''PHP'', PHP_EOL;'

PHP

PHPへ渡るコードはecho 'PHP', PHP_EOL;です。ただ、引用符が増えると読みにくくなるので、最初の例のように、外側をシングルクォート、PHPの文字列をダブルクォートにすると見通しがよいかと思います。

補足：Bashの場合

Bashでも、外側をシングルクォートにして変数展開を防ぐ基本形は同じです。例えば、次のように書きます。

php -r '$price = 1200; $quantity = 3; echo $price * $quantity, PHP_EOL;'

一方、PowerShellの''でシングルクォートを含める書き方は、そのままBashへ移せません。Bashでは、シングルクォートの内側にシングルクォートを書くことはできず、いったん引用を閉じるなどの組み立てが必要です。PHPの文字列も使う場合は、冒頭の出力例のように内側をダブルクォートにしておく方が素直です。

ダブルクォートで囲んだコード内の$変数名がシェル側で展開される点は、Bashでも注意が必要です。Web上の例を使うときは、PHPコードだけでなく、どのシェル向けの記述かも確認しましょう。

長くなったらPHPファイルにする

条件分岐や繰り返しが増えたり、引用符の調整に手間がかかったりするようなら、PHPファイルにした方が読みやすくなります。例えば次をcheck.phpとして保存します。

<?php
$price = 1200;
$quantity = 3;
echo $price * $quantity, PHP_EOL;

保存したフォルダーで、次のように実行すればOKです。ファイルとして保存する場合は、通常どおり先頭の<?phpを付けます。

php .\check.php

出力は先ほどと同じ3600です。なお、php -rはコードを実行するので、ファイルの削除やDB更新を書くと実際に処理されます。また、コマンド履歴へ残る可能性があるため、APIキーやパスワードをコードへ直接書かない方が良いでしょう。

関数を一つ試す、計算結果を確認する、といった小さな用途ならphp -rで十分です。繰り返し使う処理や長いコードはファイルへ切り出す、くらいに使い分けると扱いやすいかと思います。

参考資料

• PHP公式：コマンドラインのオプション
• Microsoft Learn：PowerShellの引用符の規則
• Microsoft Learn：PowerShellの引数解析
• GNU Bash公式：引用符の扱い