PHP 版本
本文档仅适用于基于 glibc2.12 及以上 的 Linux 或 MacOS
对于 Linux 系统,我们要求使用 g++ 5
或者更高版本进行编译。为了保证最大兼容性,我们建议你使用和生产环境相同的环境进行编译。
下面,我们以 CentOS 6
为例,讲解如何编译 OpenRASP PHP 扩展。值得注意的是,CentOS 7
的安装方法、要执行的命令完全一样。
准备环境
使用如下命令,安装 g++ 5.3.1
以及 xxd
命令
yum install -y centos-release-scl vim-common
yum install -y devtoolset-4-gcc-c++
如果你使用的是发行版自带的 PHP 软件,你还需要安装对应的头文件
yum install -y php-devel
安装完成后,执行如下命令进入编译环境
scl enable devtoolset-4 bash
安装高版本 cmake
# 下载并解压到 /tmp,避免与已有 cmake 冲突
curl -L https://github.com/Kitware/CMake/releases/download/v3.15.3/cmake-3.15.3-Linux-x86_64.tar.gz | tar zx -C /tmp
# 增加临时 PATH
export PATH=/tmp/cmake-3.15.3-Linux-x86_64/bin:$PATH
编译 openrasp-v8 基础库
在OpenRASP仓库根目录执行以下命令
# 更新 git submodule
git submodule update --init
# 编译 openrasp-v8
mkdir -p openrasp-v8/build && cd openrasp-v8/build
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DENABLE_LANGUAGES=php ..
make
编译 OpenRASP PHP 扩展
进入源代码目录,执行下面的命令即可;如果你的 PHP 是自己编译的,请使用对应路径的 phpize
命令。
# 如果之前编译过,清理下临时文件
phpize --clean
# 生成 configure 文件
phpize
# 生成 makefile
./configure --with-openrasp-v8=../../openrasp-v8/ --with-gettext --enable-openrasp-remote-manager
# 编译
make
如果 make 命令没有出错,可以继续执行 make install
安装。也可以将生成的扩展 modules/openrasp.so
复制到其它机器安装。对于扩展的具体安装方法,请参考 PHP 服务器安装