mirror of
				https://github.com/apache/httpd.git
				synced 2025-10-30 08:05:39 +03:00 
			
		
		
		
	git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1673947 13f79535-47bb-0310-9956-ffa450edef68
		
			
				
	
	
		
			520 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			520 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
| <?xml version='1.0' encoding='EUC-KR' ?>
 | |
| <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 | |
| <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
 | |
| <!-- English Revision: 105989:1673945 (outdated) -->
 | |
| 
 | |
| <!--
 | |
|  Licensed to the Apache Software Foundation (ASF) under one or more
 | |
|  contributor license agreements.  See the NOTICE file distributed with
 | |
|  this work for additional information regarding copyright ownership.
 | |
|  The ASF licenses this file to You under the Apache License, Version 2.0
 | |
|  (the "License"); you may not use this file except in compliance with
 | |
|  the License.  You may obtain a copy of the License at
 | |
| 
 | |
|      http://www.apache.org/licenses/LICENSE-2.0
 | |
| 
 | |
|  Unless required by applicable law or agreed to in writing, software
 | |
|  distributed under the License is distributed on an "AS IS" BASIS,
 | |
|  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | |
|  See the License for the specific language governing permissions and
 | |
|  limitations under the License.
 | |
| -->
 | |
| 
 | |
| <manualpage metafile="cgi.xml.meta">
 | |
|   <parentdocument href="./">How-To / Tutorials</parentdocument>
 | |
| 
 | |
|   <title>아파치 투토리얼: CGI를 사용한 동적 페이지 생성</title>
 | |
| 
 | |
|   <section id="intro">
 | |
|     <title>소개</title>
 | |
| 
 | |
|     <related>
 | |
|       <modulelist>
 | |
|         <module>mod_alias</module>
 | |
|         <module>mod_cgi</module>
 | |
|       </modulelist>
 | |
| 
 | |
|       <directivelist>
 | |
|         <directive module="mod_mime">AddHandler</directive>
 | |
|         <directive module="core">Options</directive>
 | |
|         <directive module="mod_alias">ScriptAlias</directive>
 | |
|       </directivelist>
 | |
|     </related>
 | |
| 
 | |
|     <p>CGI (Common Gateway Interface)는 웹서버가 보통 CGI 프로그램
 | |
|     혹은 CGI 스크립트라고 부르는, (웹페이지 내용을 만드는) 외부
 | |
|     프로그램과 통신하는 방법을 정의한다. 웹사이트에서 동적인
 | |
|     페이지를 만드는 가장 흔하고 간단한 방법이다. 이 문서는 아파치
 | |
|     웹서버에 CGI를 구성하는 방법을 소개하고, CGI 프로그램을
 | |
|     작성해본다.</p>
 | |
|   </section>
 | |
| 
 | |
|   <section id="configuring">
 | |
|     <title>CGI를 허용하도록 아파치 설정하기</title>
 | |
| 
 | |
|     <p>CGI 프로그램이 올바로 동작하려면 CGI 실행이 가능하도록
 | |
|     아파치를 설정해야 한다. 설정하는 방법은 여러가지다.</p>
 | |
| 
 | |
|     <section id="scriptalias">
 | |
|       <title>ScriptAlias</title>
 | |
| 
 | |
|       <p><directive module="mod_alias">ScriptAlias</directive>
 | |
|       지시어를 사용하면 아파치는 특정 디렉토리를 CGI 프로그램용으로
 | |
|       둔다. 아파치는 이 디렉토리에 있는 모든 파일이 CGI
 | |
|       프로그램이라고 가정하여 클라이언트가 자원을 요청하면 자원을
 | |
|       실행하려고 시도한다.</p>
 | |
| 
 | |
|       <p><directive module="mod_alias">ScriptAlias</directive>
 | |
|       지시어는 다음과 같이 사용한다.</p>
 | |
| 
 | |
|       <example>
 | |
|         ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
 | |
|       </example>
 | |
| 
 | |
|       <p>위 예제는 아파치를 기본 장소에 설치한 경우
 | |
|       <code>httpd.conf</code> 설정파일에 있는 내용이다. <directive
 | |
|       module="mod_alias">ScriptAlias</directive> 지시어는 <directive
 | |
|       module="mod_alias">Alias</directive> 지시어와 같이 URL
 | |
|       앞부분을 특정 디렉토리로 대응한다.
 | |
|       <directive>Alias</directive>와
 | |
|       <directive>ScriptAlias</directive>는 보통 <directive
 | |
|       module="core">DocumentRoot</directive> 디렉토리 밖에 있는
 | |
|       디렉토리에 사용한다. <directive>Alias</directive>와
 | |
|       <directive>ScriptAlias</directive>의 차이점은
 | |
|       <directive>ScriptAlias</directive>가 추가로 URL 앞부분으로
 | |
|       시작하는 모든 파일을 CGI 프로그램으로 취급하는 점이다.
 | |
|       그래서 위의 설정은 아파치에게 <code>/cgi-bin/</code>으로
 | |
|       시작하는 자원을 요청하면
 | |
|       <code>/usr/local/apache2/cgi-bin/</code> 디렉토리에서
 | |
|       찾아서 CGI 프로그램으로 처리하라고 알린다.</p>
 | |
| 
 | |
|       <p>예를 들어, URL
 | |
|       <code>http://www.example.com/cgi-bin/test.pl</code>을
 | |
|       요청하면 아파치는
 | |
|       <code>/usr/local/apache2/cgi-bin/test.pl</code> 파일을
 | |
|       실행하여 결과를 반환한다. 물론 파일이 존재하고 실행가능하며
 | |
|       어떤 방법으로든 출력을 해야 한다. 그렇지 않으면 아파치는
 | |
|       오류문을 보낸다.</p>
 | |
|     </section>
 | |
| 
 | |
|     <section id="nonscriptalias">
 | |
|       <title>ScriptAlias 디렉토리 밖에 있는 CGI</title>
 | |
| 
 | |
|       <p>보통 보안상 이유때문에 CGI 프로그램은 <directive
 | |
|       module="mod_alias">ScriptAlias</directive>한 디렉토리에
 | |
|       한정한다. 그래서 관리자는 누가 CGI 프로그램을 사용할 수
 | |
|       있는지 엄격히 감독할 수 있다. 그러나 적당한 보안조치를
 | |
|       취했다면 아무 디렉토리에서나 CGI 프로그램을 실행하지 않을
 | |
|       이유가 없다. 예를 들어, <directive
 | |
|       module="mod_userdir">UserDir</directive> 지시어를 사용하여
 | |
|       사용자가 자신의 홈디렉토리에 웹페이지를 가지는 경우를
 | |
|       가정하자. 사용자가 자신의 CGI 프로그램을 사용하고 싶은데
 | |
|       <code>cgi-bin</code> 디렉토리에 접근권한이 없다면, 다른
 | |
|       곳에서라도 CGI 프로그램을 실행하고 싶을 것이다.</p>
 | |
| 
 | |
|       <p>아무 디렉토리에서나 CGI 실행을 허용하려면 두 과정이
 | |
|       필요하다. 먼저, <directive
 | |
|       module="mod_mime">AddHandler</directive>나 <directive
 | |
|       module="core">SetHandler</directive> 지시어를 사용하여
 | |
|       <code>cgi-script</code> 핸들러를 작동해야 한다. 두번째로,
 | |
|       <directive module="core">Options</directive> 지시어에
 | |
|       <code>ExecCGI</code>를 지정해야 한다.</p>
 | |
|     </section>
 | |
| 
 | |
|     <section id="options">
 | |
|       <title>Options를 사용하여 명시적으로 CGI 실행을 허용하기</title>
 | |
| 
 | |
|       <p>서버의 주설정파일에 직접 <directive
 | |
|       module="core">Options</directive> 지시어를 사용하여 특정
 | |
|       디렉토리에서 CGI 실행을 허용할 수 있다.</p>
 | |
| 
 | |
|       <example>
 | |
|         <Directory /usr/local/apache2/htdocs/somedir><br />
 | |
|         <indent>
 | |
|           Options +ExecCGI<br />
 | |
|         </indent>
 | |
|         </Directory>
 | |
|       </example>
 | |
| 
 | |
|       <p>위 지시어로 아파치는 CGI 파일의 실행을 허용한다. 어떤
 | |
|       파일이 CGI 파일인지도 서버에게 알려야 한다. 다음 <directive
 | |
|       module="mod_mime">AddHandler</directive> 지시어는 서버에게
 | |
|       확장자가 <code>cgi</code>나 <code>pl</code>인 파일은 모두
 | |
|       CGI 프로그램이라고 알린다.</p>
 | |
| 
 | |
|       <example>
 | |
|         AddHandler cgi-script .cgi .pl
 | |
|       </example>
 | |
|     </section>
 | |
| 
 | |
|     <section id="htaccess">
 | |
|       <title>.htaccess 파일</title>
 | |
| 
 | |
|       <p><a href="htaccess.html"><code>.htaccess</code> 투토리얼</a>은
 | |
|       <code>httpd.conf</code>에 접근권한이 없는 경우에 CGI 프로그램을
 | |
|       사용할 수 있는 방법을 알려준다.</p>
 | |
|     </section>
 | |
| 
 | |
|     <section id="userdir">
 | |
|       <title>사용자 디렉토리</title>
 | |
| 
 | |
|       <p>아래 설정을 사용하면 사용자 디렉토리에서 <code>.cgi</code>로
 | |
|       끝나는 파일을 CGI 프로그램으로 실행한다.</p>
 | |
| 
 | |
|       <example>
 | |
|       <Directory /home/*/public_html><br/>
 | |
|       <indent>
 | |
|         Options +ExecCGI<br/>
 | |
|         AddHandler cgi-script .cgi<br/>
 | |
|       </indent>
 | |
|       </Directory>
 | |
|       </example>
 | |
| 
 | |
|       <p>다음을 사용하면 사용자 디렉토리의 <code>cgi-bin</code>
 | |
|       하위디렉토리에 있는 모든 파일을 CGI 프로그램으로 인식한다.</p>
 | |
| 
 | |
|       <example>
 | |
|       <Directory /home/*/public_html/cgi-bin><br/>
 | |
|       <indent>
 | |
|         Options ExecCGI<br/>
 | |
|         SetHandler cgi-script<br/>
 | |
|       </indent>
 | |
|       </Directory>
 | |
|       </example>
 | |
| 
 | |
|     </section>
 | |
| 
 | |
|   </section>
 | |
| 
 | |
|   <section id="writing">
 | |
|     <title>CGI 프로그램 작성하기</title>
 | |
| 
 | |
|     <p>``일반적인'' 프로그래밍과 CGI 프로그래밍 사이에는 두가지
 | |
|     주된 차이점이 있다.</p>
 | |
| 
 | |
|     <p>첫번째 차이는 CGI 프로그램은 다른 출력을 하기전에 먼저
 | |
|     MIME-type 헤더를 출력해야 한다는 점이다. HTTP 헤더는
 | |
|     클라이언트에게 클라이언트가 어떤 내용을 받게될지 미리 알린다.
 | |
|     보통 다음과 같다.</p>
 | |
| 
 | |
|     <example>
 | |
|       Content-type: text/html
 | |
|     </example>
 | |
| 
 | |
|     <p>두번째 차이는 HTML 혹은 브라우저가 보여줄 수 있는 형식으로
 | |
|     출력해야 한다는 점이다. 대부분의 경우 HTML을 출력하지만,
 | |
|     때때로 gif 그림과 같이 HTML이 아닌 내용을 출력하는 CGI
 | |
|     프로그램을 작성하는 경우도 있다.</p>
 | |
| 
 | |
|     <p>두가지를 제외하고는 CGI 프로그램 작성은 이미 만들어 보았을
 | |
|     다른 프로그램들과 매우 비슷하다.</p>
 | |
| 
 | |
|     <section id="firstcgi">
 | |
|       <title>처음으로 만든 CGI 프로그램</title>
 | |
| 
 | |
|       <p>다음은 브라우저에 한 줄을 찍는 CGI 프로그램 예제다.
 | |
|       그대로 <code>first.pl</code>이라는 파일에 저장하고,
 | |
|       <code>cgi-bin</code> 디렉토리에 복사한다.</p>
 | |
| 
 | |
|       <example>
 | |
|         #!/usr/bin/perl<br />
 | |
|         print "Content-type: text/html\n\n";<br />
 | |
|         print "Hello, World.";
 | |
|       </example>
 | |
| 
 | |
|       <p>Perl에 익숙하지 않더라도 무슨 일이 일어나는지 알 수
 | |
|       있다. 첫번째 줄은 아파치(혹은 사용하는 쉘)에게
 | |
|       <code>/usr/bin/perl</code> 위치에 있는 인터프리터을 사용하여
 | |
|       이 프로그램 파일을 실행하라고 알린다. 두번째 줄은 방금
 | |
|       말한 content-type 선언을 출력하고 carriage-return 줄바꿈을
 | |
|       두번 출력한다. 그러면 헤더 뒤에 HTTP 헤더의 끝을 뜻하는
 | |
|       빈줄이 생기고, 본문이 시작한다. 세번째 줄은 "Hello, World."
 | |
|       문자열을 출력한다. 이것으로 끝이다.</p>
 | |
| 
 | |
|       <p>브라우저를 실행하고 주소를 입력한다</p>
 | |
| 
 | |
|       <example>
 | |
|         http://www.example.com/cgi-bin/first.pl
 | |
|       </example>
 | |
| 
 | |
|       <p>파일 장소를 입력하면, 브라우저창에 <code>Hello, World.</code>
 | |
|       한 줄이 보인다. 흥분되지는 않지만, 한번 동작하는 것을
 | |
|       보았으니 이제 다른 것을 시도해 볼 수 있다.</p>
 | |
|     </section>
 | |
|   </section>
 | |
| 
 | |
|   <section id="troubleshoot">
 | |
|     <title>그러나 아직 동작하지 않아요!</title>
 | |
| 
 | |
|     <p>웹에서 CGI 프로그램에 접근할때 브라우저에 나올 수 있는
 | |
|     내용은 기본적으로 네가지다.</p>
 | |
| 
 | |
|     <dl>
 | |
|       <dt>CGI 프로그램의 출력</dt>
 | |
|       <dd>좋다! 모든 것이 잘 동작한다는 뜻이다. 출력은 정확하지만
 | |
|       브라우저가 올바로 처리하지 못한다면, CGI 프로그램에서
 | |
|       올바른 <code>Content-Type</code>을 설정하였는지 확인한다.</dd>
 | |
| 
 | |
|       <dt>CGI 프로그램 소스코드 혹은 "POST Method Not Allowed"
 | |
|       문구</dt>
 | |
|       <dd>CGI 프로그램을 실행하도록 아파치를 적절히 설정하지
 | |
|       않았다는 뜻이다. <a href="#configuring">아파치 설정하기</a>
 | |
|       절을 다시 읽고 빼먹은 부분이 있는지 찾아봐라.</dd>
 | |
| 
 | |
|       <dt>"Forbidden"으로 시작하는 문구</dt>
 | |
|       <dd>권한 문제가 있다는 뜻이다. <a href="#errorlogs">아파치
 | |
|       오류 로그</a>와 아래 <a href="#permissions">파일권한</a>
 | |
|       절을 확인하라.</dd>
 | |
| 
 | |
|       <dt>"Internal Server Error"라는 문구</dt>
 | |
|       <dd><a href="#errorlogs">아파치 오류 로그</a>를 보면 아마도
 | |
|       CGI 프로그램이 출력한 오류문과 함께 "Premature end of
 | |
|       script headers"가 보일 것이다. 이 경우 아래 내용들을 하나씩
 | |
|       확인하여 어떤 이유로 CGI 프로그램이 적절한 HTTP 헤더를
 | |
|       출력하지 못했는지 알아본다.</dd>
 | |
|     </dl>
 | |
| 
 | |
|     <section id="permissions">
 | |
|       <title>파일권한</title>
 | |
| 
 | |
|       <p>서버는 당신과 동일한 계정으로 동작하지 않음을 명심하라.
 | |
|       즉, 서버가 시작하면 서버는 비특권 사용자 권한(보통
 | |
|       <code>nobody</code>나 <code>www</code>)으로 동작한다.
 | |
|       그래서 당신이 소유한 파일을 실행하려면 권한이 필요하다.
 | |
|       파일에 <code>nobody</code>가 실행하기에 충분한 권한을
 | |
|       주기위해 보통 모두에게 파일의 실행 권한을 준다.</p>
 | |
| 
 | |
|       <example>
 | |
|         chmod a+x first.pl
 | |
|       </example>
 | |
| 
 | |
|       <p>또, 프로그램이 다른 파일을 읽거나 쓴다면 이 파일에도
 | |
|       적절한 권한이 필요하다.</p>
 | |
| 
 | |
|     </section>
 | |
| 
 | |
|     <section id="pathinformation">
 | |
|       <title>경로 정보와 환경</title>
 | |
| 
 | |
|       <p>명령행에서 프로그램을 실행하면 자동으로 어떤 정보가
 | |
|       쉘로 전달된다. 예를 들어, <code>PATH</code>는 쉘에게 당신이
 | |
|       말한 파일을 찾을 장소를 알려준다.</p>
 | |
| 
 | |
|       <p>웹서버가 프로그램을 CGI 프로그램으로 실행할때는
 | |
|       <code>PATH</code>가 다를 수 있다. (예를 들어,
 | |
|       <code>sendmail</code> 같이) CGI 프로그램 안에서 실행하는
 | |
|       명령어는 완전한 경로로 명시해야 쉘이 명령어를 찾을 수
 | |
|       있다.</p>
 | |
| 
 | |
|       <p>경로 문제는 다음과 같이 CGI 프로그램 첫번째 줄에 나오는
 | |
|       스크립트 인터프리터 (보통 <code>perl</code>) 경로에서
 | |
|       자주 발생한다.</p>
 | |
| 
 | |
|       <example>
 | |
|         #!/usr/bin/perl
 | |
|       </example>
 | |
| 
 | |
|       <p>실제로 인터프리터의 경로인지 확인한다.</p>
 | |
| 
 | |
|       <p>또, CGI 프로그램이 다른 <a href="#env">환경변수</a>를
 | |
|       사용한다면 아파치가 이 변수들을 프로그램에게 전달해야
 | |
|       한다.</p>
 | |
| 
 | |
|     </section>
 | |
| 
 | |
|     <section id="syntaxerrors">
 | |
|       <title>프로그램 오류</title>
 | |
| 
 | |
|       <p>CGI 프로그램이 실패하는 경우 대부분 프로그램 자체
 | |
|       문제때문이다. 특히 위의 두가지 실수를 하지 않았고 이 글을
 | |
|       계속 보고 있다면 더더욱 그렇다. 먼저 웹서버에서 실행하기
 | |
|       전에 명령행에서 프로그램을 실행해본다. 예를 들어, 다음과
 | |
|       같이 실행한다.</p>
 | |
| 
 | |
|       <example>
 | |
|       cd /usr/local/apache2/cgi-bin<br/>
 | |
|       ./first.pl
 | |
|       </example>
 | |
| 
 | |
|       <p>(<code>perl</code> 인터프리터를 실행하지 마라. 쉘과
 | |
|       아파치는 스크립트 첫번째 줄에 있는 <a
 | |
|       href="#pathinformation">경로 정보</a>를 사용하여 인터프리터를
 | |
|       찾아야 한다.)</p>
 | |
| 
 | |
|       <p>프로그램은 제일 먼저 <code>Content-Type</code>을 포함한
 | |
|       HTTP 헤더들을 출력하고 빈 줄을 출력해야 한다. 다른 것을
 | |
|       출력한다면 웹서버에서 실행할 경우 아파치는 <code>Premature
 | |
|       end of script headers</code>를 반환한다. 자세한 내용은
 | |
|       위의 <a href="#writing">CGI 프로그램 작성하기</a>를 참고하라.</p>
 | |
|     </section>
 | |
| 
 | |
|     <section id="errorlogs">
 | |
|       <title>오류 로그</title>
 | |
| 
 | |
|       <p>오류 로그는 당신 편이다. 무언가 잘못되면 오류 로그에
 | |
|       문구가 생긴다. 오류 로그를 제일 먼저 살펴봐야 한다. 웹사이트를
 | |
|       호스팅하는 곳에서 오류 로그를 보지 못하게 한다면, 아마도
 | |
|       다른 업체를 알아봐야 한다. 오류 로그를 보는 방법을 익히면,
 | |
|       대부분의 문제를 빨리 파악하여 해결할 수 있다.</p>
 | |
|     </section>
 | |
| 
 | |
|     <section id="suexec">
 | |
|       <title>Suexec</title>
 | |
| 
 | |
|       <p><a href="../suexec.html">suexec</a> 지원 프로그램을
 | |
|       사용하면 어떤 가상호스트 혹은 어떤 사용자 디렉토리에 있는지에
 | |
|       따라 CGI 프로그램을 다른 사용자 권한으로 실행할 수 있다.
 | |
|       Suexec는 매우 엄격하게 권한을 검사하며, 검사를 하나라도
 | |
|       통과하지 못하면 CGI 프로그램을 실행하지 않고 <code>Premature
 | |
|       end of script headers</code>를 반환한다.</p>
 | |
| 
 | |
|       <p>suexec를 사용하고 있는지 알려면 <code>apachectl -V</code>를
 | |
|       실행하여 <code>SUEXEC_BIN</code> 위치를 확인한다. 아파치가
 | |
|       시작할때 그 장소에서 suexec 실행파일을 발견하면, suexec를
 | |
|       사용할 수 있다.</p>
 | |
| 
 | |
|       <p>suexec를 완전히 이해하지 못했다면 사용해서는 안된다.
 | |
|       suexec를 사용하지 않으려면 <code>SUEXEC_BIN</code> 위치에
 | |
|       있는 <code>suexec</code> 실행파일을 지우고 (혹은 파일명을
 | |
|       바꾸고) 서버를 재시작하면 된다. <a
 | |
|       href="../suexec.html">suexec</a>에 대해 읽은 다음 그래도
 | |
|       사용하고 싶다면, <code>suexec -V</code>를 실행하여 suexec
 | |
|       로그파일 위치를 알아내고 로그파일에서 당신이 어떤 규칙을
 | |
|       어기고 있는지 찾는다.</p>
 | |
|     </section>
 | |
|   </section>
 | |
| 
 | |
|   <section id="behindscenes">
 | |
|     <title>뒤에서는 무슨 일이 벌어지는가?</title>
 | |
| 
 | |
|     <p>CGI 프로그래밍에 익숙해질수록 뒤에서 벌어지는 일을 이해하면
 | |
|     도움이 된다. 구체적으로 브라우저와 서버가 서로 통신하는
 | |
|     방법을 말하는 것이다. 몰라도 "Hello, World."를 출력하는
 | |
|     프로그램을 작성할 수 있지만 이런 프로그램은 별로 쓸모가
 | |
|     없기때문이다.</p>
 | |
| 
 | |
|     <section id="env">
 | |
|       <title>환경변수</title>
 | |
| 
 | |
|       <p>환경변수는 당신이 컴퓨터를 사용하는 동안 당신 주위를
 | |
|       떠다니는 값이다. 환경변수는 path (컴퓨터가 당신이 입력한
 | |
|       명령어에 해당하는 실제 파일을 찾는 장소), 사용자명, 터미널
 | |
|       종류와 같이 유용한 정보다. 일반적인 환경변수를 모두 보려면
 | |
|       명령행 프롬프트에서 <code>env</code>를 입력한다.</p>
 | |
| 
 | |
|       <p>CGI를 실행할때도 서버와 브라우저는 각자의 환경변수를
 | |
|       서로 교환한다. 이 정보에는 브라우저 종류 (Netscape, IE,
 | |
|       Lynx), 서버 종류 (아파치, IIS, WebSite), 실행하는 CGI
 | |
|       프로그램명 등이 있다.</p>
 | |
| 
 | |
|       <p>CGI 프로그래머는 이런 변수들을 사용할 수 있고,
 | |
|       환경변수는 클라이언트-서버 통신에는 일부분을 차지한다.
 | |
|       전체 필수 변수 목록은 <a
 | |
|       href="http://hoohoo.ncsa.uiuc.edu/cgi/env.html"
 | |
|       >http://hoohoo.ncsa.uiuc.edu/cgi/env.html</a>에 있다.</p>
 | |
| 
 | |
|       <p>아래 간단한 Perl CGI 프로그램은 자신에게 전달된 모든
 | |
|       환경변수를 보여준다. 아파치 배포본의 <code>cgi-bin</code>
 | |
|       디렉토리에 이와 비슷한 프로그램이 두개 있다. 몇몇 변수는
 | |
|       필수이고 나머지는 선택적이다. 그래서 공식 목록에 없는
 | |
|       변수도 보인다. 또, 아파치는 기본적으로 제공하는 환경변수
 | |
|       외에 여러가지 방법으로 <a href="../env.html">직접 환경변수를
 | |
|       추가할 수 있다</a>.</p>
 | |
| 
 | |
|       <example>
 | |
|         #!/usr/bin/perl<br />
 | |
|         print "Content-type: text/html\n\n";<br />
 | |
|         foreach $key (keys %ENV) {<br />
 | |
|         <indent>
 | |
|           print "$key --> $ENV{$key}<br>";<br />
 | |
|         </indent>
 | |
|         }
 | |
|       </example>
 | |
|     </section>
 | |
| 
 | |
|     <section id="stdin">
 | |
|       <title>STDIN과 STDOUT</title>
 | |
| 
 | |
|       <p>또, 서버와 클라이언트는 표준입력(<code>STDIN</code>)과
 | |
|       표준출력(<code>STDOUT</code>)으로 통신한다. 일상적인 경우
 | |
|       <code>STDIN</code>은 키보드나 프로그램이 처리하는 파일을
 | |
|       나타내고, <code>STDOUT</code>은 보통 콘솔이나 화면을 뜻한다.</p>
 | |
| 
 | |
|       <p>CGI 프로그램에게 웹 양식(form)을 <code>POST</code>하면
 | |
|       양식에 입력한 자료를 특별한 형식으로 묶어서 CGI 프로그램의
 | |
|       <code>STDIN</code>으로 전달한다. 그러면 프로그램은 키보드나
 | |
|       파일에서 얻은 자료를 처리하듯이 자료를 처리할 수 있다.</p>
 | |
| 
 | |
|       <p>"특별한 형식"은 매우 간단하다. 항목 이름과 값을 등호(=)로
 | |
|       연결하고, 항목 이름과 값의 쌍들을 서로 앤퍼샌드(&)로
 | |
|       연결한다. 공백, 앰퍼샌드, 등호 같은 부자연스러운 문자는
 | |
|       혼동하지 않도록 16진수로 변환한다. 완전한 자료 문자열은
 | |
|       다음과 같이 생겼다.</p>
 | |
| 
 | |
|       <example>
 | |
|         name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
 | |
|       </example>
 | |
| 
 | |
|       <p>종종 URL 뒤에서 이런 문자열을 보게 된다. 이 경우 서버는
 | |
|       문자열을 <code>QUERY_STRING</code>이라는 환경변수에 저장한다.
 | |
|       이를 <code>GET</code> 요청이라고 한다. <code>FORM</code>
 | |
|       태그의 <code>METHOD</code> 속성을 지정하여 HTML 양식(form)이
 | |
|       자료를 <code>GET</code>할지 <code>POST</code>할지 결정한다.</p>
 | |
| 
 | |
|       <p>이제 프로그램은 이런 문자열을 유용한 정보로 쪼개야
 | |
|       한다.  다행히도 이런 자료 처리를 돕고 CGI 프로그램의 다른
 | |
|       여러 면을 살피는 라이브러리와 모듈들이 있다.</p>
 | |
|     </section>
 | |
|   </section>
 | |
| 
 | |
|   <section id="libraries">
 | |
|     <title>CGI 모듈/라이브러리</title>
 | |
| 
 | |
|     <p>CGI 프로그램을 작성할때 지루한 작업을 대신해주는 코드
 | |
|     라이브러리 혹은 모듈을 사용할지 고려해봐야 한다. 이런 것을
 | |
|     사용하면 버그가 줄고 더 빨리 프로그램을 개발할 수 있다.</p>
 | |
| 
 | |
|     <p>Perl로 CGI 프로그램을 작성한다면 <a
 | |
|     href="http://www.cpan.org/">CPAN</a>에서 관련 모듈들을 찾을
 | |
|     수 있다. CGI 개발에 가장 널리 사용되는 모듈은
 | |
|     <code>CGI.pm</code>이다. 대부분의 프로그램에 충분한 최소
 | |
|     기능을 구현한 <code>CGI::Lite</code>도 고려해 볼 수 있다.</p>
 | |
| 
 | |
|     <p>C로 CGI 프로그램을 작성한다면 선택의 여지가 많다. 이중
 | |
|     하나가 <a
 | |
|     href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>에
 | |
|     있는 <code>CGIC</code> 라이브러리다.</p>
 | |
|   </section>
 | |
| 
 | |
|   <section id="moreinfo">
 | |
|     <title>더 많은 정보...</title>
 | |
| 
 | |
|     <p>웹에 매우 많은 CGI 정보가 있다. 뉴스그룹 <a
 | |
|     href="news:comp.infosystems.www.authoring.cgi"
 | |
|     >comp.infosystems.www.authoring.cgi</a>에서 여러 사람들과
 | |
|     CGI 문제를 논의할 수 있다. HTML Writers Guild의 -servers
 | |
|     메일링리스트는 질문에 대한 답을 찾기에 훌륭한 장소다. <a
 | |
|     href="http://www.hwg.org/lists/hwg-servers/"
 | |
|     >http://www.hwg.org/lists/hwg-servers/</a>에서 더 많은 것을
 | |
|     알 수 있다.</p>
 | |
| 
 | |
|     <p>그리고 물론 CGI 프로그램 동작에 대한 모든 내용을 설명한
 | |
|     CGI 규약을 읽어야 할지도 모른다. <a
 | |
|     href="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html">NCSA</a>에
 | |
|     원본 문서가 있고, 수정한 초안은 <a
 | |
|     href="http://web.golux.com/coar/cgi/">Common Gateway Interface
 | |
|     RFC 프로젝트</a>에 있다.</p>
 | |
| 
 | |
|     <p>메일링리스트나 뉴스그룹에 현재 격고 있는 CGI 문제에 대해
 | |
|     질문할때는 발생한 현상과 원래 기대한 결과, 실제로 발생한
 | |
|     현상이 어떻게 다른지, 사용하는 서버, CGI 프로그램을 작성한
 | |
|     언어, 가능하면 해당 코드를 자세히 적어라. 그러면 해결책을
 | |
|     찾기 쉬워진다.</p>
 | |
| 
 | |
|     <p>아파치 소스코드가 잘못되었다고 확신하지 않는 한 CGI 질문을
 | |
|     아파치 버그 데이터베이스에 올리면 <strong>절대로</strong>
 | |
|     안된다.</p>
 | |
|   </section>
 | |
| </manualpage>
 | |
| 
 |