Apache 模組 mod_example_hooks

可用的語言： en | fr | ko

在 Apache 分散目錄樹的 modules/examples 目錄中提供的檔案，提供給想要使用 Apache API 編寫模組的人作為範例。

主檔案是 mod_example_hooks.c，其中展示了所有不同的 callback 機制和呼叫語法。絕不是附加模組需要包含所有 callback 的常式，而是相反的！

範例模組是一個實際運作的模組。如果您將它連結到您的伺服器，為一個位置啟用「example-hooks-handler」處理常式，然後瀏覽到該位置，您將看到範例模組在執行各種 callback 時進行的一些追蹤的顯示。

編譯 example_hooks 模組

若要將 example_hooks 模組包含在您的伺服器中，請依照下列步驟執行

若要新增另一個您自己的模組

cp modules/examples/mod_example_hooks.c modules/new_module/mod_myexample.c
修改檔案。
建立 modules/new_module/config.m4。
1. 加入 APACHE_MODPATH_INIT(new_module)。
2. 從 modules/examples/config.m4 複製 include 「example_hooks」的 APACHE_MODULE 行。
3. 將第一個參數「example_hooks」取代為 myexample。
4. 將第二個參數取代為您模組的簡短說明。它會用在 configure --help 中。
5. 如果您的模組需要額外的 C 編譯器旗標、鏈結器旗標或函式庫，請務必將它們加入 CFLAGS、LDFLAGS 及 LIBS。請參閱模組目錄中的其他 config.m4 檔案以取得範例。
6. 加入 APACHE_MODPATH_FINISH。
建立 module/new_module/Makefile.in。如果您的模組不需要特別的建立指令，您只需在該檔案中有一個 include $(top_srcdir)/build/special.mk。
從最上層目錄執行 ./buildconf。
使用 --enable-myexample 建置伺服器

若要啟用 example_hooks 模組，請在 httpd.conf 檔案中包含類似以下的區塊

<Location "/example-hooks-info">
   SetHandler example-hooks-handler
</Location>

作為替代方案，您可以將下列內容放入 .htaccess 檔案，然後從該位置要求 "test.example" 檔案

AddHandler example-hooks-handler ".example"

重新載入/重新啟動伺服器後，您應該可以瀏覽到這個位置並看到稍早提到的簡短顯示。

Example 指令僅設定一個展示旗標，範例模組的內容處理常式會顯示該旗標。這不需任何參數。如果您瀏覽到範例掛鉤內容處理常式套用的 URL，您會獲得模組內部例程的顯示，以及呼叫這些例程的順序和方式，用來提供文件要求。這個指令的效果可以在 "範例指令在此聲明：是/否" 點下觀察。