PHP ファイルの実行

CLI SAPI は、実行する PHP コードを取得するために三種類の異なる手段をサポートしています。

PHP に特定のファイルの実行を指示する。
```
$ php my_script.php

$ php -f my_script.php
```
上記の方法は共に(-f スイッチの使用の如何に関らず) 指定したファイル my_script.php を実行します。実行ファイルとしてあらゆるファイルを指定することができ、 PHP スクリプトは拡張子 .php で終わる必要がなく、任意の名前や拡張子を使用することができます。
実行する PHP コードをコマンドラインで直接指定する。
```
$ php -r 'print_r(get_defined_constants());'
```
シェル変数の置換と引用符の使用については特に注意してください。

注意:
この例をよくみてください。開始/終了タグがありません! -r スイッチを使用した場合、これらのタグは不要となります。これらのタグを使用するとパーサーエラーを発生します。
実行する PHP コードを標準入力 (stdin)で指定する。

これは強力な機能で、以下の(仮想的な)例に示すように、動的に PHP コードを生成し、実行バイナリに入力することができます。
```
$ some_application | some_filter | php | sort -u > final_output.txt
```

これらのコードを実行する三種類の方法を組み合わせて使用することはできません。

他のシェルアプリケーションのように、PHP バイナリに引数を指定することができるだけでなく、PHP スクリプトがこの引数を取得することも可能です。スクリプトに指定できる引数の数は PHP による制限を受けません (シェルは指定可能な文字数の最大値を設定しています。通常、この制限値を越えることはできません)。スクリプトに指定した引数は、グローバル配列 $argv でアクセス可能です。最初のインデックス (添字 0) には常に、コマンドラインからコールしたスクリプト名が含まれています。コマンドラインスイッチ -r を使ってインラインでコードを実行した場合は、 $argv[0] の値は "Standard input code" となることに注意しましょう。 PHP 7.2.0 より前のバージョンでは、ダッシュ (-) でした。 STDIN の内容をパイプ経由で実行した場合も同じです。

登録される第 2 のグローバル変数は $argc で (スクリプトに指定された引数の数ではなく )、配列 $argv の要素数が含まれます。

スクリプトに指定する引数が文字 - で始まっていない限り、特に留意すべきことはありません。スクリプトに指定する引数が文字 - で始まる場合、PHP 自体がこれをパースする必要があるとみなすため、問題を発生します。これを防止するため、引数リストセパレータ -- を使用してください。PHP にパースされる引数の後にこのセパレータを置くと、その後の全ての引数はそのままパースされずにスクリプトに渡されます。

# これは、指定したコードを実行せずに PHP の使用法を示します
$ php -r 'var_dump($argv);' -h
Usage: php [options] [-f] <file> [args...]
[...]

# これは '-h' を引数として解釈し、PHP の使用法を表示しません
$ php -r 'var_dump($argv);' -- -h
array(2) {
  [0]=>
  string(1) "-"
  [1]=>
  string(2) "-h"
}

Unix システムでは、PHP をシェルスクリプトとして使用する他の手段があります。最初の行が #!/usr/bin/php (必要に応じて、PHP CLI バイナリのパスを置き換えてください) で始まり、PHP の開始/終了タグの中に通常の PHP コードが続くスクリプトを書き、適当なファイル実行属性を設定する(例: chmod +x test)ことが可能です。この方法は、通常のシェル/Perl スクリプトと同様に実行することができます。

例1 シェルスクリプトとしての PHP スクリプトの実行

#!/usr/bin/php
<?php
var_dump($argv);
?>

このファイルの名前が test で、カレントディレクトリにあるとすると、以下のように実行することができます。

$ chmod +x test
$ ./test -h -- foo
array(4) {
  [0]=>
  string(6) "./test"
  [1]=>
  string(2) "-h"
  [2]=>
  string(2) "--"
  [3]=>
  string(3) "foo"
}

見て分かるように、- で始まるスクリプトのパラメータを指定する際に、特に注意する必要はありません。

PHP 実行バイナリは、Web サーバーから完全に独立して PHP スクリプトを実行するために使用することができます。Unix システムを使用している場合、実行可能とするためには PHP スクリプトの先頭に特別な一行を追加する必要があります。これにより、システムがそのスクリプトを実行するプログラムを知ることができます。 Windows 環境では、.php ファイルのダブルクリックオプションに php.exe を関連づけることができます。または、PHP によりスクリプトを実行するバッチファイルを作成することも可能です。Unix 上で動作させるためにスクリプトに追加された先頭行は、 Windows 環境での動作に悪影響を与えません。このため、この手法により、クロスプラットフォーム環境で動作するプログラムを書くことができます。コマンドライン PHP プログラムの書方の簡単な例を以下に示します。

例2 コマンドラインから実行されることを意図したスクリプト(script.php)

#!/usr/bin/php
<?php

if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
?>

これは、ひとつのオプションをとるコマンドラインの PHP スクリプトです。

  使用法:
  <?php echo $argv[0]; ?> <option>

  <option> は出力したい単語です。
  --help, -help, -h, あるいは -? を指定すると、
  このヘルプが表示されます。

<?php
} else {
    echo $argv[1];
}
?>

上のスクリプトでは、特殊な先頭行が用いられており、このファイルが PHP により実行されることを示しています。ここでは CLI 版を使用しているため、 HTTP ヘッダは出力されません。PHP でコマンドラインアプリケーションを使用する際には、2 つの変数 $argc および $argv を使用することができます。最初の変数は、引数の数に 1 (実行中のスクリプトの名前)を加えたものです。 2 番目の変数は、引数を保持する配列で、スクリプト名を有する要素 0 ($argv[0]) から始まっています。

上のプログラムでは、引数が 1 より少ないかまたは多いかを調べています。また、引数が --help, -help, -h または -? の場合、ヘルプメッセージを出力し、動的にスクリプト名を出力します。他の引数を受け取った場合、これを出力します。

上のスクリプトを Unix で実行する場合、実行可能とした後、 script.php echothis または script.php -h とする必要があります。 Windows では、この処理を行なう以下のようなバッチファイルを作成することができます。

例3 コマンドライン PHP スクリプトを実行するバッチファイル(script.bat)

@echo OFF
"C:\php\php.exe" script.php %*

上のプログラムが script.php という名前であるとし、 c:\php\php.exe に CLI php.exe があるとすると、このバッチファイルは、追加オプション script.bat echothis または script.bat -h を指定して、スクリプトを実行します。

PHP のコマンドラインアプリケーションを拡張するために使用できるその他の関数については、拡張モジュール Readline に関するドキュメントも参照ください。

Windows 環境で使用している場合、PHP の設定によって C:\php\php.exe や拡張子 .php の指定を不要にすることもできます。Micosoft Windows コマンドラインでの PHP を参照ください。

注意:
Windows では、実際に存在するユーザーアカウントの権限で PHP を実行することを推奨します。 "アカウント名とセキュリティID の間のマッピングは実行されませんでした。" というエラーのため、ネットワークサービス経由で実行する特定の操作は失敗する場合があります