DIRECTORY 절

특정 디렉터리의 속성을 설정합니다.

디렉터리 접근을 제한 하는 access, 디렉터리 안의 파일 확장명을 설정하는 force_mime_type, default_mime_type 등이 있습니다.

설정 항목

다음은 DIRECTORY 절의 환경 설정 형식입니다.

#"directory": {
    "directory_list": [
        {
            "name": string,
            "path": {
                "target": string,
                #"type": [string],                  # "prefix"
            },
            #"target_http_servers": [string],       # ["*"]
            #"access": [string],
            #"error_document": [string],
            #"force_mime_type": [string],
            #"default_mime_type": [string]
        }
    ]
}

절과 설정 항목의 구성에 대한 기호나 내용에 대한 자세한 내용은 설정 항목 값의 형식 및 설정 방법을 참고합니다.

directory_list

DIRECTORY 설정에 대한 목록입니다.

구분 설명

자료형

array(object)

directory_list/name (필수 항목)

DIRECTORY 절 이름을 설정합니다.

구분 설명

자료형

string

범위

255자 이내

directory_list/path (필수 항목)

설정을 적용할 디렉터리의 경로명을 설정합니다. 경로명은 절대 경로와 $WEBTOB_HOME을 기준으로 한 상대 경로를 사용할 수 있습니다.

구분 설명

자료형

object

directory_list/path/target (필수 항목)

디렉터리의 경로명과 매치할 패턴을 설정합니다. 매치되면 해당 요청은 DIRECTORY 절의 설정이 적용됩니다.

구분 설명

자료형

string

범위

255자 이내

directory_list/path/type

DIRECTORY에 설정된 패턴의 유형을 설정합니다. 패턴 유형에 따라 디렉터리 경로와 매치하는 방식이 달라집니다.

구분 설명

자료형

string

범위

"prefix", "exact", "regex"

기본값

"prefix"

다음은 설정값에 대한 설명입니다.

설정값 설명

prefix

directory/directory_list/path/target에 설정된 패턴이 디렉터리 경로의 접두사(prefix)이면 매치합니다.
(예: 패턴 "/directory/"는 "/directory/a/", "/directory/a/b/", "/directory/a/b/c" 등의 경로와 매치합니다.)

exact

directory/directory_list/path/target에 설정된 패턴이 디렉터리 경로와 일치하면 매치합니다.
(예: 패턴 "/directory/"는 디렉터리 경로가 "/directory/"일 경우에만 매치합니다. 이외 모든 디렉터리 경로는 매치하지 않습니다.)

regex

디렉터리 경로가 directory/directory_list/path/target에 설정된 regular expression 패턴을 만족하면 매치합니다.
(예: 패턴 "/directory.*"은 "/directory", "/directory/", "/directory1"과 같은 디렉터리 경로와 매치합니다.)

directory_list/target_http_servers

특정 서버에만 디렉터리에 대한 설정이 적용되도록 할 경우 해당 서버의 이름을 설정합니다. (예: "target_http_servers": "http1")

만약 특정 vhost에만 적용되도록 설정할 경우에는 "서버의 이름.vhost 이름"으로 설정합니다. (예: "target_http_servers": "http1.vhost1")

구분 설명

자료형

array[string]

범위

64개 이내[31자 이내]

기본값

["*"]

directory_list/access

요청의 메소드, 헤더 포함여부, 요청을 보낸 IP 등에 대해 요청 허용 여부를 설정합니다. 이때 설정값은 access/access_list/name에 설정된 이름과 일치해야 합니다.

구분 설명

자료형

string

범위

255자 이내

directory_list/error_document

HTTP 에러 페이지를 사용자가 지정한 페이지로 대신 사용할 경우 ERRORDOCUMENT 절에 정의한 이름을 설정합니다. SERVER절의 error_document보다 우선순위가 높습니다.

구분 설명

자료형

array(string)

범위

64개 이내(255자 이내)

directory_list/force_mime_type

지정된 디렉터리 안의 모든 리소스 들은 force_mime_type에 설정한 MIME-Type으로 처리됩니다.

구분 설명

자료형

string

범위

127자 이내

directory_list/default_mime_type

MIME-Type을 결정할 수 없는 문서에 대한 기본 Content-Type을 설정합니다. SERVER절의 default_mime_type보다 우선순위가 높습니다.

구분 설명

자료형

string

범위

127자 이내

우선순위가 mime_type보다 ext가 더 높기 때문에 mime_type을 설정하려면 ext 설정을 제거해야 합니다.

설정 예시

다음은 DIRECTORY 절을 설정한 예시입니다.

{
    "directory": {
        "directory_list": [
            {
                "name": "directory1",
                "path": {
                    "type": "prefix",
                    "target": "http/"
                },
                "access": "access1",
                "error_document": ["errorDoc1"],
                "force_mime_type": "text/html",
                "default_mime_type": "text/html"
            }
        ]
    }
}