CGI (Common Gateway Interface)

CGI의 출력

  1. HTML문서로의 출력
    CGI는 STDOUT으로 출력을 합니다. 다만 MIME type을 다음과 같은 양식으로 지정해 주어야 합니다. 아래 코드는 C로 작성된 것이며, STDOUT으로의 가장 첫번째 출력이 되어야 합니다. 
    
printf("Content-type: text/html\n");     
printf("\n");

    물론 다른 언어로 작성된 프로그램의 경우에도 같은 코드를 가장 먼저 출력해주면 같은 효과를 얻을 수 있습니다. Perl의 경우에는 다음과 같습니다. 
    
print "Content-type: text/html\n";     
print "\n";
    Content-type은 바로 MIME type을 의미하는 것이고, 이 문장은 그 다음부터 나오는 실제 출력문과 구분하기 위해서 \n(newline)을 한 번 더 출력해주어야 합니다. (만약 \n으로 구분해주지 않으면 HTTP서버는 이 프로그램을 문제있는 프로그램으로 간주하고 실행하지 않습니다.)

    실행된 결과, 다시 말해서 출력되는 내용은 web browser인 Netscape이나 Mosaic, Explorer, lynx등이 받게 되면 위에서 출력했던 헤더에 따라서 그 내용을 다르게 인식합니다. 여기에서는 HTML 문서로 출력하므로 그 이후의 출력은 모두 HTML 언어로 인식되고 HTML문서로 보여지게 됩니다. 
    
printf("Content-type: text/html\n");     
printf("\n");
printf("<html>\n");
printf("<head>\n");
printf("<title> Welcome to my homepage! </title>\n");
printf("<body>\n");
.
. 여기에 HTML언어를 출력해주면 됩니다.
.
printf("<body>\n");
printf("<html>\n");

    아마 대충 어떻게 출력하는지 충분히 이해하셨을 거라고 믿고 다시 입력에 관한 이야기를 다시 다루어보겠습니다. 이전에 설명했던 것은 입력의 다양한 형식에 관한 것이었으나 이번에는 입력이 실제로 어떤 형태로 들어오고, 그것을 어떻게 처리해야 하는지를 알아야 올바르게 작동하는 CGI program을 작성할 수 있을 것입니다.

     
  2. CGI로부터의 입력 처리
    CGI의 입력은 name=value형식의 문자열이 스트림(stream)형태로 넘겨집니다. getc같은 프로그램이나 fscanf등의 아무 입력함수를 써서 STDIN에서 정보를 읽어들입니다. 
    
void getcgiinput(void)
{
  int i = 0, x;
  
  do {
    x = fgetc(stdin);      
    buffer[i++] = x;
  while (x != EOF);
  buffer[i] = '\0';
}

    위 예제 코드에서 사용한 buffer는 이 함수(callee)를 호출한 함수(caller)에서도 읽어 들일 수 있도록 전역변수로 지정되거나 parameter로 넘겨받아서 처리해 주어도 됩니다. 이제 이 buffer라는 배열은 여러 token들이 대개 &(and)나 |(or)로 구분되어 묶여있으므로 사용자가 직접 token단위로 쪼개주어야 합니다. 
    
/* 메인 함수에서 */
token = strtok(buffer, "&");
while (token != NULL) {
  process_pair(token);
  token = strtok(NULL, "&");
}

/* 끊어진 한 token="name_string=value_string"을 
   name과 value로 쪼개어 처리하는 함수 */
void process_pair(char *varval)
{
  char *ptr_value;
  char name[1024];
  char value[1024];

  strcpy(name, varval);
  ptr_value = strchr(name, '=');  
  if (ptr_value != NULL) {        
    *ptr_value++ = '\0';
    strcpy(value, ptr_value);
    urldecode(name);
    urldecode(value);
    if (!stricmp(name, "keyword"))
      strncpy(input, value, sizeof(input)-1);
      /* 다 나누어졌으니 처리만 해주면 됩니다. */
      /* 실제 코드는 각 프로그램마다 다르겠죠. */
      /* name이라는 변수에는 변수이름이,       */
      /* value라는 변수에는 변수의 값이        */
      /* 스트링 형태로 저장되어져 있습니다.    */
      .
      .
      .
    }
  }
}

/* encode되어 들어온 문자들을 decode해주는 함수 */
void urldecode(unsigned char *encoded) 
{
  char *decoded;
  int temp;

  swapchar(encoded, '+', ' ');
  decoded = encoded;
  while (*encoded) {
    if (*encoded == '%') {
      encoded++;
      if (isxdigit(encoded[0]) && isxdigit(encoded[1])) {
        sscanf(encoded, "%2x", &temp);
        *decoded++ = (char) temp;
        encoded += 2;
      }
    } else {
      *decoded++ = *encoded++;
    }
  }
  *decoded = '\0';
}

이전 문서, 다음 문서