PHP 版本

简要说明

本文档仅适用于 1.0 版本，新的文档还在编写中。目前请参考 git 目录下的 build-php5.sh / build-php7.sh 来了解如何编译

PHP 版本依赖于如下几个库:

Linux 系统

对于 Linux 系统，我们要求使用 g++ 4.9 或者更高版本进行编译，并静态链接 libstdc++，否则可能在其他机器出现兼容性问题。当然，为了保证最大兼容性，我们建议你使用和生产环境相同的环境进行编译。

下面，我们以 CentOS 6 为例，讲解如何编译 OpenRASP PHP 扩展。值得注意的是，CentOS 7 的安装方法、要执行的命令完全一样。

首先，我们来准备编译环境

使用如下命令，安装 devtools-3 (g++ 4.9.2) 以及 xxd 命令

  1. yum install -y centos-release-scl vim-common libuuid-devel pcre-devel
  2. yum install -y devtoolset-3-gcc-c++

如果你使用的是发行版自带的 PHP 软件，你还需要安装对应的头文件

  1. yum install -y php-devel

安装完成后，执行如下命令进入编译环境

  1. scl enable devtoolset-3 bash
  3. -或者-
  5. source /opt/rh/devtoolset-3/enable

然后，我们来编译 Google V8。为了节省编译时间，我们提供了编译好的 libv8-5.9-linux.tar.gz，可直接下载使用。我们下载并解压到 /tmp:

  1. wget https://packages.baidu.com/app/openrasp/libv8-5.9-linux.tar.gz -P /tmp
  2. tar -xvf /tmp/libv8-5.9-linux.tar.gz -C /tmp

最后，我们来编译 OpenRASP PHP 扩展

进入源代码目录，执行下面的命令即可；如果你的 PHP 是自己编译的，请使用对应路径的 phpize 命令。

  1. # 如果之前编译过，清理下临时文件
  2. phpize --clean
  4. # 生成 configure 文件
  5. phpize
  7. # 生成 makefile
  8. ./configure --with-v8=/tmp/libv8-5.9-linux --enable-openrasp-remote-manager --with-gettext -q
  10. # 编译
  11. make

若要指定 curl/pcre/openssl 路径，请在 configure 阶段增加如下参数，e.g

  1. --with-curl=/tmp/static-lib --with-openssl=/tmp/static-lib --with-pcre-regex=/tmp/static-lib

如果 make 命令没有出错，可以继续执行 make install 安装。也可以将生成的扩展 modules/openrasp.so 复制到其它机器安装。对于扩展的具体安装方法，请参考 PHP 服务器安装

Mac 系统

为了节省时间，我们也提供了编译好的类库 libv8-5.9-macos.tar.gz，适用于 MacOS 10.X，可直接下载使用。其余步骤同 Linux 系统。

常见问题

1. static libc++ library "libstdc++.a" unavailable 警告

当编译环境缺少 C++ 静态链接库时，即 libstdc++.a，我们会在 configure 脚本里打印这个警告:

  1. # ./configure --with-v8=/tmp/libv8 -q
  2. configure: WARNING: You will need re2c 0.13.4 or later if you want to regenerate PHP parsers.
  3. Warning: static libc++ library "libstdc++.a" unavailable, porting to other system may fail!

如果不能静态链接 C++ 函数库，将编译好的扩展安装到生产环境时可能会出现找不到 libstdc++.so 这样的错误。当然，如果你的编译环境和生产环境完全相同，可以忽略这个错误。

2. php_pcre_free 未定义错误

PHP 集成了 pcre 源代码，并在自己的头文件里，将 pcre_free 重新定义为了 php_pcre_free，所以出现了这个错误。一个简单的方法是修改 php_compat.h，去掉这个 define。e.g 打开 /usr/include/php/main/php_compat.h，找到如下代码:

  1. #if defined(HAVE_BUNDLED_PCRE) || !defined(PHP_VERSION)

将这一行修改为:

  1. #ifdef WHATEVER_YOU_LIKE

然后重新编译即可。