Apache模块开发：配置指令为何全局生效而非虚拟主机独立？

你遇到的核心问题是用全局变量存储了Myconfig的配置值。Apache在启动加载配置时，会依次处理所有虚拟主机块，最后一个虚拟主机的配置会覆盖全局变量里的旧值，导致所有请求无论访问哪个站点，都读取最后一次设置的值。

Apache提供了每个虚拟主机（Per-Server）和每个目录/路径（Per-Dir）独立存储配置的能力，你需要通过以下步骤改造模块：

1. 定义配置结构体 #

首先创建一个结构体，用来存储每个虚拟主机或路径的独立配置：

#include <httpd.h>
#include <http_config.h>
#include <http_protocol.h>
#include <apr_strings.h>

// 定义配置结构体
typedef struct {
    int myconfig_enabled; // 1=yes, 0=no, -1=未设置（用于继承上级配置）
} ExampleConfig;

2. 实现配置初始化与合并函数 #

虚拟主机级配置初始化 #

每个虚拟主机启动时会调用这个函数，生成独立的配置实例：

// 创建服务器（虚拟主机）级配置
static void* create_server_config(apr_pool_t *pool, server_rec *s) {
    ExampleConfig *cfg = apr_pcalloc(pool, sizeof(ExampleConfig));
    cfg->myconfig_enabled = 0; // 默认禁用（no）
    return cfg;
}

目录/路径级配置（如果用Location） #

如果需要支持<Location>这类路径级配置，还要实现目录级的配置初始化和合并函数：

// 创建目录级配置
static void* create_dir_config(apr_pool_t *pool, char *dir) {
    ExampleConfig *cfg = apr_pcalloc(pool, sizeof(ExampleConfig));
    cfg->myconfig_enabled = -1; // 默认未设置，继承上级（虚拟主机）配置
    return cfg;
}

// 合并目录级配置（当子目录和父目录配置冲突时）
static void* merge_dir_config(apr_pool_t *pool, void *basev, void *addv) {
    ExampleConfig *base = basev;
    ExampleConfig *add = addv;
    ExampleConfig *merged = apr_pcalloc(pool, sizeof(ExampleConfig));
    
    // 优先使用当前目录的配置，未设置则继承上级
    merged->myconfig_enabled = (add->myconfig_enabled != -1) ? add->myconfig_enabled : base->myconfig_enabled;
    return merged;
}

3. 修改模块结构体，关联配置函数 #

更新模块定义，把配置初始化函数关联进去：

module AP_MODULE_DECLARE_DATA example_module = {
    STANDARD20_MODULE_STUFF,
    create_server_config,  // 虚拟主机级配置创建函数
    NULL,                  // 服务器配置合并（不需要则设为NULL）
    create_dir_config,     // 目录级配置创建函数（不需要可删除）
    merge_dir_config,      // 目录级配置合并函数（不需要可删除）
    example_directives,
    register_hooks
};

如果不需要支持目录级配置，把create_dir_config和merge_dir_config换成NULL即可。

4. 改造指令处理函数 #

把原来的全局变量存储逻辑，改成往当前上下文的配置结构体里写值：

// 指令处理函数
static const char* my_function(cmd_parms *cmd, void *cfg, const char* arg) {
    ExampleConfig *config = (ExampleConfig*)cfg;
    
    if (!strcasecmp(arg, "yes")) {
        config->myconfig_enabled = 1;
    } else if (!strcasecmp(arg, "no")) {
        config->myconfig_enabled = 0;
    } else {
        return "Invalid Myconfig value. Must be 'yes' or 'no'.";
    }
    
    return NULL;
}

// 指令定义
static const command_rec example_directives[] = {
    // 支持虚拟主机（RSRC_CONF）和目录/位置（ACCESS_CONF）级配置
    AP_INIT_TAKE1("Myconfig", my_function, NULL, RSRC_CONF|ACCESS_CONF, "Enable or disable the module (yes/no)"),
    { NULL }
};

这里的void *cfg参数，Apache会根据指令所在的上下文（虚拟主机块还是Location块）自动传递对应的配置结构体实例，确保每个上下文的配置独立存储。

5. 在请求处理函数中获取对应配置 #

在请求处理时，根据当前请求的虚拟主机和路径，获取对应的配置值：

static int example_handler(request_rec *r) {
    // 判断当前请求是否需要处理（可选，比如只处理特定路径）
    if (!r->handler || strcmp(r->handler, "example-handler")) {
        return DECLINED;
    }
    
    // 获取虚拟主机级配置
    ExampleConfig *srv_cfg = ap_get_module_config(r->server->module_config, &example_module);
    // 获取目录级配置（如果支持的话）
    ExampleConfig *dir_cfg = ap_get_module_config(r->per_dir_config, &example_module);
    
    // 确定最终使用的配置值：目录级优先，否则用虚拟主机级
    int final_config = (dir_cfg->myconfig_enabled != -1) ? dir_cfg->myconfig_enabled : srv_cfg->myconfig_enabled;
    
    // 业务逻辑示例
    ap_set_content_type(r, "text/plain");
    if (final_config) {
        ap_rputs("Myconfig is enabled\n", r);
    } else {
        ap_rputs("Myconfig is disabled\n", r);
    }
    
    return OK;
}

// 钩子注册函数不变
static void register_hooks(apr_pool_t *pool) {
    ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}

关键说明 #

• 不要用全局变量存储配置！Apache的多虚拟主机、多路径场景下，全局变量会导致配置互相覆盖。
• 指令的RSRC_CONF表示允许在虚拟主机级配置，ACCESS_CONF表示允许在目录/位置级配置，两者结合可以让指令在两种上下文都生效。
• 配置合并函数确保了子目录可以继承或覆盖父目录/虚拟主机的配置，符合Apache的配置优先级规则。

内容的提问来源于stack exchange，提问作者Apple Pirate