PHP의 명령줄 모드에 대한 자세한 설명-PHP 튜토리얼-php.cn

이 글에서는 주로 PHP의 명령줄 모드에 대한 자세한 설명을 공유합니다. 다음은 PHP 바이너리 파일(즉, php.exe 프로그램)에서 제공하는 명령줄 모드 옵션 매개변수입니다. 언제든지 PHP -h 명령을 통해.

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 &#39;bar&#39;
  -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 코드를 가져오는 다음 세 가지 방법이 있습니다.

Windows 환경에서는 큰따옴표를 사용하고 Linux 환경에서는 작은따옴표를 사용해 보세요.

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 매개변수를 사용하면 이러한 표시가 필요하지 않으며 구문 오류가 발생합니다.
표준 입력(stdin)을 통해 실행해야 하는 PHP 코드를 제공하세요.
위의 사용법은 매우 강력한 기능을 제공하므로 다음 예와 같이 PHP 코드를 동적으로 생성하고 명령줄을 통해 이러한 코드를 실행할 수 있습니다. 코드를 실행하는 세 가지 방법을 동시에 사용할 수 없습니다.
모든 셸 애플리케이션과 마찬가지로 PHP 바이너리(php.exe 파일)와 이 애플리케이션이 실행하는 PHP 스크립트는 일련의 매개변수를 받아들일 수 있습니다. PHP는 스크립트에 전달되는 인수 수에 제한이 없습니다(셸에는 명령줄의 문자 수에 제한이 있지만 일반적으로 이 제한을 초과하지 않습니다). 스크립트에 전달된 인수는 전역 변수 $argv에서 사용할 수 있습니다. 이 배열의 인덱스가 0인 멤버는 스크립트의 이름입니다(PHP 코드가 표준 입력에서 제공되고 -r 매개변수를 사용하여 명령줄에서 직접 실행되는 경우 이 이름은 "-"입니다). 또한 전역 변수 $argc는 $argv 배열의 멤버 변수 수를 저장합니다(스크립트 프로그램에 전달된 매개변수 수가 아님). 스크립트에 전달하는 매개변수가 - 기호로 시작하지 않는 한 어떤 것에도 너무 많은 주의를 기울일 필요가 없습니다. -로 시작하는 매개변수를 스크립트에 전달하면 PHP가 이러한 매개변수를 자체적으로 처리해야 한다고 생각하기 때문에 오류가 발생합니다. 이 문제를 해결하려면 매개변수 목록 구분 기호를 사용할 수 있습니다. PHP가 매개변수를 구문 분석한 후 이 기호 뒤의 모든 매개변수는 그대로 스크립트에 전달됩니다.
```
$ some_application | some_filter | php | sort -u >final_output.txt
```
로그인 후 복사

이 외에도 쉘 스크립트에 PHP를 사용하는 또 다른 방법이 있습니다. 스크립트를 작성하고 #!/usr/bin/php로 첫 번째 줄을 시작한 다음, PHP 시작 및 종료 태그가 있는 일반 PHP 코드를 시작한 다음 파일 속성에 대한 올바른 실행을 설정할 수 있습니다. 이 방법을 사용하면 파일을 쉘 스크립트나 PERL 스크립트처럼 직접 실행할 수 있습니다.

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

파일 이름이 test로 바뀌고 현재 디렉터리에 있다고 가정하면 다음과 같이 할 수 있습니다. 다음:

# 以下命令将不会运行 PHP 代码，而只显示 PHP 命令行模式的使用说明：
$ php -r &#39;var_dump($argv);&#39; -h
Usage: php [options] [-f] <file> [args...]
[...]
 
# 以下命令将会把“-h”参数传送给脚本程序，PHP 不会显示命令行模式的使用说明：
$ php -r "var_dump($argv);" -- -h
array(2) {
  [0]=>
  string(1) "-"
  [1]=>
  string(2) "-h"
}

로그인 후 복사

보시다시피 -로 시작하는 인수를 스크립트에 전달하면 스크립트가 여전히 제대로 실행됩니다.

표 23-3. 명령줄 옵션

옵션 이름	Description
-s	소스 파일을 표시합니다. 이 매개변수는 내장된 메커니즘을 사용하여 파일을 구문 분석하고 HTML 강조 버전을 생성한 후 결과를 표준 출력에 기록합니다. 이 모든 프로세스는 `[...]` 태그 블록을 생성하며 HTML 헤더를 포함하지 않습니다. 참고: 이 옵션은 -r 매개변수와 함께 사용할 수 없습니다.
-w	주석과 공백이 제거된 소스 코드를 표시합니다. 참고: 이 옵션은 -r 매개변수와 함께 사용할 수 없습니다.
-f	주어진 파일 이름을 구문 분석하고 실행합니다. 이 매개변수는 선택사항이며 생략할 수 있습니다. 실행해야 하는 파일의 이름만 지정하면 됩니다.
-v	PHP, PHP SAPI, Zend의 버전 정보를 표준 출력에 씁니다. 예: $ php -v PHP 4.3.0-dev(cli), 저작권(c) 1997-2002 PHP 그룹 Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies
-c	이 매개변수를 사용하면 php.ini 파일이 있는 디렉토리를 지정하거나 사용자 정의 INI 파일을 직접 지정할 수 있습니다. 파일 이름은 php.ini일 필요는 없습니다. 예: $ php -c /custom/directory/ my_script.php $ php -c /custom/directory/custom-file.ini my_script.php
-a	PHP를 대화형으로 실행합니다.
-d	이 매개변수를 사용하여 php.ini 파일의 변수 값을 설정합니다. 구문은 다음과 같습니다. -dconfiguration_directive[=value] 예: # 값 부분을 생략하면 설정됩니다. "1"에 대한 지정된 구성 지시어 $ php -d max_execution_time -r '$foo = ini_get("max_execution_time");' 문자열(1) "1" # 빈 값 부분을 전달하면 구성 지시문이 ""로 설정됩니다. php -d max_execution_time= -r '$foo = ini_get("max_execution_time");' 문자열(0) "" # 구성 지시문은 '=' 문자 뒤에 전달되는 모든 항목으로 설정됩니다. $ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time");' 문자열(2) "20" $ PHP -d max_execution_time=이해가 되지 않습니다 -r '$foo = ini_get("max_execution_time");' string(15) "doesntmakesense"
-e	디버거 등에 대한 확장 정보를 생성합니다.
-z	Zend 확장 라이브러리를 로드합니다. 파일 이름만 제공되면 PHP는 시스템 확장 라이브러리의 기본 경로(Linux 시스템에서 이 경로는 일반적으로 /etc/ld.so.conf에 지정됨)에서 확장 라이브러리를 로드하려고 시도합니다. 절대 경로로 파일 이름을 지정하면 확장 라이브러리에 대한 시스템의 기본 경로가 사용되지 않습니다. 파일 이름이 상대 경로로 지정되면 PHP는 현재 디렉터리에 상대적인 확장만 로드하려고 시도합니다.
-l	이 매개변수는 지정된 PHP 코드의 구문을 검사하는 편리한 방법을 제공합니다. 성공하면 에서 발견된 구문 오류 없음 문자열이 표준 출력에 기록되고 셸은 값 0을 반환합니다. 실패하면 구문 분석 오류가 내부 구문 분석기 오류 메시지와 함께 표준 출력에 기록되고 셸 반환 값은 255로 설정됩니다. 이 매개변수는 치명적인 오류(예: 정의되지 않은 함수)를 확인할 수 없습니다. 치명적인 오류를 감지하려면 -f 매개변수를 사용하세요. 참고: 이 매개변수는 -r과 함께 사용할 수 없습니다.
-m	이 매개변수를 사용하면 PHP는 내장 및 로드된 PHP 및 Zend 모듈을 인쇄합니다. $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules]
-i	该命令行参数会调用 phpinfo() 函数，并打印出结果。如果 PHP 没有正常工作，我们建议您执行 php -i 命令来查看在信息表格之前或者对应的地方是否有任何错误信息输出。请注意输出的内容为 HTML 格式，因此输出的信息篇幅较大。
-r	使用该参数可以在命令行运行 PHP 代码。您无需加上 PHP 的起始和结束标识符（），否则将会导致语法解析错误。注: 使用这种形式的 PHP 时，应个别注意避免和外壳环境进行的命令行参数替换相冲突。显示语法解析错误的范例 $ php -r "$foo = get_defined_constants();" Command line code(1) : Parse error - parse error, unexpected '=' 这里的问题在于即时使用了双引号 "，sh/bash 仍然实行了参数替换。由于 $foo 没有被定义，被替换后它所在的位置变成了空字符，因此在运行时，实际被 PHP 读取的代码为： $ php -r " = get_defined_constants();" 正确的方法是使用单引号 '。在用单引号引用的字符串中，变量不会被 sh/bash 还原成其原值。 $ php -r '$foo = get_defined_constants(); var_dump($foo);' array(370) { ["E_ERROR"]=> int(1) ["E_WARNING"]=> int(2) ["E_PARSE"]=> int(4) ["E_NOTICE"]=> int(8) ["E_CORE_ERROR"]=> [...] 如果您使用的外壳不是 sh/bash，您可能会碰到其它的问题。请报告您碰到的 bug，或者发邮件到 phpdoc@lists.php.net。当您试图将外壳的环境变量引入到马或者用反斜线来转义字符时也可能碰到各种各样的问题，请您在使用时注意！注: -r 在 CLI SAPI 中有效，在 CGI SAPI 中无效。
-h	使用该参数，您可以得到完整的命令行参数的列表及这些参数作用的简单描述。

PHP 的命令行模式能使得 PHP 脚本能完全独立于 WEB 服务器单独运行。如果您使用 Unix 系统，您需要在您的 PHP 脚本的最前面加上一行特殊的代码，使得它能够被执行，这样系统就能知道用什么样的程序要运行该脚本。在 Windows 平台下您可以将 php.exe 和 .php 文件的双击属性相关联，您也可以编写一个批处理文件来用 PHP 执行脚本。为 Unix 系统增加的第一行代码不会影响该脚本在 Windows 下的运行，因此您也可以用该方法编写跨平台的脚本程序。以下是一个简单的PHP 命令行程序的范例。

例子 23-1. 试图以命令行方式运行的 PHP 脚本（script.php）
#!/usr/bin/php<?phpif ($argc != 2 || in_array($argv[1], array(&#39;--help&#39;, &#39;-help&#39;, &#39;-h&#39;, &#39;-?&#39;))) 
{?>This is a command line PHP script with one option.  Usage:  <?php echo $argv[0]; ?> <option> 
 <option> can be some word you would like  to print out. With the --help, -help, -h,  or -? 
 options, you can get this help.<?php} else {    echo $argv[1];}?>

로그인 후 복사

在以上脚本中，我们用第一行特殊的代码来指明该文件应该由 PHP 来执行。我们在这里使用 CLI 的版本，因此不会有 HTTP 头信息输出。在您用 PHP 编写命令行应用程序时，您可以使用两个参数：$argc 和 $argv。前面一个的值是比参数个数大 1 的整数（运行的脚本本身的名称也被当作一个参数）。第二个时包含有参数的数组，其第一个元素为脚本的名称，下标为数字 0（$argv[0]）。

在以上程序中我们检查了参数的个数是大于 1 个还是小于 1 个。即时参数是 --help、-help、-h 或 -?，我们仍然打印出帮助信息，并同时动态输出脚本的名称。如果还收到了其它参数，我们也把它们显示出来。

如果您希望在 Unix 下运行以上脚本，您需要使得它成为可执行脚本，然后简单的运行 script.php echothis 或 script.php -h。在 Windows 下，您可以为此编写一个批处理文件：

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

로그인 후 복사