Apache模块命令解析器原型

Apache module command parser prototype

本文关键字：原型 模块 命令 Apache      更新时间：2023-10-16

我正在创建一个Apache2模块，遇到一个奇怪的编译问题。这是我用来解析名为"analytics_ip"的配置命令的函数的原型:

static const char *apr_cfg_set_analytics_ip(cmd_parms *cmd, void *config, const char *data);

这是一个command_rec结构的数组，包含指向该函数的指针:

static const command_rec apr_cmds[] =
{
 AP_INIT_TAKE1("analytics_ip", apr_cfg_set_analytics_ip, NULL, OR_ALL, ""),
 { NULL }
};

结构command_rec声明在头文件http_config.h

typedef struct command_struct command_rec;
struct command_struct {
    /** Name of this command */
    const char *name;
    /** The function to be called when this directive is parsed */
    cmd_func func;
    /** Extra data, for functions which implement multiple commands... */
    void *cmd_data;
    /** What overrides need to be allowed to enable this command. */
    int req_override;
    /** What the command expects as arguments */
    enum cmd_how args_how;
    /** 'usage' message, in case of syntax errors */
    const char *errmsg;
};

当我跟随cmd_func时，它会得到以下声明:

typedef const char *(*cmd_func) ();

如果我没弄错的话，这意味着"指向函数的指针返回指向char的指针，并且不接受任何参数"。这怎么可能呢?命令解析函数必须接受至少一个参数，其中包含与该函数对应的配置变量的模块值。

我使用g++来编译这个模块。错误信息:

mod_xxx.h:65:2: error: invalid conversion from ‘const char* (*)(cmd_parms*, void*, const char*) {aka const char* (*)(cmd_parms_struct*, void*, const char*)}’ to ‘cmd_func {aka const char* (*)()}’ [-fpermissive]
  };

Thanks in advance

cmd_func是一个联合，它在http_config.h中定义如下:

typedef union {
    /** function to call for a no-args */
    const char *(*no_args) (cmd_parms *parms, void *mconfig);
    /** function to call for a raw-args */
    const char *(*raw_args) (cmd_parms *parms, void *mconfig,
                             const char *args);
    /** function to call for a argv/argc */
    const char *(*take_argv) (cmd_parms *parms, void *mconfig,
                             int argc, char *const argv[]);
    /** function to call for a take1 */
    const char *(*take1) (cmd_parms *parms, void *mconfig, const char *w);
    /** function to call for a take2 */
    const char *(*take2) (cmd_parms *parms, void *mconfig, const char *w,
                          const char *w2);
    /** function to call for a take3 */
    const char *(*take3) (cmd_parms *parms, void *mconfig, const char *w,
                          const char *w2, const char *w3);
    /** function to call for a flag */
    const char *(*flag) (cmd_parms *parms, void *mconfig, int on);
} cmd_func;

enum cmd_how args_how;负责选择函数的正确版本。

处理它的交换机位于server/config.c(在invoke_cmd函数中)。

您似乎正在使用与cmd->AP_TAKE1或cmd->take1相对应的"take1"版本。

问题可能是C和c++在联合初始化方面存在差异。(AP_INIT_TAKE1使用{ .take1=func }语法，在c++中不起作用)。

您必须以c++兼容的方式初始化static const command_rec apr_cmds或将其移动到用C编译的单独目标文件中。或者如果您不使用c++，则只需使用gcc进行编译。

对于我正在进行的项目，我们最终添加了一个强制转换以允许编译成功完成，并且代码似乎工作正常，因为它正确地读取了配置文件中指定的值。以下是这种做法的摘录: extern "C" { static const command_rec kiwix_settings[] = { AP_INIT_TAKE1("zimFile", (const char* (*)())kiwix_set_zimfilename, NULL, RSRC_CONF, "The ZIM filename in full including the extension"), AP_INIT_TAKE1("zimPath", (const char* (*)())kiwix_set_path, NULL, RSRC_CONF, "The path to the ZIM file, including the trailing //"), { NULL } }; }

完整的文件(以及项目)是开源的。这是完整文件的链接https://github.com/kiwix/kiwix-apache/blob/master/mod_kiwix.cpp

PS:感谢你的问题和https://stackoverflow.com/users/257568/artemgr's的回答，因为他们帮助我和另一位志愿者解决了我们项目的问题。

相关文章：