Module mod_cgi

이 모듈은 CGI 스크립트의 실행을 가능하게 합니다. mod_cgi.c 에 포함되어 있으며 기본으로 컴파일 되어 있습니다. 컨텐츠 형식(MIME)이 application/x-httpd-cgi 로 가진 파일은 어떤것이든 이 모듈에 의해 수행됩니다.

Summary - 요약

컨텐츠형식(MIME)을 application/x-httpd-cgi 나 핸들러 cgi-script 를 가진 파일은 CGI 스크립트로 처립됩니다. 그리고 서버에 의해서 그 결과(output)를 클라이언트에게 돌려주게 됩니다. 파일은 AddType 선언 이나 핸들러 선언에서 정의된 확장자를 가지고 있는지와 ScriptAlias 디렉토리(EexcCGI 옵션) 안에 존재해야만 서버에서 스크립트를 실행하도록 받아 들입니다.

서버가 CGI스크립트를 불러올때 , 문서루트(DOCUMENT_ROOT)의 환경에서 읽어온 변수들을 추가 합니다. 이 변수들은 문서루트(DocumentRoot)의 환경변수의 값을 포함합니다.

CGI Environment variables - 환경변수들

다음의 단서와 함께 서버는 CGI 규약 - CGI specification 에 따르는 CGI환경변수를 지정합니다.

REMOTE_HOST: 이것은 HostnameLookups 선언이 on 으로 되어 있을 경우만 설정됩니다, 그리고 이것은 접근하는 호스트 주소의 상반된 DNS 조사가 호스트 이름을 진짜로 발견하여야만 비로소 설정될 것입니다. HostnameLookups 의 기본값은 off
REMOTE_IDENT: 이것은 IdentityCheck on 이고 접근하는 호스트는 동일한 형태의 프로토콜(ident protocol)을 지원해야 설정됩니다.
NOTE: 이 변수의 내용들이 그것이 쉽게 위조될 수 있기 때문에에 의존할 수 없습니다. 그리고 만약 프락시가 클라이언트와 서버사이에 있으면, 그것은 보통 전적으로 쓸모 없습니다.
REMOTE_USER: 이것은 단지 CGI스크립트가 인증을 위임하였을 경우에만 설정 됩니다

CGI Debugging

주로 알맞게 실행하지 않고 있는 스크립트들에 대한 출력(output)을( standard output and error ) 연구하는 것은 가능하지 않았기 때문에, CGI 스크립트를 디버깅 하는 것은 쉽지 않습니다. 아래의 선언은 에러에 대한 조금 자세한 기록(로깅)을 제공합니다.(Apache 1.2 이후 )

CGI Logfile Format

기본값으로 알맞게 실행하지 않은 CGI는 기록하지 않습니다.
조작(operation)에 실패한 각 CGI 스크립트는 몇줄의 정보가 기록되도록 합니다.
그 1번째 2 선들 형식(format)은 항상 다음과 같습니다.

  %% [time] request-line
  %% HTTP-status CGI-script-filename

만약 에러가 CGI스크립트를 실행하지 못하였다면 다음 두줄을 로그파일에 포함합니다.:

  %%error
  error-message

또 다른 방법으로, 만약 그 에러가 부정확 한 머리말 정보를(스크립트중에 버그로 인해 종종) 돌려준 스크립트의 결과이면, 그 정보는 다음과 같이 기록됩니다 :

  %request
  All HTTP request headers received
  POST or PUT entity (if any)
  %response
  All headers output by the CGI script
  %stdout
  CGI standard output
  %stderr
  CGI standard error

(The %stdout and %stderr parts may be missing if the script did not output anything on standard output or standard error).

Directives - 선언

ScriptLog

Syntax: ScriptLog filename
Default: none
Context: server config
Status: mod_cgi

ScriptLog 선언은 CGI 스크립트 에러 logfile을 지정합니다. 만약 ScriptLog 값이 주어지지 않으면, 에러 로그는 생성되지 않습니다. 주어진다면, CGI 에러들은 인수로 주어진 파일 이름(filename)에 기록됩니다. 만약 이것이 상대적 파일 혹은 경로이면, 그것은 서버 루트에 관하여 얻어집니다.

This log will be opened as the user the child processes run as, ie. the user specified in the main User directive. This means that either the directory the script log is in needs to be writable by that user or the file needs to be manually created and set to be writable by that user. If you place the script log in your main logs directory, do NOT change the directory permissions to make it writable by the user the child processes run as.

NOTE : 아파치 서버가 실행되어 있을때 에러로그를 비롯한 다른 로그파일들은 삭제 할 수 없지만 이 스크립트 로그 파일은 삭제 할 수 있습니다. 이 스크립트 로그 파일은 디버깅을 위해 잘못된 CGI 를 수행했을 경우에만 사용되는 것을 의미합니다. 스크립트 로그는 속도나 효율에 있어서 최적화되지 않았습니다, 그리고 디자인한 의도대로 사용되지 않을 경우 보안 문제들을 가지고 있을지도 모릅니다.

ScriptLogLength

Syntax: ScriptLogLength size
Default: 10385760
Context: server config
Status: mod_cgi

ScriptLogLength 는 CGI 스크립트 logfile의 크기를 제한하는 것으로 사용됩니다.
CGI 에러에(모두 요구 머리말들, 모두 스크립트 출력) 대하여 많은 정보가 쌓인 logfile 의 크기가 증대될 수 있습니다.한정되지않은 성장으로 인한 문제들을 막기 위하여, 이 선언은 CGI logfile를 위해 최대 파일 크기를 설정하는 것으로 사용됩니다. 만약 그 파일이 이 크기를 초과하면, 더이상 정보는 그것에 기록되지 않을 것입니다.

ScriptLogBuffer

Syntax: ScriptLogBuffer size
Default: 1024
Context: server config
Status: mod_cgi

파일에 기록된 어떠한 PUT 혹은 POST 엔티티 몸체의 크기를 제한합니다. 만약 큰 용량들이 빠르게 받아지고 있으면 너무 크게 증대된 로그 파일을 막기 위하여 제한됩니다. 기본값으로 1024 byte 까지만 기록되지만, 이것은 이 선언에서 바꿀 수 있습니다.