설명
resource proc_open ( string $cmd , array $descriptorspec , array &$pipes [, string $cwd [, array $env [, array $other_options ]]] )
proc_open() 이라popen() 고 잘 닮았지만 프로그램의 실행을 더 가늘게 제어할 수 있는 점에서 다릅니다.
파라미터
cmd
실행되는 명령.
descriptorspec
수치 첨자 배열로, 디스크 리프 다음 번호를 키다며 PHP가 그 디스크 리프 정보를 어떻게 자식 프로세스에 전달하는지를 나타내는 것이 대응하는 값입니다. 0이 표준 입력(stdin), 1이 표준 출력(stdout)이며, 2이 표준 오류 출력(stderr)입니다.
각 요소는 다음과 같습니다.
프로세스에 전달 채널을 나타내는 배열. 첫번째 요소는 디스크 리프 타의 형태로, 2번째 요소가 그 틀에 맞는 옵션입니다. 사용할 수 있는 형은pipe (2번째 요소는 프로세스에 파이프의 읽기 측을 건넨다면r 글 쪽을 건넨다면w) 및file (2번째 요소는 파일명) 입니다.
실제 파일 디스크 리프 다(오픈한 파일이나 소켓, STDIN 등)을 나타내는 스트림 자원.
파일 디스크 리프 타의 번호는 특히 0, 1, 2에 국한된 것에서는 없습니다. 유효하다 어떠한 파일 디스크 리프 타의 번호도 지정할 수 있고, 그것은 자식 프로세스에 전달됩니다. 이로써 한 스크립트와, 자식 프로세스로서 실행하고 있는 또 다른 스크립트와 사이에서 통신을 할 수 있습니다. 특히 이는 PGP나 GPG, openssl등의 프로그램에 패스 프레이즈를 보다 안전한 방법으로 주고 싶을 때 위력을 발휘합니다. 보조적인 파일 디스크 리프 정보를 통해서 그런 프로그램 상태를 취득하는 데도 편리합니다.
pipes
PHP측에서 생성된 파이프의 끝에 해당하는 파일 포인터의 배열.
cwd
명령의 초기 작업 디렉토리. 완전 패스인 필요가 있습니다. 기본 값(현재의 PHP프로세스의 작업 디렉토리)를 사용하고 싶다면 NULL 를 지정합니다.
env
실행하는 명령을 위한 환경 변수의 배열. 현재의 PHP프로세스와 같은 환경 변수를 사용하는 경우는 NULL 를 지정합니다.
other_options
기타 추가 옵션을 지정할 수 있습니다. 현재 지원되고 있는 옵션은 다음과 같습니다.
suppress_errors (windows만): TRUE 로 하면 이 함수가 출력하는 에러를 억제합니다.
bypass_shell (windows만): TRUE 로 하면,cmd.exe 껍질을 우회합니다.
반환 값
프로세스를 나타내는 리소스를 갚겠습니다. 이 리소스는, 사용이 종료된 때 proc_close() 를 사용하고 개방할 필요가 있습니다. 실패했을 경우FALSE 를 갚겠습니다.
변경 이력
버전 설명
5.2.1 other_options 파라미터에 옵션이bypass_shell 추가되었습니다.
예
사례 1 Aproc_open() 의 예
if (is_resource($process)) {
// $pipes 은 이 시점에서 다음과 같은 형태를 취하고 있습니다.
// 0 => 자식 프로세스의 수는 nbsp;stdin 에 연결된 글 가능한 핸들
// 1 => 자식 프로세스의 수는 nbsp;stdout 에 연결된 읽기 가능한 핸들
// 모든 에러 출력은 nbsp;/tmp/error-output.txt 에 기입됩니다.
Windows의 호환성:2(stderr)보다 큰 번호의 디스크 리프 타는 자식 프로세스에 승계 가능한 핸들로 건너가지만 Windows의 아키텍처는 파일 디스크 리프 타의 번호와 더 저질 핸들과 관련 짓지 않아 자식 프로세스는 그것들의 핸들에 접속하는 법을 가지지 않습니다. stdin, stdout, stderr 는 기대대로 움직입니다.
주의:
만약 단 방향(한 방향)의 파이프를 이용할 뿐이라면 popen() 를 쓰는 게 더 간단합니다.