github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/mod/mod_setenvif.html.ko.euc-kr (about) 1 <?xml version="1.0" encoding="EUC-KR"?> 2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> 4 <meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> 5 <!-- 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 This file is generated from xml source: DO NOT EDIT 8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 9 --> 10 <title>mod_setenvif - Apache HTTP Server Version 2.2</title> 11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> 14 <script src="../style/scripts/prettify.min.js" type="text/javascript"> 15 </script> 16 17 <link href="../images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/mod/mod_setenvif.html" rel="canonical" /></head> 18 <body> 19 <div id="page-header"> 20 <p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> 21 <p class="apache">Apache HTTP Server Version 2.2</p> 22 <img alt="" src="../images/feather.gif" /></div> 23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> 24 <div id="path"> 25 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">모듈</a></div> 26 <div id="page-content"> 27 <div class="retired"><h4>Please note</h4> 28 <p> This document refers to a legacy release (<strong>2.2</strong>) of Apache httpd. The active release (<strong>2.4</strong>) is documented <a href="http://httpd.apache.org/docs/current">here</a>. If you have not already upgraded, please follow <a href="http://httpd.apache.org/docs/current/upgrading.html">this link</a> for more information.</p> 29 <p>You may follow <a href="http://httpd.apache.org/docs/current/mod/mod_setenvif.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>아파치 모듈 mod_setenvif</h1> 30 <div class="toplang"> 31 <p><span>가능한 언어: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> | 32 <a href="../ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 33 <a href="../ko/mod/mod_setenvif.html" title="Korean"> ko </a> | 34 <a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> 35 </div> 36 <div class="outofdate">이 문서는 최신판 번역이 아닙니다. 37 최근에 변경된 내용은 영어 문서를 참고하세요.</div> 38 <table class="module"><tr><th><a href="module-dict.html#Description">설명:</a></th><td>요청의 성격에 따라 환경변수 설정을 변경한다</td></tr> 39 <tr><th><a href="module-dict.html#Status">상태:</a></th><td>Base</td></tr> 40 <tr><th><a href="module-dict.html#ModuleIdentifier">모듈명:</a></th><td>setenvif_module</td></tr> 41 <tr><th><a href="module-dict.html#SourceFile">소스파일:</a></th><td>mod_setenvif.c</td></tr></table> 42 <h3>요약</h3> 43 44 45 <p><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> 모듈은 요청의 성격이 46 정규표현식에 해당하는지 여부로 환경변수를 설정한다. 서버의 47 다른 부분이 행동을 결정할때 이 환경변수를 사용할 수 있다.</p> 48 49 <p>설정파일에 나오는 순서대로 지시어를 처리한다. 그래서 50 브라우저가 MSIE가 아니라 mozilla인 경우 <code>netscape</code>를 51 설정하는 아래 예와 같이 여러 지시어를 함께 사용할 수 있다.</p> 52 53 <div class="example"><p><code> 54 BrowserMatch ^Mozilla netscape<br /> 55 BrowserMatch MSIE !netscape<br /> 56 </code></p></div> 57 </div> 58 <div id="quickview"><h3 class="directives">지시어들</h3> 59 <ul id="toc"> 60 <li><img alt="" src="../images/down.gif" /> <a href="#browsermatch">BrowserMatch</a></li> 61 <li><img alt="" src="../images/down.gif" /> <a href="#browsermatchnocase">BrowserMatchNoCase</a></li> 62 <li><img alt="" src="../images/down.gif" /> <a href="#setenvif">SetEnvIf</a></li> 63 <li><img alt="" src="../images/down.gif" /> <a href="#setenvifnocase">SetEnvIfNoCase</a></li> 64 </ul> 65 <h3>참고</h3> 66 <ul class="seealso"> 67 <li><a href="../env.html">아파치의 환경변수</a></li> 68 </ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> 69 70 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 71 <div class="directive-section"><h2><a name="BrowserMatch" id="BrowserMatch">BrowserMatch</a> <a name="browsermatch" id="browsermatch">지시어</a></h2> 72 <table class="directive"> 73 <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>HTTP User-Agent에 따라 환경변수를 설정한다</td></tr> 74 <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>BrowserMatch <em>regex [!]env-variable</em>[=<em>value</em>] 75 [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr> 76 <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트, directory, .htaccess</td></tr> 77 <tr><th><a href="directive-dict.html#Override">Override 옵션:</a></th><td>FileInfo</td></tr> 78 <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr> 79 <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_setenvif</td></tr> 80 </table> 81 <p><code class="directive">BrowserMatch</code>는 <code class="directive"><a href="#setenvif">SetEnvIf</a></code> 지시어의 특별한 82 경우로, HTTP 요청 헤더 <code>User-Agent</code>에 따라 환경변수를 83 설정한다. 다음 두 줄은 같다:</p> 84 <div class="example"><p><code> 85 BrowserMatchNoCase Robot is_a_robot<br /> 86 SetEnvIfNoCase User-Agent Robot is_a_robot<br /> 87 </code></p></div> 88 89 <p>추가 예제:</p> 90 <div class="example"><p><code> 91 BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br /> 92 BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br /> 93 BrowserMatch MSIE !javascript<br /> 94 </code></p></div> 95 96 </div> 97 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 98 <div class="directive-section"><h2><a name="BrowserMatchNoCase" id="BrowserMatchNoCase">BrowserMatchNoCase</a> <a name="browsermatchnocase" id="browsermatchnocase">지시어</a></h2> 99 <table class="directive"> 100 <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>대소문자를 구별하지않고 User-Agent에 따라 환경변수를 101 설정한다</td></tr> 102 <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>BrowserMatchNoCase <em>regex [!]env-variable</em>[=<em>value</em>] 103 [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr> 104 <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트, directory, .htaccess</td></tr> 105 <tr><th><a href="directive-dict.html#Override">Override 옵션:</a></th><td>FileInfo</td></tr> 106 <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr> 107 <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_setenvif</td></tr> 108 </table> 109 110 <p><code class="directive">BrowserMatchNoCase</code> 지시어는 <code class="directive"><a href="#browsermatch">BrowserMatch</a></code> 지시어와 111 의미상 같다. 그러나 이 지시어는 대소문자를 구별하지않는다. 112 예를 들어:</p> 113 <div class="example"><p><code> 114 BrowserMatchNoCase mac platform=macintosh<br /> 115 BrowserMatchNoCase win platform=windows<br /> 116 </code></p></div> 117 118 <p><code class="directive">BrowserMatch</code>와 119 <code class="directive">BrowserMatchNoCase</code> 지시어는 120 <code class="directive"><a href="#setenvif">SetEnvIf</a></code>와 121 <code class="directive"><a href="#setenvifnocase">SetEnvIfNoCase</a></code> 122 지시어의 특별한 경우다. 다음 주 줄은 같다:</p> 123 <div class="example"><p><code> 124 BrowserMatchNoCase Robot is_a_robot<br /> 125 SetEnvIfNoCase User-Agent Robot is_a_robot<br /> 126 </code></p></div> 127 128 </div> 129 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 130 <div class="directive-section"><h2><a name="SetEnvIf" id="SetEnvIf">SetEnvIf</a> <a name="setenvif" id="setenvif">지시어</a></h2> 131 <table class="directive"> 132 <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>요청의 성질에 따라 환경변수를 설정한다</td></tr> 133 <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>SetEnvIf <em>attribute 134 regex [!]env-variable</em>[=<em>value</em>] 135 [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr> 136 <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트, directory, .htaccess</td></tr> 137 <tr><th><a href="directive-dict.html#Override">Override 옵션:</a></th><td>FileInfo</td></tr> 138 <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr> 139 <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_setenvif</td></tr> 140 </table> 141 <p><code class="directive">SetEnvIf</code> 지시어는 요청의 성질에 142 따라 환경변수를 정의한다. 첫번째 아규먼트 <em>attribute</em>는 143 다음 세가지중 하나다:</p> 144 145 <ol> 146 <li>HTTP 요청 헤더 (더 자세한 정보는 <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a> 147 참고); 예를 들어: <code>Host</code>, <code>User-Agent</code>, 148 <code>Referer</code>, <code>Accept-Language</code>. 정규표현식을 149 사용하여 여러 요청 헤더를 지칭할 수 있다.</li> 150 151 <li>요청의 다음 성질중 하나: 152 <ul> 153 <li><code>Remote_Host</code> - (있다면) 요청하는 클라이언트의 154 호스트명</li> 155 156 <li><code>Remote_Addr</code> - 요청하는 클라이언트의 IP 주소</li> 157 158 <li><code>Server_Addr</code> - 요청을 받는 서버의 IP 주소 159 (2.0.43 버전 이후에만)</li> 160 161 <li><code>Request_Method</code> - 사용한 메써드 이름 162 (<code>GET</code>, <code>POST</code>, <em>등등</em>)</li> 163 164 <li><code>Request_Protocol</code> - 요청의 프로토콜 이름과 165 버전 (<em>예를 들어</em>, "HTTP/0.9", "HTTP/1.1", <em>등.</em>)</li> 166 167 <li><code>Request_URI</code> - HTTP 요청에서 요청한 자원 168 -- 일반적으로 URL에서 질의문자열을 제외한 스킴(scheme)과 169 호스트 이후 부분</li> 170 </ul> 171 </li> 172 173 <li>요청과 연관된 환경변수 이름. 그래서 <code class="directive">SetEnvIf</code> 174 지시어는 이전 지시어의 결과를 검사할 수 있다. 이전에 175 <code>SetEnvIf[NoCase]</code> 지시어로 정의한 환경변수만을 176 검사할 수 있다. '이전'이란 (서버전역과 같이) 더 넓은 영역 혹은 177 지시어의 현재 영역 이전을 뜻한다. 요청 성질이 아니고 정규표현식이 178 아닌 <em>attribute</em>는 환경변수로 취급한다.</li> 179 </ol> 180 181 <p>두번째 아규먼트는 (<em>regex</em>) <a href="http://www.pcre.org/">Perl 호환 정규표현식</a>이다. 182 이는 POSIX.2 egrep의 정규표현식과 비슷하다. <em>regex</em>가 183 <em>attribute</em>에 대응하면 나머지 아규먼트를 처리한다.</p> 184 185 <p>나머지 아규먼트는 설정할 변수명과 (선택적인) 설정값들이다. 186 다음과 같은 형식이다</p> 187 188 <ol> 189 <li><code><em>varname</em></code>, 혹은</li> 190 191 <li><code>!<em>varname</em></code>, 혹은</li> 192 193 <li><code><em>varname</em>=<em>value</em></code></li> 194 </ol> 195 196 <p>첫번째 형태는 값으로 "1"을 사용한다. 두번째 형태는 변수가 197 이미 정의된 경우 변수를 제거하고, 세번째는 변수의 값으로 198 <code><em>value</em></code>를 설정한다. 아파치 2.0.51부터 199 <var>value</var>에 있는 <code>$1</code>..<code>$9</code>를 200 <var>regex</var>의 괄호친 하위표현식으로 대체한다.</p> 201 202 <div class="example"><h3>예제:</h3><p><code> 203 204 SetEnvIf Request_URI "\.gif$" object_is_image=gif<br /> 205 SetEnvIf Request_URI "\.jpg$" object_is_image=jpg<br /> 206 SetEnvIf Request_URI "\.xbm$" object_is_image=xbm<br /> 207 :<br /> 208 SetEnvIf Referer www\.mydomain\.com intra_site_referral<br /> 209 :<br /> 210 SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br /> 211 :<br /> 212 SetEnvIf ^TS* ^[a-z].* HAVE_TS<br /> 213 </code></p></div> 214 215 <p>처음 세 줄은 이미지 파일을 요청한 경우 환경변수 216 <code>object_is_image</code>를 설정한다. 네번째 줄은 페이지를 217 <code>www.mydomain.com</code> 웹사이트에서 참조한 경우 218 <code>intra_site_referral</code>을 설정한다.</p> 219 220 <p>마지막 예는 요청에 이름에 "TS"로 시작하고 값이 [a-z] 221 중 하나로 시작하는 헤더가 있는 경우 환경변수 222 <code>HAVE_TS</code>를 설정한다.</p> 223 224 <h3>참고</h3> 225 <ul> 226 <li><a href="../env.html">아파치의 환경변수</a>에 더 많은 227 예제가 있다. 228 </li> 229 </ul> 230 </div> 231 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 232 <div class="directive-section"><h2><a name="SetEnvIfNoCase" id="SetEnvIfNoCase">SetEnvIfNoCase</a> <a name="setenvifnocase" id="setenvifnocase">지시어</a></h2> 233 <table class="directive"> 234 <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>대소문자를 구별하지않고 요청의 성질에 따라 환경변수를 235 설정한다</td></tr> 236 <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>SetEnvIfNoCase <em>attribute regex 237 [!]env-variable</em>[=<em>value</em>] 238 [[!]<em>env-variable</em>[=<em>value</em>]] ...</code></td></tr> 239 <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트, directory, .htaccess</td></tr> 240 <tr><th><a href="directive-dict.html#Override">Override 옵션:</a></th><td>FileInfo</td></tr> 241 <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr> 242 <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_setenvif</td></tr> 243 </table> 244 245 <p><code class="directive">SetEnvIfNoCase</code>는 의미상 <code class="directive"><a href="#setenvif">SetEnvIf</a></code> 지시어와 같지만, 246 대소문자를 구별하지않고 정규표현식을 찾는다. 예를 들어:</p> 247 <div class="example"><p><code> 248 SetEnvIfNoCase Host Apache\.Org site=apache 249 </code></p></div> 250 251 <p>이 경우 HTTP 요청 헤더 <code>Host:</code>가 252 <code>Apache.Org</code>, <code>apache.org</code> 등을 포함하면 253 <code>site</code> 환경변수를 "<code>apache</code>"로 설정한다.</p> 254 255 </div> 256 </div> 257 <div class="bottomlang"> 258 <p><span>가능한 언어: </span><a href="../en/mod/mod_setenvif.html" hreflang="en" rel="alternate" title="English"> en </a> | 259 <a href="../ja/mod/mod_setenvif.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 260 <a href="../ko/mod/mod_setenvif.html" title="Korean"> ko </a> | 261 <a href="../tr/mod/mod_setenvif.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> 262 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 263 <script type="text/javascript"><!--//--><![CDATA[//><!-- 264 var comments_shortname = 'httpd'; 265 var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_setenvif.html'; 266 (function(w, d) { 267 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 268 d.write('<div id="comments_thread"><\/div>'); 269 var s = d.createElement('script'); 270 s.type = 'text/javascript'; 271 s.async = true; 272 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 273 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 274 } 275 else { 276 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 277 } 278 })(window, document); 279 //--><!]]></script></div><div id="footer"> 280 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 281 <p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 282 if (typeof(prettyPrint) !== 'undefined') { 283 prettyPrint(); 284 } 285 //--><!]]></script> 286 </body></html>