Web 서버 GET/POST CGI 사용법 (QUERY_STRING / CONTENT

이전 포스팅에서 ① 우분투 20.04에서 lighttpd 설치 ② CGI 모듈 enable 및 설정 파일을 설명했습니다. 본 포스팅은 HTTP의 GET과 POST Method에 대응하는 CGI 프로그램 작성 방법에 설명하고자 합니다. CGI 프로그램으로의 정보 입력은 명령줄 인수, 환경변수, 표준 입력에 의해 이루어지며, GET METHOD 인 경우에는 QUERY_STRING을 통해서 파라미터를 얻을 수 있고, POST METHOD 인 경우네는 CONTENT_LENGTH와 표준 입력에 parmeter를 전달받을 수 있습니다.

CGI 프로그램으로의 정보 입력은 명령줄 인수, 환경변수, 표준 입력에 의해 이루어진다.
- 특히, 클라이언트가 서버에 요구한 URI의 안, 검색문자열(Query String)이 환경변수 QUERY_STRING에 설정되기 때문에, 그것은 HTML 폼에서 GET 메서드로 입력을 받는 것이 편리하다.
- QUERY_STRING에 문자'='가 포함되어 있지 않은 경우에, 서버는 QUERY_STRING의 내용을 커맨드 라인 인수로서 CGI 프로그램을 넘긴다. 이것은 HTML의 ISINDEX 요소를 이용하여 송신된 정보를 다루는데 편리하다.
- 클라이언트에서의 HTTP요청 BODY부분은 CGI 프로그램 표준 입력에 들어간다. 또, 그 입력의 길이가 환경변수 CONTENT_LENGTH에 설정되어 있다. 그것은 HTML 폼에서 POST메서드로 입력을 받는 것이 편리하다.

1. QUERY_STRING 에 대한 이해

쿼리 스트링은 쿼리 파라미터라고도 부른다. 주로 URL 끝에 parameter 값이 설정되어 웹 서버로 전달됩니다. 예를 들어 검색 사이트에 ?query=abc&item=123 라든지, ?redirect=URL 이런 것이 쿼리 스트링입니다.

C에서는 getenv(“QUERY_STRING”) 함수로 Python에서는 os.getenv(“QUERY_STRING”) 함수를 사용해서 Query parameter를 가져올 수 있습니다.

hello.py 파일 작성

#!/usr/bin/python3
# -*- coding: utf-8 -*-

import os

html_text = '<!DOCTYPE html>\n<html>\n<head>\n'
html_text += '\t<title>'+'test'+'</title>\n'
html_text += '\t<meta charset="utf-8">\n'
html_text += '</head>\n\n'
html_text += '<body>\n'

html_text += '<h3>Hello world by python cgi</h3>'

if os.getenv('QUERY_STRING') != None:
    html_text += 'String from browser: ' + os.getenv('QUERY_STRING')

html_text += '</body>\n</html>\n'

print (html_text)

실행 결과

2. HTTP GET Method

웹 페이지에서 HTTP GET Method 사용하는 경우에는 앞에서 설명한 것처럼 웹브라우저의 요청 문자열을 서버 측 환경변수인 QUERY_STRING에 저장되므로 CGI 프로그램에서는 getenv(QUERY_STRING)과 같은 방법으로 읽을 수가 있습니다. HTML에서 서버 측의 CGI 프로그램을 지정할 수 있습니다. 아래 예제에서는 /cgi-bin/cgi_get.py 부분입니다.

form_get.html 작성

<html>
 <head> 
    <meta charset="utf-8">'
    <title> Get example</title> 
 </head>
 <body>
  <center>
 <form action="http://localhost/cgi-bin/cgi_get.py" method="Get">
  <input type="text" name="m"/> x
  <input type="text" name="n"/> =
  <input type="text" value=""/><br>
  <input type="submit" value="Submit 버튼""/>
 </form>
  </center>
 </body>
</html>

실행 결과

form_get.html 실행 결과

Submit 버전을 누르고 CGI에서 실행 결과 QUERY_STRING을 표시한 결과, URL 이 QUERY STIRNG 양식으로 ?m=1&n2 로 추가됨을 알 수 있습니다.

3. HTTP POST Method

POST방식으로 요청한 경우에는 서버측 환경변수 CONTENT_LENGTH에 요청 문자열의 길이가 저장되고, 실제 요청 문자열은 서버 측에서 표준 입력 스트림으로 읽어야 합니다.

form.html 작성

<html>
 <head> 
    <meta charset="utf-8">'
    <title> POST example</title> 
 </head>
 <body>
  <center>
 <form action="http://localhost/cgi-bin/cgi_post.py" method="POST">
  <input type="text" name="m"/> x
  <input type="text" name="n"/> =
  <input type="text" value=""/><br>
  <input type="submit" value="Submit 버튼""/>
 </form>
  </center>
 </body>
</html>

CGI 프로그램 cgi_post.py 파일 작성

표준 입력 (stdin) 에서 Web broswer의 파라미터가 전달되고, 환경 변수(CONTENT_LENGTH)에서 URL 파라미터의 길이를 전달받습니다.

#!/usr/bin/python3
# -*- coding: utf-8 -*-

import os
import sys

if __name__ == "__main__":
    len = os.getenv("CONTENT_LENGTH");
    query_str = sys.stdin.read()


    html_text = '<!DOCTYPE html>\n<html>\n<head>\n'
    html_text += '\t<title>'+'test'+'</title>\n'
    html_text += '\t<meta charset="utf-8">\n'
    html_text += '</head>\n\n'
    html_text += '<body>\n'

    html_text += '<h3>Hello world by python cgi</h3>'

    if query_str!= None:
        html_text += 'String from browser: ' + query_str   


    html_text += '</body>\n</html>\n'

    print (html_text)