Apache HTTP Server Version 2.4
이 문서는 아파치에서 핸들러를 사용하는 방법을 설명한다.
관련된 모듈 | 관련된 지시어 |
---|---|
파일을 요청할때 아파치가 내부적으로 수행할 작업을 "핸들러(handler)"라고 한다. 일반적으로 파일은 파일 종류에 따라 암묵적인 핸들러를 가지고 있다. 모든 파일은 보통 간단히 서버가 서비스하지만, 어떤 파일 종류는 따로 "처리된다(handled)".
Apache 1.1부터 핸들러를 명시적으로 사용할 수 있게 되었다. 파일 종류와 관계없이 핸들러를 파일의 확장자나 위치에 따라 지정할 수 있다. 이는 더 훌륭한 방법이고 파일을 종류와 핸들러 둘 모두와 연계할 수 있기때문에 좋다. (여러 확장자를 가진 파일도 참고)
핸들러는 서버나 모듈로 구현하여, Action
지시어로 추가할
수 있다. 표준 배포본에 있는 기본 핸들러는 다음과 같다:
default_handler()
를 사용하여 파일을 보낸다.
(core)mod_asis
)mod_cgi
)mod_imagemap
)mod_info
)mod_status
)mod_negotiation
)다음 지시어는 확장자가 html
인 파일을
요청할 경우 footer.pl
CGI 스크립트를 띄운다.
Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html
CGI 스크립트는
(PATH_TRANSLATED
환경변수가 지칭하는) 원래
요청한 문서를 적절히 수정한 후 보낸다.
다음 지시어는 HTTP 헤더를 포함하는 파일에
send-as-is
핸들러를 지시한다.
/web/htdocs/asis/
디렉토리 안에 있는 모든
파일은 확장자와 관계없이 send-as-is
핸들러가
처리한다.
<Directory /web/htdocs/asis>
SetHandler send-as-is
</Directory>
핸들러 기능을 구현하기위해 사용함직한
Apache API가 추가되었다.
특히 request_rec
구조체에 새로운 필드가
추가되었다:
char *handler
모듈이 핸들러를 사용하려면, 요청의
invoke_handler
단계 이전에
r->handler
에 핸들러 이름을 지정해주기만
하면 된다. 핸들러는 content type 대신 핸들러 이름을 사용한
것을 제외하고는 전과 같이 구현되었다. 꼭 지킬 필요는 없지만
핸들러 이름에 슬래쉬를 사용하지 않고, 단어들 사이에 빼기
기호를 사용하는 것이 일반적이다. 그래서 핸들러 이름이
media type과 겹치지 않는다.