| <?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:1793934 (outdated) --> |
| |
| <!-- |
| 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_example_hooks.xml.meta"> |
| |
| <name>mod_example_hooks</name> |
| <description>¾ÆÆÄÄ¡ ¸ðµâ API¸¦ ¼³¸íÇÑ´Ù</description> |
| <status>Experimental</status> |
| <sourcefile>mod_example_hooks.c</sourcefile> |
| <identifier>example_hooks_module</identifier> |
| |
| <summary> |
| <p>¾ÆÆÄÄ¡ ¹èÆ÷º» <code>modules/examples</code> µð·ºÅ丮¿¡ |
| ÀÖ´Â ÆÄÀϵéÀº ¾ÆÆÄÄ¡ API¸¦ »ç¿ëÇÏ¿© ¸ðµâÀ» ÀÛ¼ºÇÏ·Á´Â »ç¶÷µéÀ» |
| µ½±âÀ§ÇÑ ¿¹Á¦´Ù.</p> |
| |
| <p><code>mod_example_hooks.c</code>´Â ¸ðµç Äݹé(callback) ±¸Á¶¿Í |
| È£Ãâ ¹®¹ýÀ» ¼³¸íÇÏ´Â ÆÄÀÏÀÌ´Ù. ´ç½ÅÀº ¸ðµâ¿¡ ÀÌ ¸ðµç ÄݹéÀ» |
| ±¸ÇöÇÒ ÇÊ¿ä°¡ ¾ø´Ù. »ç½Ç Á¤¹Ý´ë´Ù!</p> |
| |
| <p>example ¸ðµâÀº ½ÇÁ¦·Î µ¿ÀÛÇÏ´Â ¸ðµâÀÌ´Ù. ÀÌ ¸ðµâÀ» ¼¹ö¿¡ |
| ¿¬°áÇÏ°í ƯÁ¤ À§Ä¡¿¡ "example-hooks-handler" Çڵ鷯¸¦ ÇÒ´çÇÏ¿© |
| ±×°÷À» ºê¶ó¿ì¡Çϸé example ¸ðµâÀÇ ¿©·¯ ÄݹéÀ» È®ÀÎÇÒ ¼ö |
| ÀÖ´Ù.</p> |
| </summary> |
| |
| <section id="compiling"><title>example ¸ðµâ ÄÄÆÄÀÏÇϱâ</title> |
| |
| <p>¼¹ö¿¡ example ¸ðµâÀ» Æ÷ÇÔÇÏ·Á¸é ´ÙÀ½ °úÁ¤À» °ÅÄ£´Ù:</p> |
| |
| <ol> |
| <li> |
| <code>--enable-example-hooks</code> ¿É¼Ç°ú ÇÔ²² |
| <code>configure</code>¸¦ ½ÇÇàÇÑ´Ù.</li> |
| |
| <li>¼¹ö¸¦ ÄÄÆÄÀÏÇÑ´Ù ("<code>make</code>"¸¦ ½ÇÇàÇÑ´Ù).</li> |
| </ol> |
| |
| <p>ÀÚ½ÅÀÌ ¸¸µç ¸ðµâÀ» Ãß°¡ÇÏ·Á¸é:</p> |
| |
| <ol type="A"> |
| <li><code>cp modules/examples/mod_example_hooks.c |
| modules/new_module/<em>mod_myexample.c</em></code></li> |
| |
| <li>ÆÄÀÏÀ» ¼öÁ¤ÇÑ´Ù.</li> |
| |
| <li><code>modules/new_module/config.m4</code> ÆÄÀÏÀ» ¸¸µç´Ù. |
| <ol> |
| <li><code>APACHE_MODPATH_INIT(new_module)</code>À» |
| Ãß°¡ÇÑ´Ù.</li> |
| <li><code>modules/examples/config.m4</code> ÆÄÀÏ¿¡¼ |
| "example_hooks"ÀÌ ÀÖ´Â APACHE_MODULE ÁÙÀ» º¹»çÇؿ´Ù.</li> |
| <li>ù¹ø° ¾Æ±Ô¸ÕÆ® "example_hooks"À» <em>myexample</em>·Î |
| º¯°æÇÑ´Ù.</li> |
| <li>µÎ¹ø° ¾Æ±Ô¸ÕÆ® ÀÚ¸®¿¡ ÀÚ½ÅÀÌ ¸¸µç ¸ðµâ¿¡ ´ëÇÑ |
| °£´ÜÇÑ ¼³¸íÀ» Àû´Â´Ù. <code>configure --help</code>¸¦ |
| ½ÇÇàÇÏ¸é ¿©±â¿¡ ±â·ÏÇÑ ¼³¸íÀ» º¸¿©ÁØ´Ù.</li> |
| <li>¸ðµâÀ» ÄÄÆÄÀÏÇÒ¶§ Ưº°ÇÑ C ÄÄÆÄÀÏ·¯ ¿É¼Ç, ¸µÄ¿ |
| ¿É¼Ç, ¶óÀ̺귯¸®°¡ ÇÊ¿äÇÏ¸é °¢°¢ CFLAGS, LDFLAGS, |
| LIBS¿¡ Ãß°¡ÇÑ´Ù. modules µð·ºÅ丮¿¡ ÀÖ´Â ´Ù¸¥ |
| <code>config.m4</code> ÆÄÀϵéÀ» Âü°íÇ϶ó.</li> |
| <li><code>APACHE_MODPATH_FINISH</code>¸¦ Ãß°¡ÇÑ´Ù.</li> |
| </ol> |
| </li> |
| |
| <li><code>module/new_module/Makefile.in</code> ÆÄÀÏÀ» |
| ¸¸µç´Ù. ¸ðµâÀ» ÄÄÆÄÀÏÇϴµ¥ Ưº°ÇÑ ¸í·É¾î°¡ ÇÊ¿ä¾ø´Ù¸é, |
| ÆÄÀÏ¿¡ <code>include $(top_srcdir)/build/special.mk</code>¸¸ |
| À־ µÈ´Ù.</li> |
| |
| <li>ÃÖ»óÀ§ µð·ºÅ丮¿¡¼ ./buildconf ¸¦ ½ÇÇàÇÑ´Ù.</li> |
| |
| <li>--enable-myexample ¿É¼ÇÀ» »ç¿ëÇÏ¿© ¼¹ö¸¦ ÄÄÆÄÀÏÇÑ´Ù</li> |
| |
| </ol> |
| </section> |
| |
| <section id="using"><title><code>mod_example_hooks</code> ¸ðµâ »ç¿ëÇϱâ</title> |
| |
| <p>example ¸ðµâÀ» »ç¿ëÇÏ·Á¸é <code>httpd.conf</code> ÆÄÀÏ¿¡ |
| ´ÙÀ½°ú °°Àº ¼³Á¤À» Ãß°¡Ç϶ó:</p> |
| <example> |
| <Location /example-hooks-info><br /> |
| SetHandler example-hooks-handler<br /> |
| </Location> |
| </example> |
| |
| <p>¾Æ´Ï¸é <a |
| href="core.html#accessfilename"><code>.htaccess</code></a> |
| ÆÄÀÏ¿¡ ´ÙÀ½°ú °°Àº ³»¿ëÀ» Ãß°¡ÇÏ°í, ±× À§Ä¡¿¡¼ "test.example" |
| °°Àº ÆÄÀÏÀ» ¿äûÇ϶ó:</p> |
| <example> |
| AddHandler example-hooks-handler .example |
| </example> |
| |
| <p>¼¹ö¸¦ Àç½ÃÀÛÇÑ ÈÄ ÀÌ À§Ä¡¸¦ ºê¶ó¿ì¡ÇÏ¸é ¾Õ¿¡¼ ¸»ÇÑ |
| ³»¿ëÀ» º¸°ÔµÉ °ÍÀÌ´Ù.</p> |
| </section> |
| |
| <directivesynopsis> |
| <name>Example</name> |
| <description>¾ÆÆÄÄ¡ ¸ðµâ API¸¦ ¼³¸íÇϱâÀ§ÇÑ ¿¹Á¦ Áö½Ã¾î</description> |
| <syntax>Example</syntax> |
| <contextlist><context>server config</context> |
| <context>virtual host</context><context>directory</context> |
| <context>.htaccess</context></contextlist> |
| |
| <usage> |
| <p><directive>Example</directive> Áö½Ã¾î´Â example ¸ðµâÀÇ |
| ³»¿ëÇڵ鷯°¡ °£´ÜÇÑ ¹®±¸¸¦ º¸ÀÏÁö ¿©ºÎ¸¦ ¼³Á¤ÇÑ´Ù. ÀÌ Áö½Ã¾î´Â |
| ¾Æ±Ô¸ÕÆ®¸¦ ¹ÞÁö¾Ê´Â´Ù. example ³»¿ëÇڵ鷯¸¦ Àû¿ëÇÑ URL¿¡ |
| Á¢¼ÓÇÏ¸é ¹®¼ ¿äûÀ» ¼ºñ½ºÇϱâÀ§ÇØ ¸ðµâ¾È¿¡ ÇÔ¼öµéÀÌ ¾î¶»°Ô |
| ±×¸®°í ¾î¶² ¼ø¼·Î ºÒ¸®´ÂÁö ¾Ë ¼ö ÀÖ´Ù. ÀÌ Áö½Ã¾îÀÇ È¿°ú´Â |
| "<code>Example directive declared here: YES/NO</code>"·Î |
| È®ÀÎÇÒ ¼ö ÀÖ´Ù.</p> |
| </usage> |
| </directivesynopsis> |
| |
| </modulesynopsis> |