docs/manual/mod/mod_actions.xml.ko


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

<?xml version="1.0" encoding='EUC-KR' ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 105989 -->

<!--
 Copyright 2003-2005 The Apache Software Foundation or its licensors,
                     as applicable.

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_actions.xml.meta">

<name>mod_actions</name> 

<description>이 모듈은 미디어종류나 요청메서드에 따라 CGI
스크립트를 실행한다.</description>

<status>Base</status>
<sourcefile>mod_actions.c</sourcefile>
<identifier>actions_module</identifier>

<summary>
    <p>이 모듈에는 두가지 지시어가 있다. <directive
    module="mod_actions">Action</directive> 지시어는 요청하는
    파일의 MIME content type에 따라 CGI 스크립트를 실행한다.
    <directive module="mod_actions">Script</directive> 지시어는
    요청이 특정 메서드를 사용할 경우 CGI 스크립트를 실행한다.
    그래서 파일을 처리하는 스크립트를 매우 쉽게 실행할 수 있다.</p>
</summary>

<seealso><module>mod_cgi</module></seealso>
<seealso><a href="../howto/cgi.html">CGI로 동적 페이지 생성</a></seealso>
<seealso><a href="../handler.html">아파치에서 핸들러 사용</a></seealso>

<directivesynopsis>
<name>Action</name>
<description>특정 핸들러나 content-type에 대해 CGI 스크립트를
사용한다</description>
<syntax>Action <var>action-type</var> <var>cgi-script</var> [virtual]</syntax>
<contextlist>
<context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility><code>virtual</code> 수정자와 핸들러는 아파치
2.1때 추가되었다</compatibility>

<usage>
    <p>이 지시어는 요청이 <var>action-type</var>이면
    <var>cgi-script</var>를 실행하는 행동을 서버에 추가한다.
    <var>cgi-script</var>는 <directive
    module="mod_alias">ScriptAlias</directive>나 <directive
    module="mod_mime">AddHandler</directive>를 사용하여 CGI
    스크립트로 지정한 리소스의 URL경로이다.
    <var>action-type</var>에는 <a
    href="../handler.html">핸들러</a>나 MIME content type을
    사용할 수 있다. 이 지시어는 <code>PATH_INFO</code>와
    <code>PATH_TRANSLATED</code> CGI 표준 환경변수로 요청한
    문서의 URL과 파일경로를 전달한다. <code>REDIRECT_HANDLER</code>
    변수로 특정 요청에 사용할 핸들러를 전달한다.</p>

    <example><title>예제</title>
      # 특정 MIME content type의 파일 요청:<br />
      Action image/gif /cgi-bin/images.cgi<br />
      <br />
      # 특정한 확장자를 가진 파일<br />
      AddHandler my-file-type .xyz<br />
      Action my-file-type /cgi-bin/program.cgi<br />
    </example>

    <p>첫번째 예에서 MIME content type이 <code>image/gif</code>인
    파일을 요청하면 지정한 cgi 스크립트 <code>/cgi-bin/images.cgi</code>가
    처리한다.</p>

    <p>두번째 예에서 확장자가 <code>.xyz</code>인 파일을 요청하면
    지정한 cgi 스크립트 <code>/cgi-bin/program.cgi</code>가
    처리한다.</p>
    <p>In the second example, requests for files with a file extension of
    <code>.xyz</code> are handled instead by the specified cgi script
    <code>/cgi-bin/program.cgi</code>.</p>

    <p>선택적인 <code>virtual</code> 수정자는 요청한 파일이
    실제로 존재하는지 검사하지 않도록 한다. 예를 들어, 가상의
    위치에 <directive>Action</directive> 지시어를 사용하려는
    경우 유용하다.</p>

    <example><title>예제</title>
      &lt;Location /news&gt;<br />
      <indent>
        SetHandler news-handler<br />
        Action news-handler /cgi-bin/news.cgi virtual<br />
      </indent>
      &lt;/Location&gt;
    </example>
</usage>

<seealso><directive module="mod_mime">AddHandler</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>Script</name>
<description>특정 요청메서드에 대해 CGI 스크립트를
사용한다.</description>
<syntax>Script <var>method</var> <var>cgi-script</var></syntax>
<contextlist>
<context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
<usage>
    <p>이 지시어는 파일을 <var>method</var> 메서드를 사용하여
    요청하면 <var>cgi-script</var>를 실행하는 행동을 서버에
    추가한다. <var>cgi-script</var>는 <directive
    module="mod_alias">ScriptAlias</directive>나 <directive
    module="mod_mime">AddHandler</directive>를 사용하여 CGI
    스크립트로 지정한 리소스의 URL경로이다. 이 지시어는
    <code>PATH_INFO</code>와 <code>PATH_TRANSLATED</code> CGI
    표준 환경변수로 요청한 문서의 URL과 파일경로를 전달한다.</p>

    <note>
      어떤 메서드 이름이라도 사용할 수 있다. <strong>메서드 이름은
      대소문자를 구별한다.</strong> 그래서 <code>Script PUT</code>과
      <code>Script put</code>은 완전히 다르다.
    </note>

    <p><directive>Script</directive> 명령어는 기본적인 행동만을
    처리함을 주의하라. CGI 스크립트가 불리거나, 요청한 메서드를
    알아서 처리할 수 있는 리소스의 경우 그대로 처리한다.
    <code>GET</code> 메서드의 <directive>Script</directive>는
    질의아규먼트가 있을때만 (<em>예</em>, foo.html?hi) 사용함을
    주의하라. 질의아규먼트가 없다면 정상적으로 요청을 처리한다.</p>

    <example><title>예제</title>
      # &lt;ISINDEX&gt;식 검색을 위해<br />
      Script GET /cgi-bin/search<br />
      <br />
      # CGI PUT 핸들러<br />
      Script PUT /~bob/put.cgi<br />
    </example>
</usage>
</directivesynopsis>

</modulesynopsis>