Apache HTTP Server Version 2.0

Apache > HTTP Server > Documentation > Version 2.0 > 모듈

# 아파치 모듈 mod_example

가능한 언어: en | ko

설명: | 아파치 모듈 API를 설명한다
상태: | Experimental
모듈명: | example_module
소스파일: | mod_example.c

### 요약

이 문서는 아파치 웹서버 2.0 버전에서 변경된 내용을 담고 있지 않다. 아직도 유효한 정보가 있지만, 주의해서 사용하길 바란다.

아파치 배포본 `src/modules/example 디렉토리`에 있는 파일들은 아파치 API를 사용하여 모듈을 작성하려는 사람들을 돕기위한 예제다.

`mod_example.c`는 모든 콜백(callback) 구조와 호출 문법을 설명하는 파일이다. 당신은 모듈에 이 모든 콜백을 구현할 필요가 없다. 사실 정반대다!

example 모듈은 실제로 동작하는 모듈이다. 이 모듈을 서버에 연결하고 특정 위치에 "example-handler" 핸들러를 할당하여 그곳을 브라우징하면 example 모듈의 여러 콜백을 확인할 수 있다.

### 지시어들

### 주제

- example 모듈 컴파일하기
- `mod_example` 모듈 사용하기

## example 모듈 컴파일하기

서버에 example 모듈을 포함하려면 다음 과정을 거친다:

1. `src/Configuration` 파일 아래 부분에 있는 "AddModule modules/example/mod_example" 줄의 주석처리를 없앤다. 이런 줄이 없다면, 다음과 같은 줄을 추가한다.

   `AddModule modules/example/mod_example.o`

2. `src/Configure` 스크립트를 실행한다 ("`cd src; ./Configure`"). 그러면 서버 자체 Makefile을 만들고, 하위디렉토리에 있는 요청한 추가 모듈을 `src/modules/Makefile`에 추가한다.
3. 서버를 컴파일한다 (`src` 디렉토리에 있는 "`make`"를 실행한다).

자신이 만든 모듈을 추가하려면:

1. `mkdir src/modules/mymodule`
2. `cp src/modules/example/* src/modules/mymodule`
3. 새로 만든 디렉토리에 있는 파일을 수정한다.
4. 적절히 수정하여 위의 [1]에서 [3]까지 과정을 진행한다.

## `mod_example` 모듈 사용하기

example 모듈을 사용하려면 `srm.conf` 파일에 다음과 같은 설정을 추가하라:

`<Location /example-info>
SetHandler example-handler
</Location>`

아니면 `.htaccess` 파일에 다음과 같은 내용을 추가하고, 그 위치에서 "test.example" 같은 파일을 요청하라:

`AddHandler example-handler .example`

서버를 재시작한 후 이 위치를 브라우징하면 앞에서 말한 내용을 보게될 것이다.

## Example 지시어

설명: | 아파치 모듈 API를 설명하기위한 예제 지시어
문법: | `Example`
사용장소: | 주서버설정, 가상호스트, directory, .htaccess
상태: | Experimental
모듈: | mod_example

`Example` 지시어는 example 모듈의 내용핸들러가 간단한 문구를 보일지 여부를 설정한다. 이 지시어는 아규먼트를 받지않는다. example 내용핸들러를 적용한 URL에 접속하면 문서 요청을 서비스하기위해 모듈안에 함수들이 어떻게 그리고 어떤 순서로 불리는지 알 수 있다. 이 지시어의 효과는 "`Example directive declared here: YES/NO`"로 확인할 수 있다.

가능한 언어: en | ko