コマンドラインオプション
PHP バイナリにより提供されるコマンドラインオプションの一覧は、 -h スイッチを指定して PHP を実行することにより いつでも調べることができます。
Usage: php [options] [-f] <file> [--] [args...] php [options] -r <code> [--] [args...] php [options] [-B <begin_code>] -R <code> [-E <end_code>] [--] [args...] php [options] [-B <begin_code>] -F <file> [-E <end_code>] [--] [args...] php [options] -- [args...] php [options] -a -a Run interactively -c <path>|<file> Look for php.ini file in this directory -n No php.ini file will be used -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler -f <file> Parse and execute <file>. -h This help -i PHP information -l Syntax check only (lint) -m Show compiled in modules -r <code> Run PHP <code> without using script tags <?..?> -B <begin_code> Run PHP <begin_code> before processing input lines -R <code> Run PHP <code> for every input line -F <file> Parse and execute <file> for every input line -E <end_code> Run PHP <end_code> after processing all input lines -H Hide any passed arguments from external tools. -S <addr>:<port> Run with built-in web server. -t <docroot> Specify document root <docroot> for built-in web server. -s Output HTML syntax highlighted source. -v Version number -w Output source with stripped comments and whitespace. -z <file> Load Zend extension <file>. args... Arguments passed to script. Use -- args when first argument starts with - or script is read from stdin --ini Show configuration file names --rf <name> Show information about function <name>. --rc <name> Show information about class <name>. --re <name> Show information about extension <name>. --rz <name> Show information about Zend extension <name>. --ri <name> Show configuration for extension <name>.
オプション | 長い形式のオプション | 説明 |
---|---|---|
-a | --interactive |
PHP を対話的に実行します。詳細な情報は、対話シェル を参照ください。 |
-b | --bindpath |
外部 FASTCGI サーバーモードでのバインドパス (CGI のみ)。 |
-C | --no-chdir |
スクリプトのディレクトリへ chdir しません (CGI のみ)。 |
-q | --no-header |
静寂モード。HTTP ヘッダの出力を抑制します (CGI のみ)。 |
-T | --timing |
スクリプトを count 回繰り返して実行した時間を計測します (CGI のみ)。 |
-c | --php-ini |
このオプションを使用することにより、php.ini を探すディレクトリを
指定したり、カスタマイズされた $ php -c /custom/directory/ my_script.php $ php -c /custom/directory/custom-file.ini my_script.php このオプションを指定しない場合、ファイルは、 デフォルトの位置 で探索されます。 |
-n | --no-php-ini |
php.ini を完全に無視します。 |
-d | --define |
このオプションにより php.ini で指定できる設定ディレクティブに カスタム値を設定することができます。構文は以下のようになります。 -d configuration_directive[=value] 例1 INI 設定に # 値の部分を省略すると、設定ディレクティブに"1"を指定します $ php -d max_execution_time -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(1) "1" # 空の値を渡すと設定ディレクティブに""を設定します php -d max_execution_time= -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(0) "" # 設定ディレクティブは文字'='の後に指定したものを設定します $ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(2) "20" $ php -d max_execution_time=doesntmakesense -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(15) "doesntmakesense" |
-e | --profile-info |
デバッガ/プロファイラ用の拡張情報を出力します。 |
-f | --file |
-f オプションに指定したファイル名をパースし、 実行します。このスイッチはオプションで省略することもできます。 実行するスクリプトを指定するだけで充分です。 |
-h and -? | --help and --usage | このオプションを使用すると、実際の一連のコマンドラインオプションと 各1行の説明が情報を取得できます。 |
-i | --info | このコマンドラインオプションは、phpinfo() をコールし、 結果を出力します。PHP が正しく動作していない場合、 php -i を実行し、情報テーブルの前または中に 出力されるエラーメッセージを調べることをお勧めします。 CGI モードの場合、 出力が HTML 形式で行なわれるため 量がかなり多くなることに注意してください。 |
-l | --syntax-check |
構文チェックを行いますが、指定された PHP コードは実行しません。
ファイル名が指定されない場合、標準出力の入力をチェックしますが、
指定された場合、それぞれのファイルがチェックされます。
成功した場合、
テキスト
このオプションは、(未定義の関数のような)致命的なエラー(fatal error) を見つけることはありません。そうするためには、 コード全体を実行する必要があるからです。
|
-m | --modules |
例2 PHP に組み込まれた (そしてロードされた) Zend モジュールの表示 $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules] |
-r | --run |
このオプションにより、コマンドラインのみで PHP
の実行ができるようになります。
PHP の開始および終了タグ
(
|
-B | --process-begin |
標準入力を処理する前に実行する PHP コードを指定します。 |
-R | --process-code |
それぞれの入力行に対して実行する PHP コードを指定します。 このモードには 2 つの特別な変数 $argn と $argi が用意されています。 $argn は PHP がその瞬間に処理している行を含み、 $argi はその行番号を含んでいます。 |
-F | --process-file |
全ての入力行に対して実行する PHP ファイルを指定します。 |