PHP 명령줄 실행 예-PHP 튜토리얼-php.cn

이 문서에서는 주로 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 '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 코드를 얻는 데 다음과 같은 세 가지 방법이 있습니다.

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

PHP가 지정된 파일을 실행하게 하세요.

php my_script.php 
php -f  "my_script.php"

로그인 후 복사

위의 두 방법 모두(-f 매개변수 유무에 관계없이) 주어진 my_script.php 파일을 실행할 수 있습니다. 실행할 파일을 선택할 수 있습니다. 지정하는 PHP 스크립트에는 .php 확장자가 없어도 됩니다.

명령줄에서 직접 PHP 코드를 실행하세요.

php -r "print_r(get_define_constants());"

이 방법을 사용할 때 쉘 변수 대체 및 따옴표 사용에 주의하세요.

참고: 위의 예를 주의 깊게 읽어보세요. 코드를 실행할 때 시작 및 끝 표시가 없습니다! -r 매개변수를 사용하면 이러한 표시가 필요하지 않으며 구문 오류가 발생합니다.

표준 입력(stdin)을 통해 실행해야 하는 PHP 코드를 제공하세요.

위의 사용법은 매우 강력한 기능을 제공하므로 다음 예와 같이 PHP 코드를 동적으로 생성하고 명령줄을 통해 이러한 코드를 실행할 수 있습니다.

$ some_application | php sort -u >final_output. txt

위의 세 가지 코드 실행 방법은 동시에 사용할 수 없습니다.

모든 셸 애플리케이션과 마찬가지로 PHP 바이너리(php.exe 파일)와 이 애플리케이션이 실행하는 PHP 스크립트는 일련의 매개변수를 받아들일 수 있습니다. PHP는 스크립트에 전달되는 인수 수에 제한이 없습니다(셸에는 명령줄의 문자 수에 제한이 있지만 일반적으로 이 제한을 초과하지 않습니다). 스크립트에 전달된 인수는 전역 변수 $argv에서 사용할 수 있습니다. 이 배열의 인덱스가 0인 멤버는 스크립트의 이름입니다(PHP 코드가 표준 입력에서 제공되고 -r 매개변수를 사용하여 명령줄에서 직접 실행되는 경우 이름은 "-"입니다). 또한 전역 변수 $argc는 $argv 배열의 멤버 변수 수를 저장합니다(스크립트 프로그램에 전달된 매개변수 수가 아님).

스크립트에 보내는 매개변수가 - 기호로 시작하지 않는 한, 어떤 것에도 너무 많은 주의를 기울일 필요가 없습니다. -로 시작하는 매개변수를 스크립트에 전달하면 PHP가 이러한 매개변수를 자체적으로 처리해야 한다고 생각하기 때문에 오류가 발생합니다. 이 문제를 해결하려면 매개변수 목록 구분 기호를 사용할 수 있습니다. 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"
}

로그인 후 복사

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

로그인 후 복사

보시다시피 -로 시작하는 매개변수를 스크립트에 전달하면 스크립트가 계속 정상적으로 실행될 수 있습니다.

-------------------------------------- --------명령 옵션--------------- ---- ---------------------

표 23-3 명령줄 옵션

옵션 이름

설명

-s

구문 강조 기능을 사용하여 소스 파일을 표시합니다.

이 매개변수는 내장된 메커니즘을 사용하여 파일을 구문 분석하고 HTML 강조 버전을 생성한 후 결과를 표준 출력에 기록합니다. 이 모든 프로세스는 [...] 태그 블록을 생성하며 HTML 헤더를 포함하지 않습니다.

참고: 이 옵션은 -r 매개변수와 동시에 사용할 수 없습니다.

-w

주석과 공백이 제거된 소스 코드를 표시합니다.

참고: 이 옵션은 -r 매개변수와 함께 사용할 수 없습니다.

-f

주어진 파일 이름을 구문 분석하고 실행합니다. 이 매개변수는 선택사항이며 생략할 수 있습니다. 실행해야 하는 파일의 이름만 지정하면 됩니다.

-v

PHP, PHP SAPI, Zend의 버전 정보를 표준 출력에 씁니다. 예:

-c

사용 이 매개변수의 경우 php.ini 파일이 있는 디렉토리를 지정하거나 파일 이름이 php.ini가 아닐 수 있는 사용자 정의 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") var_dump($foo) "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");' string(2) "20" $ php -d max_execution_time=doesntmakesense -r '$foo = ini_get ( "max_execution_time"); var_dump($foo);' 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 모듈] xml 토크나이저 표준 세션 posix pcreoverload mysql mbstring ctype [Zend Modules ]

-i 이 명령줄 매개변수는 phpinfo() 함수를 호출하고 결과를 인쇄합니다. PHP가 제대로 작동하지 않는 경우 php -i 명령을 실행하여 정보 테이블의 앞이나 해당 위치에 오류 메시지가 출력되는지 확인하는 것이 좋습니다. 출력 내용이 HTML 형식이므로 출력 정보가 더 크다는 점에 유의하시기 바랍니다.

-r

명령줄에서 PHP 코드를 실행하려면 이 매개변수를 사용하세요. PHP 시작 및 끝 식별자()를 추가할 필요가 없습니다. 그렇지 않으면 구문 분석 오류가 발생합니다.

참고: 이 형태의 PHP를 사용할 때는 쉘 환경에서 수행되는 명령줄 매개변수 대체와의 충돌을 피하기 위해 특별한 주의를 기울여야 합니다.

구문 구문 분석 오류를 보여주는 예

$ php -r "$foo = get_define_constants();" 명령줄 코드(1) : 구문 분석 오류 - 구문 분석 오류, 예기치 않은 '='

여기서 문제는 큰따옴표를 즉시 사용한다는 것입니다. ", sh/bash는 여전히 매개변수 대체를 구현합니다. $foo가 정의되지 않았기 때문에 해당 위치는 대체된 후 널 문자가 됩니다. 따라서 런타임 시 PHP가 실제로 읽는 코드는 다음과 같습니다.

$ php - r " = get_defined_constants( );"

올바른 방법은 작은따옴표'를 사용하는 것입니다. 작은따옴표로 묶인 문자열에서는 변수가 sh/bash에 의해 원래 값으로 복원되지 않습니다.

$ php -r '$.foo = get_define_constants( ); var_dump($foo);' 배열(370) { ["E_ERROR"]=> int(1) ["E_WARNING"]=> ["E_NOTICE"]=> int(8) ["E_CORE_ERROR"]=> [...]

sh/bash 이외의 쉘을 사용하는 경우 다른 문제가 발생할 수 있습니다. 또는 phpdoc@lists.php.net으로 이메일을 보내십시오.

쉘 환경 변수를 말에 도입하거나 백슬래시를 사용하여 문자를 이스케이프 처리할 때 다양한 문제가 발생할 수도 있습니다.

참고: -r을 사용하세요. CLI SAPI에서는 유효하고 CGI SAPI에서는 유효하지 않습니다.

-h 이 매개변수를 사용하면 명령줄 매개변수의 전체 목록을 얻을 수 있습니다.

PHP의 명령줄 모드에서는 PHP 스크립트가 허용됩니다. 웹 서버와 완전히 독립적으로 실행하려면 PHP 스크립트 시작 부분에 특수 코드 줄을 추가하여 시스템이 실행하는 데 사용할 프로그램을 알 수 있도록 해야 합니다. Windows 플랫폼에서는 php.exe 및 .php 파일의 두 번 클릭 속성을 연결하거나 이를 위해 배치 파일을 작성할 수 있습니다. Unix 시스템에 추가된 첫 번째 코드 줄은 그렇지 않습니다. Windows에서 스크립트 실행에 영향을 미치므로 이 방법을 사용하여 크로스 플랫폼 스크립트를 작성할 수도 있습니다. 다음은 간단한 PHP 명령줄 프로그램의 예입니다. 명령줄의 스크립트(script.php)

#!/usr/bin/php이것은 하나의 옵션이 있는 명령줄 PHP 스크립트입니다. 사용법: ;option>은 인쇄하려는 단어일 수 있습니다. --help, -h 또는 -? 옵션을 사용하면 이 도움말을 얻을 수 있습니다.< ;?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:phpcliphp.exe script.php %1 %2 %3 %4