apache模块开发有四种主流路径：一、用apxs快速生成编译；二、基于源码树手工编译；三、用cmake跨平台构建；四、在docker容器中开发测试。
如果您希望为 Apache 服务器添加特定功能，例如拦截请求、修改响应头或注入自定义逻辑，则需通过编写 C 语言编写的动态模块来实现。以下是基于标准 Apache 2.4 API 的多种可行开发路径：
一、使用 apxs 工具快速生成并编译模块
apxs 是 Apache 官方提供的模块构建工具，适用于快速原型开发，无需手动编写 Makefile 或管理依赖路径。
1、安装 Apache 开发包：运行 sudo yum install httpd-devel（CentOS/RHEL）或 sudo apt install apache2-dev（Ubuntu/Debian）。
2、生成模块骨架：执行 apxs -g -n mymod，将在当前目录创建 mymod/ 文件夹，含 mod_mymod.c 和基础构建文件。
3、编辑源码：在 mod_mymod.c 中替换 handler 函数，例如返回固定文本或记录日志到 error_log。
4、编译并安装：进入 mymod 目录，运行 sudo apxs -c -i -a mod_mymod.c，该命令将编译共享对象、复制至 modules 目录，并自动在配置中添加 LoadModule 指令。
5、验证模块加载：执行 httpd -M | grep mymod 或 apache2ctl -M | grep mymod，确认输出包含 mymod_module (shared)。
二、基于源码树手工编译模块
当需深度集成 Apache 内部结构（如访问核心钩子、使用 APR 高级特性）或调试模块行为时，直接在 Apache 源码树中编译可获得完整符号支持和调试信息。
1、获取 Apache 源码：从 https://httpd.apache.org/download.cgi 下载对应版本的 httpd-2.4.x.tar.gz 并解压。
2、配置构建环境：进入源码根目录，运行 ./configure --enable-so --enable-mods-shared=all，确保启用动态模块支持。
3、将模块源文件放入 modules/experimental/（或其他子目录），例如命名为 mod_custom.c。
4、修改 modules/experimental/Makefile.in，在 MODULES_ENTRIES 行追加 mod_custom.lo；在 SOURCES 行添加 mod_custom.c。
5、执行 make && sudo make install，模块将被静态或动态链接进 httpd 二进制或 modules 目录，取决于 configure 参数。
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
三、使用 CMake 构建跨平台模块
对于需要在多操作系统（Linux/macOS/Windows with MSVC）统一构建流程的项目，CMake 提供更灵活的依赖管理和构建抽象，尤其适合复杂模块含外部库依赖的情形。
1、创建 CMakeLists.txt，设置最低 CMake 版本、项目名，并查找 Apache2 包：find_package(Apache2 REQUIRED)。
2、声明模块源文件：使用 add_library(mod_custom MODULE mod_custom.c)，并设置输出名称为 mod_custom.so（Linux/macOS）或 mod_custom.dll（Windows）。
3、链接 Apache 库：调用 target_link_libraries(mod_custom ${APACHE2_LIBRARIES})，并包含头文件路径：target_include_directories(mod_custom PRIVATE ${APACHE2_INCLUDE_DIRS})。
4、生成构建系统：运行 cmake -B build -S . -DAPACHE2_DIR=/usr/lib64/httpd（路径依实际调整）。
5、编译并安装：进入 build 目录，执行 cmake --build . --target install，模块将被复制至指定模块目录。
四、在容器环境中开发与测试模块
利用 Docker 可隔离开发环境，避免污染宿主机 Apache 配置，同时支持快速回滚与协作复现，特别适用于 CI/CD 流水线中的模块验证阶段。
1、准备基础镜像：基于官方 httpd:2.4 镜像，安装 build-essential 和 apache2-dev（Debian）或 gcc httpd-devel（Alpine/CentOS）。
2、挂载模块源码：使用 docker run -v $(pwd)/src:/module-src -v $(pwd)/conf:/usr/local/apache2/conf 启动容器。
3、在容器内编译：进入 /module-src，运行 apxs -c -i -a mod_test.c，模块将写入容器内 modules 目录。
4、配置启用：在挂载的 conf 目录中添加 LoadModule test_module modules/mod_test.so 到 httpd.conf。
5、启动服务并测试：执行 docker exec -it httpd-container httpd -t 验证语法，再运行 curl -I http://localhost 观察响应头或内容是否体现模块逻辑。
