<?xml version="1.0" encoding="EUC-KR" ?>

<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>

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

<name>mod_example</name>

<description>����ġ ��� API�� �����Ѵ�</description>

<status>Experimental</status>

<sourcefile>mod_example.c</sourcefile>

<identifier>example_module</identifier>

<summary>

<p>����ġ ������ <code>modules/experimental</code> ���丮��

�ִ� ���ϵ��� ����ġ API�� ����Ͽ� ����� �ۼ��Ϸ��� �������

�������� ������.</p>

<p><code>mod_example.c</code>�� ��� �ݹ�(callback) ������

ȣ�� ������ �����ϴ� �����̴�. ����� ��⿡ �� ��� �ݹ���

������ �ʿ䰡 ���. ��� ���ݴ��!</p>

<p>example ����� ������ �����ϴ� ����̴�. �� ����� ������

�����ϰ� Ư�� ��ġ�� "example-handler" �ڵ鷯�� �Ҵ��Ͽ�

�װ��� ����¡�ϸ� example ����� ���� �ݹ��� Ȯ���� ��

�ִ�.</p>

</summary>

<section id="compiling"><title>example ��� �������ϱ�</title>

<p>������ example ����� �����Ϸ��� ���� ������ ��ģ��:</p>

<ol>

<li>

<code>--enable-example</code> �ɼǰ� �Բ�

<code>configure</code>�� �����Ѵ�.</li>

<li>������ �������Ѵ� ("<code>make</code>"�� �����Ѵ�).</li>

</ol>

<p>�ڽ��� ���� ����� �߰��Ϸ���:</p>

<ol type="A">

<li><code>cp modules/experimental/mod_example.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/experimental/config.m4</code> ���Ͽ���

"example"�� �ִ� APACHE_MODULE ���� �����ؿ´�.</li>

<li>ù��° �ƱԸ�Ʈ "example"�� <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</code> ��� ����ϱ�</title>

<p>example ����� ����Ϸ��� <code>httpd.conf</code> ���Ͽ�

������ ���� ������ �߰��϶�:</p>

<example>

&lt;Location /example-info&gt;<br />

SetHandler example-handler<br />

&lt;/Location&gt;

</example>

<p>�ƴϸ� <a

href="core.html#accessfilename"><code>.htaccess</code></a>

���Ͽ� ������ ���� ������ �߰��ϰ�, �� ��ġ���� "test.example"

���� ������ ��û�϶�:</p>

<example>

AddHandler example-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>