Rapache项目技术文档

1. 安装指南

安装环境要求

Rapache 项目适用于 Debian Linux 系统，Apache 2.2.4 版本、R 2.5.1 版本和 libapreq 2.0.4 版本。Apache2 必须编译为 prefork MPM 模式才能编译 mod_R 模块。同时，R 必须使用 --enable-R-shlib 配置选项编译。

安装步骤

以下是编译和安装 Rapache 的推荐步骤：

$ ./configure
$ make
$ make install

如果在执行 configure 脚本时无法找到所需的程序，或者如果你的依赖项安装在非标准路径下，你可以使用以下参数指定它们的路径：

--with-apache2-apxs=/path/to/apxs
--with-R=/path/to/R
--with-apreq2-config=/path/to/apreq2-config

2. 项目使用说明

Apache 配置

将以下内容添加到 Apache 配置文件中：

LoadModule R_module /path/to/mod_R.so

# 输出 R 错误和警告到浏览器
ROutputErrors

# 显示 Rapache 和 R 的信息
<Location /RApacheInfo>
    SetHandler r-info
</Location>

# 处理 /path/to/brew/scripts 目录下的所有文件
# 使用 brew 包和 brew 函数
<Directory /path/to/brew/scripts>
    SetHandler r-script
    RHandler brew::brew
</Directory>

# 通过以下 URL 执行 /path/to/r/script.R 文件
<Location /made/up/url/name>
    SetHandler r-handler
    RFileHandler /path/to/r/script.R
</Location>

设置共享库路径

libR.so 必须在共享库路径中，因为 mod_R、RApache 和其他包含共享库的包都会链接到它。你可以通过以下方式设置 LD_LIBRARY_PATH：

$ export LD_LIBRARY_PATH=`/path/to/R RHOME`/lib

或者将路径添加到 /etc/ld.so.conf 文件中，然后运行 ldconfig。

3. 项目API使用文档

本项目具体的 API 使用文档将在后续更新中提供，目前可以参考项目的主页以获取更多信息。

4. 项目安装方式

Rapache 的安装方式已在“安装指南”一节中详细说明，主要包括自动配置、编译和安装的步骤。如果有特殊需求，可以在配置阶段使用参数指定依赖项的路径。