mod_deflate 내용을 클라이언트로 보내기 전에 압축한다 Extension mod_deflate.c deflate_module

mod_deflate 모듈은 서버의 출력을 네트웍으로 클라이언트에 보내기 전에 압축하는 DEFLATE 출력필터를 제공한다.

 필터
압축하기
출력 압축

DEFLATE 필터가 압축을 한다. 다음 지시어는 지시어가 있는 위치의 문서를 압축한다:

SetOutputFilter DEFLATE

모든 내용을 압축하면 처리하지 못하는 브라우저가 있기때문에 html 파일만을 압축하기위해 (아래 참고) gzip-only-text/html을 1로 설정할지도 모른다. 이를 1이 아닌 값으로 설정하면 무시한다.

보통 특별한 MIME type만 압축하려면 AddOutputFilterByType 지시어를 사용한다. 다음 설정은 html 파일만을 압축한다:

<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
 </Directory>

압축한 파일을 처리하지 못하는 브라우저에게는 압축하지않고 보내길위해 BrowserMatch 지시어에 no-gzip을 설정한다. 최적의 결과를 얻기위해 no-gzip과 gzip-only-text/html을 같이 사용할 수 있다. 이 경우 전자가 후자를 무시한다. 위 절의 설정 예제 일부를 살펴보자:

BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html

먼저 User-Agent 문자열을 보고 Netscape Navigator 버전 4.x인지 검사한다. 이 버전은 text/html이 아닌 type의 압축을 처리하지 못한다. 버전 4.06, 4.07, 4.08은 html 파일 압축을 처리하는대도 문제가 있다. 그래서 우리는 이 경우 deflate 필터를 완전히 사용하지않는다.

세번째 BrowserMatch 지시어는 Microsoft Internet Explorer가 자신을 "Mozilla/4"로 알리지만 압축된 요청을 처리할 수 있기때문에 user agent 추측을 수정한다. User-Agent 헤더에서 "MSIE" (\b는 "단어 경계"를 뜻한다) 문자열을 발견하면 앞에서 설정한 제약을 푼다.

주의 DEFLATE 필터는 항상 PHP나 SSI와 같은 RESOURCE 필터 뒤에 들어간다. 또, 내부 하위요청(subrequest)에 영향을 주지 않는다. 주의 SetEnv로 force-gzip 환경변수를 설정하면 브라우저의 accept-encoding 설정을 무시하고 압축된 결과를 보낸다.
출력 압축풀기

mod_deflate 모듈은 gzip으로 압축된 응답 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 같이 SetOutputFilter나 AddOutputFilter를 사용하여 출력필터순서에 INFLATE 필터를 추가한다.

<Location /dav-area>
ProxyPass http://example.com/
SetOutputFilter INFLATE
 </Location>

이 예제는 example.com이 보낸 gzip으로 압축된 결과의 압축을 풀어서, 다른 필터가 더 처리할 수 있도록 한다.

입력 압축풀기

mod_deflate 모듈은 gzip으로 압축된 요청 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 같이 SetInputFilter나 AddInputFilter를 사용하여 입력필터순서에 DEFLATE 필터를 추가한다.

<Location /dav-area>
SetInputFilter DEFLATE
 </Location>

요청에 Content-Encoding: gzip 헤더가 있다면 자동으로 압축된 내용을 푼다. gzip 요청을 할 수 있는 브라우저는 드물다. 그러나 어떤 WebDAV 클라이언트와 같은 특별한 프로그램은 요청 압축을 지원한다.

Content-Length에 대한 주의

요청 내용을 직접 살펴본다면, Content-Length 헤더를 믿지마라! Content-Length 헤더는 클라이언트가 보낸 내용의 길이이지, 압축을 푼 결과의 바이트수가 아니다.
프록시 서버 다루기

mod_deflate 모듈은 프록시가 자신이 캐쉬한 응답을 적절한 Accept-Encoding 요청 헤더를 보낸 클라이언트에게만 보내도록 Vary: Accept-Encoding HTTP 응답 헤더를 추가한다. 그래서 압축된 내용을 이해할 수 없는 클라이언트에 압축된 내용을 보내지않도록 한다.

예를 들어, User-Agent 헤더 등에 따라 특별히 필터 적용을 취소한다면, 프록시에게 이러한 제한을 알려주기위해 직접 Vary 헤더에 추가해야 한다. 예를 들어, 설정이 User-Agent에 따라 DEFLATE 필터를 추가한다면 다음을 사용한다:

Header append Vary User-Agent

요청 헤더외의 다른 정보에 (예를 들어, HTTP 버전) 따라 압축 여부가 결정된다면, Vary 헤더값을 *로 설정해야 한다. 그러면 표준을 따르는 프록시는 캐쉬를 하지 않게 된다.

예제 Header set Vary *
DeflateFilterNote 압축률을 로그에 기록한다 DeflateFilterNote [type] notename server configvirtual host type은 아파치 2.0.4 부터

DeflateFilterNote 지시어는 요청의 압축률을 로그에 기록하는 기호를 지정한다. 기호 이름은 지시어로 지정한 값이다. 통계를 위해 접근 로그에서 기호를 사용할 수 있다.

예제 DeflateFilterNote ratio

LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog logs/deflate_log deflate

로그에서 더 정확한 값을 추출하려면 type 아규먼트로 기록할 자료를 선택한다. type는 다음중 하나이다:

Input
필터 입력스트림의 바이트수를 저장한다.
Output
필터 출력스트림의 바이트수를 저장한다..
Ratio
압축률을 (output/input * 100) 저장한다. type 아규먼트를 생략하면 사용하는 기본값이다.

그래서 이렇게 로그에 기록할 수 있다:

정밀한 로그 DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio

LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog logs/deflate_log deflate mod_log_config DeflateBufferSize zlib이 한번에 압축할 크기 DeflateBufferSize value DeflateBufferSize 8096 server configvirtual host

DeflateBufferSize 지시어는 zlib이 한번에 압축할 바이트수를 지정한다.

 DeflateWindowSize Zlib 압축 window size DeflateWindowSize value DeflateWindowSize 15 server configvirtual host

DeflateWindowSize 지시어는 zlib 압축 window size를 (1과 15 사이의 값) 지정한다. 일반적으로 window size가 클수록 압축률이 증가한다.

 DeflateMemLevel zlib이 압축할때 사용하는 메모리량 DeflateMemLevel value DeflateMemLevel 9 server configvirtual host

DeflateMemLevel 지시어는 zlib이 압축할때 얼마만큼 메모리를 사용할지 결정한다. (1과 9 사이의 값)

 DeflateCompressionLevel 출력을 어느정도 압축하는가 DeflateCompressionLevel value Zlib's default server configvirtual host 아파치 2.0.45 부터

DeflateCompressionLevel 지시어는 사용할 압축수준을 선택한다. 값이 클수록 압축률이 증가하지만, CPU를 더 많이 사용한다.

(가장 덜 압축) 1과 (가장 많이 압축) 9 사이의 값을 지정한다.