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

<?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: 421174 -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You 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> 지시어는 요청하는
    파일의 종류에 따라 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></syntax>
<contextlist>
<context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>

<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을
    사용할 수 있다. 이 지시어는 PATH_INFO와 PATH_TRANSLATED
    CGI 표준 환경변수로 요청한 문서의 URL과 파일경로를 전달한다.</p>

    <example><title>예제</title>
      # 특정 종류의 파일 요청:<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>
</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경로이다. 이 지시어는 PATH_INFO와
    PATH_TRANSLATED CGI 표준 환경변수로 요청한 문서의 URL과
    파일경로를 전달한다.</p>

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

    <p>Script 명령어는 기본적인 행동만을 처리함을 주의하라.
    CGI 스크립트가 불리거나, 요청한 메서드를 알아서 처리할 수
    있는 리소스의 경우 그대로 처리한다. <code>GET</code>
    메서드의 Script는 질의아규먼트가 있을때만 (<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>