목표

C++ 98 로 HTTP 웹서버 만들기



프로그램 실행 방법

./webserv [configuration file]



요구 사항

P5

  • 프로그램은 configuration file 을 인자로 받거나 기본 경로를 사용해야 한다.

  • 서버는 절대로 차단해서는 안되며, 필요에 따라 클라이언트가 다른 서버로 리다이렉션 될 수 있다.

  • ☝🏻 "서버가 클라이언트의 요청을 처리하기 어렵거나 오랜 시간이 걸리는 경우" 라고 해석함

  • 클라이언트 - 서버 간의 모든 I/O 연산에 대해, 1개의 poll() 만을 사용해야 한다.

  • ❗️ 찾아보니, 이제는 poll() 함수를 안쓴다. select(), kqueue(), epoll() 을 사용하자.

  • ☝🏻 poll() 이 어떤건지 아직 잘 모르겠지만, 소캣을 연결하는 함수인 것 같다.

  • poll() 은 읽기와 쓰기를 동시에 확인해야한다.

  • poll() 을 거치지 않고 읽기 또는 쓰기 작업을 해서는 안된다.

  • 읽기 또는 쓰기 작업 후 errno 값을 확인하는 것은 엄격히 금지되어 있다.

  • configuration file 을 읽기 전에 poll() 을 사용하지 말자.

  • ❗️ poll() 을 사용하지 않고 파일 디스크립터에서 읽기/받기 또는 쓰기/전송을 시도하면 안된다.

  • FD_SET, FD_CLR, FD_ISSET, FD_ZERO 매크로를 사용할 수 있다.

  • 서버에 대한 요청이 중단되는 안된다.

  • 서버는 선택한 웹 브라우저와 호환되어야 한다.

  • Nginx 는 HTTP 1.1 을 준수하며, 프로젝트를 진행하며 헤더와 응답 동작을 비교할 때 활용할 수 있다.

  • HTTP 응답 상태 코드가 정확해야 한다.

  • 200, 300 등 상태 코드를 의미하ㄴ다.

  • 기본 오류 페이지가 제공되어야 한다.

  • 클라이언트는 파일을 업로드 할 수 있어야 한다.

  • 최소한 GET, POST, DELETE 메소드가 필요하다.

  • 서버에 대한 부하(stress) 테스트를 해야하며, 서버는 항상 사용 가능한 상태를 유지해야한다.

  • 서버는 여러 포트를 수신할 수 있어야 한다.

P6

  • MacOS 는 다른 유닉스 OS 와 같은 방식으로 write() 를 구현하지 않는다. 대신 fcntl() 을 사용할 수 있다. ❗️ 다만 nonblock 일 때만 사용가능하다. ex. fcntl(fd, F_SETFL, O_NONBLOCK);

Configuration file

⭐️ nginx conf 파일의 'server' 부분에서 영감을 얻을 수 있다.

  • 각 "server" 의 port 와 host 를 선택한다.

  • server_names 을 설정할지 여부를 결정한다.

  • host:port 의 첫 번째 서버가 이 host:port 의 기본값이 된다. (즉, 다른 서버에 속하지 않은 모든 요청에 응답한다는 의미).


  • 기본 오류 페이지를 설정한다.

  • 클라이언트 본문 크기를 제한한다.

  • 다음 규칙/구성 중 하나 또는 여러 개를 사용하여 경로를 설정한다.

  • 경로에 허용되는 HTTP 메서드 목록을 정의
  • HTTP 리디렉션을 정의

  • 파일을 검색할 디렉토리 또는 파일을 정의한다.

    • 예
      url /kapouet이 /tmp/www에 루팅된 경우
      url /kapouet/pouic/toto/pouet -> /tmp/www/pouic/toto/pouet

  • 디렉토리 목록을 on / off 할 수 있다.

    • autoindex 설정을 이야기한다.

  • 요청이 디렉토리인 경우 응답할 기본 파일을 설정한다.

  • 특정 파일 확장자(ex: .php)를 기준으로 CGI를 실행한다.

  • POST 및 GET 메소드와 함께 작동하도록 설정한다.

  • 업로드된 파일을 허용하고 저장할 위치를 설정할 수 있는 경로를 만든다.

    • CGI 를 직접 호출하지 않으므로 전체 경로를 PATH_INFO 로 사용한다.
    • 청크된 요청의 경우 서버가 청크를 언청크해야 하며, CGI 는 본문의 끝을 EOF 로 파악한다.
    • CGI 출력도 마찬가지다. CGI 에서 content_length 가 없으면, EOF 가 데이터의 끝이다.
    • 프로그램은 요청된 파일을 첫 번째 인자로 사용하여 CGI 를 호출해야 한다.
    • ☝🏻 Configuration 파일에 적힌 CGI 를 불러온다는 것으로 이해함.
    • CGI 는 상대 경로 파일 액세스를 위해 올바른 디렉토리에서 실행되어야 한다.
    • 서버는 하나의 CGI (php-CGI, Python 등)으로 작동해야 한다.

P8

추가 기능을 구현할 계획이 있다면, * 쿠키 및 세션 관리 지원하기 * 여러 개의 CGI를 처리할 수 있도록 하기