第 42章PHPをコマンドラインから使用する

4.3以降でPHPは Command Line Interfaceを意味する CLIという名前の新しいSAPI型 (Server Application Programming Interface)をサポートします。 名前から分かるように、このSAPI型は、 PHPによるシェル(またはデスクトップ)アプリケーショ ンの開発を主な対象としています。 CLI SAPIと他のSAPIの間には、 いくつかの違いがあります。本章では、これらについて詳細を説明します。 CLIとCGIはその振る舞いの多くが 共通であるにもかかわらず、違うSAPIであることに留意してください。

CLI SAPIは、当初PHP 4.2.0でリ リースされましたが、この時点では実験的なステータスにあったため、 ./configureを実行する際に、明示的に --enable-cliを指定することにより、有効とする必要 がありました。PHP 4.3.0以降、 CLI SAPIはもはや実験的なステータスではなくなり、 --enable-cliはデフォルトでオンとなりました。 無効にする場合は--disable-cliを使用できます。

PHP4.3.0以降、システムにPHPがどのようにインストールされているかによって CLI/CGIバイナリの名前、位置、存在が異なります。デフォルトでは makeを実行するとCGIとCLIの両方がビルドされ ソースディレクトリのsapi/cgi/phpと sapi/cli/phpにそれぞれ配置されます。両方とも phpという名前であることに注目してください。 make installでどうなるかはconfigureに因ります。 configureで例えばapxsのようなSAPIモジュールが選択された場合、または --disable-cgiが指定された場合、 make installによってCLIが{PREFIX}/bin/php にコピーされます。さもなければCGIがそこにコピーされます。 既にインストールされているCGIバイナリを上書きしたい場合には、 make installの後にmake install-cli を実行してください。あるいはconfigureで--disable-cgi を指定しておくこともできます。

PHP4.2.0からPHP4.2.3までのWindowsパッケージではCLIは CGI php.exeと同じフォルダに php-cli.exeとして配布されていました。 PHP4.3.0からはWindowsパッケージではCLIはcliという 別のフォルダにphp.exeとして配布されます。 したがってcli/php.exeとなります。

CLI SAPIを他のSAPIと比べた時 の大きな違いを以下に示します。

• CGI SAPIと異なり、ヘッダが出力されません。

  CGI SAPIは、HTTPヘッダの出力を抑制する機能を 提供していますが、等価な機能はCLI SAPIではサ ポートされていません。

  デフォルトではCLIは静寂モードで起動されます。古いCGIスクリプトと互換性を 保って使えるように-qスイッチが残されています。

  動作するディレクトリはスクリプトの場所に変更されることはありません。 (-Cは互換性のために残されています)

  エラーメッセージはプレーンテキストで表示されます。 （HTMLでフォーマットされません）

• 以下に示すいくつかのphp.iniディレクティブは、CLI SAPIにより上書きされます。これは、シェル環境では意味が ないためです。

  表 42-1. 上書きされるphp.iniのディレクティブ

  ディレクティブ	CLI SAPIのデフォルト値	コメント
  html_errors	FALSE	エラーメッセージに含まれるHTMLタグはシェ ル上では意味がなく、可読性をかなり低下させるため、このディ レクティブはデフォルトでFALSEとなっています。
  implicit_flush	TRUE	print(), echo()および 関連するものによる全ての出力は、直ちに出力され、バッファに キャッシュされないことが望ましいと言えます。この場合でも、 標準出力を保留または操作したい場合には、 output bufferingを使 用することが可能です。
  max_execution_time	0 (unlimited)	シェル環境では、PHPを際限なく使用できる ようにするために、最大実行時間の制限は無しに設定されていま す。Web用アプリケーションは数秒単位で実行されるよう作られて いますが、シェルアプリケーションの実行時間は、これよりかな り長くなる傾向があります。
  register_argc_argv	TRUE	CLI SAPIを使用している場合、グローバル PHP変数$argc (アプリケーションに渡される引数の数)と $argv (引数の値の配列)は常に登録され、 適切な値が代入されます。 PHP4.3.0以降、CLI SAPIを使用するときに PHPの$argc変数と $argv変数が登録され、適切な値がセットされます。 このバージョンより前では、CGIや MODULEがこれらの変数を生成するにはPHPの register_globals ディレクティブがオンになっている必要がありました。 バージョンやregister_globalsの設定がどうであろうと、 $_SERVERまたは $HTTP_SERVER_VARSは常に使用可能です。 例：$_SERVER['argv']

  注意: これらのディレクティブは、設定ファイルphp.iniまたはカスタム設 定ファイル(指定した場合のみ)で他の値に初期化できません。この制 限は、これらのデフォルト値が全ての設定ファイルをパースした後に 適用されるためです。しかし、これらの値は実行時に変更することが 可能です。 (上記のディレクティブの全てについてこれが当てはまるわけではあり ません。例えば、register_argc_argv)

• シェル環境での動作を容易とするために、以下の定数が定義されていま す。

  表 42-2. CLI固有の定数

  定数	説明
  STDIN	stdinへのオープン済みのストリーム。これ により、以下のようにオープンする必要がなくなります。 $stdin = fopen('php://stdin', 'r');
  STDOUT	stdoutへのオープン済みのストリーム。これ により、以下のようにオープンする必要がなくなります。 $stdout = fopen('php://stdout', 'w');
  STDERR	stderrへのオープン済みのストリーム。これ により、以下のようにオープンする必要がなくなります。 $stderr = fopen('php://stderr', 'w');

  上記のように、stderrのようなストリームを自分 でオープンする必要はなく、以下のようにストリームリソースの代わり に定数を使用するだけでかまいません。

  php -r 'fwrite(STDERR, "stderr\n");'

  これらのストリームを明示的に閉じる必要はありません。これは、 PHPにより自動的に行われます。

• CLI SAPIは、実行されるスクリプトのディレクト リにカレントディレクトリを変更しません !

  CGI SAPIとの違いを示す例を以下に示します。

  <?php    /* Our simple test application */    echo getcwd(), "\n"; ?>

  CGI版により実行した場合、出力は以下のようにな ります。

  $ pwd /tmp $ php-cgi -f another_directory/test.php /tmp/another_directory

  これは、PHPが実行するスクリプトのディレクトリ にカレントディレクトリを変更することを明らかに示しています。

  CLI SAPIを使用した場合の出力は次のようになり ます。

  $ pwd /tmp $ php -f another_directory/test.php /tmp

  これにより、PHPでシェルツールを書く際の柔軟性 をより大きくすることができます。

  注意: CGI SAPIは、このCLI SAPI の動作をコマンドライン実行時のスイッチ-Cによ りサポートしています。

PHPバイナリにより提供されるコマンドラインオプショ ンの一覧は、-hスイッチを指定して PHPを実行することによりいつでも調べることができ ます。

Usage: php [options] [-f] <file> [args...] php [options] -r <code> [args...] php [options] [-- args...] -s Display colour syntax highlighted source. -w Display source with stripped comments and whitespace. -f <file> Parse <file>. -v Version number -c <path>|<file> Look for php.ini file in this directory -a Run interactively -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler -z <file> Load Zend extension <file>. -l Syntax check only (lint) -m Show compiled in modules -i PHP information -r <code> Run PHP <code> without using script tags <?..?> -h This help args... Arguments passed to script. Use -- args when first argument starts with - or script is read from stdin

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

1. PHPに特定のファイルの実行を指示する。

   php my_script.php php -f my_script.php

   上記の方法は共に(-fスイッチの使用の如何に関ら ず)指定したファイルmy_script.phpを実行しま す。実行ファイルとしてあらゆるファイルを指定することができ、 PHPスクリプトは拡張子 .phpで終わる必要がなく、任意の名前や拡張子 を使用することができます。

2. 実行するPHPコードをコマンドラインで直接指定する。

   php -r 'print_r(get_defined_constants());'

   シェル変数の置換と引用符の使用については特に注意して下さい。

   注意: この例をよくみて下さい。開始/終了タグがありません! -rスイッチを使用した場合、これらのタグは不要 となります。これらのタグを使用するとパーサエラーを発生します。

3. 実行するPHPコードを標準入力 (stdin)で指定する。

   これは強力な機能で、以下の(仮想的な)例に示すように、動的に PHPコードを生成し、実行バイナリに入力すること ができます。

   $ some_application | some_filter | php | sort -u >final_output.txt

他のシェルアプリケーションのように、PHPバイナリ に引数を指定することができるだけでなく、PHPスク リプトがこの引数を取得することも可能です。スクリプトに指定できる引 数の数はPHPによる制限を受けません。 (シェルは指定可能な文字数の最大値を設定しています。通常、この制限値 を越えることはできません。) スクリプトに指定した引数は、グローバル 配列$argvでアクセス可能です。 添字0は、常にスクリプト名が含まれています。 ( PHPコードが標準入力またはコマンドラインスイッ チ-rにより指定された場合、スクリプト名は -となります。) 登録される第2のグローバル変数は$argcで、 (スクリプトに指定された引数の数ではなく 、)配列$argvの要素数が含まれます。

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

# This will not execute the given code but will show the PHP usage
$ php -r 'var_dump($argv);' -h
Usage: php [options] [-f] <file> [args...]
[...]

# This will pass the '-h' argument to your script and prevent PHP from showing it's usage
$ php -r 'var_dump($argv);' -- -h
array(2) {
  [0]=>
  string(1) "-"
  [1]=>
  string(2) "-h"
}

また、PHPをシェルスクリプトとして使用する他の 手段があります。最初の行が#!/usr/bin/phpで始まり、 PHPの開始/終了タグの中に通常の PHPコードが続くスクリプトを書き、適当なファイル 実行属性を設定する(e.g. chmod +x test)ことが可能です。 この方法は、通常のシェル/Perlスクリプトと同様に実行することができます。

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

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

$ chmod 755 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プログラムの書方の簡単な例を以下に示します。

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

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

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

@c:\php\php.exe script.php %1 %2 %3 %4

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

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