转载

如何学习 PHP 源码 - 从编译开始

PHP Mailing Lists 上这两天有个好玩儿的问题： Introduction to the PHP source code ，大概就是有人想知道如何学习 PHP 源码，可是这种事情不是应该自己去发掘的吗？

上面是玩笑话，现在我也说说如何学习 PHP 解释器的源码。

首选你要知道的是 PHP 解释器源码的 github 地址： https://github.com/php/php-src ，话说回来还有人不知道吗？这里有几乎所有 PHP 的代码提交记录、pull requests 和一些 issue 等。

创建编译脚本或者发布包

从 Branch 中选择一个版本 tag，和每次 PHP 发布出来的版本就是一致的。也许你会发现你想编译的的时候缺找不到 configure 文件，但是有 configure.in 文件。这时候需要先执行的是 buildconf （如果是在 Windows 下面可以执行 buildconf.bat ，不过我从来没有尝试过在 Windows 下面编译 PHP，所以具体的步骤我就不清楚了）。buildconf 本身是个简单的 shell 脚本，你可以用记事本打开看看它（最终的执行文件在 build 目录里，这个目录里有一些与编译有关的文件）。

这里面涉及到一个系列的编译工具： Autotools 。如果你有兴趣，可以简单的了解一下，没有兴趣的话也不用多考虑，因为这些工具绝大多数 Linux 系统上都是已经存在的。

如果你想将 Github 上的 PHP 源码做成一个可发布的源码包，你可以看看 makedist 这个文件，它也是一个 shell 脚本（实际上源码里几乎所有跟编译相关的脚本都是 shell 脚本）。但是如果想直接执行者这个脚本，你可能会收到缺少以下组件的提示： re2c 和 Bison 。仔细看 makedist 的文件，里面有调用 genfiles 这个脚本的语句，上面两个工具就是在 genfiles 的脚本里被调用的。

re2c 和 Bison 分别是 PHP 用到的词法解析器和语法分析器。在 genfiles 这个文件中可以看到它们的调用其实是在 Makefile.frag 中写着，分别通过 zend_language_scanner.l 和 zend_language_parser.y 生成相应的 C 语言文件（这个应该很多地方都有提到过）。

编译解释器并初始化

到了编译环节，编译之前需要先通过 configure 文件生成 Makefile 然后执行 make ，所以 gcc 自然是必不可少的。configure 文件本身也是一个 shell 脚本，你也可以简单阅读一下它的内容。不过既然它是由 autoconf 从 configure.in 中生成的，也许直接查看 configure.in 会更轻松一些。

到这里总结一下就是：抛开一些核心扩展额依赖（比如 xml，ssl 等），编译 PHP 的先决条件是机器上有 Autotools 的工具（automake，autoconf 等），需要安装 re2c 和 Bison，当然还有编译工具（gcc）。

也许大家都知道，使用 configure 生成 Makefile 的时候可以通过 --prefix 参数指定目录，同时也可以选择编译哪些核心模块。至于哪些模块会被默认集成而哪些不会，这些本身是写在每个扩展的 config.m4 （也就几个是被命名为 config0.m4 或 config9.m4）文件里的的，全都通过一些 --enable 、 --disable 、 --with 和 --without 的选项来控制。

编译的也与你采用的 Web 服务器有关，这涉及到你需要使用哪个 sapi ，如果是 Apache，也许需要指定 --with-apxs2 的参数，如果是 Nginx， php-fpm 在默认条件下是会被编译的，但可以指定 php-fpm 的执行组和用户，不过这个是可以在编译完成后在配置中修改的。

编译完成之后还有一些事情需要考虑，最基本的问题是 PHP 的配置文件的问题，还有一个是如果使用的是 php-fpm，如何更便捷的控制它的启动、停止以及重启等。

在 PHP 源码根中已经准备了两份配置文件的模板： php.ini-development 和 php.ini-production 。显然是分别用于开发环境和生产环境的，将其中一个复制到配置文件目录并重命名为 php.ini 即可（如果你不知道配置文件的目录在哪里，可以使用 php --ini 命令查看）。然后也可以根据你的需要修改它。

至于 php-fpm 的控制脚本，源码中本身也是有提供的，在 sapi/fpm 目录下。这个目录下的几个文件中有 php-fpm 配置文件的模板，也有稍微修改即可放到服务器 /etc/init.d 目录下用于控制 php-fpm 的 start 、 stop 、 restart 和 reload 动作的脚本，现在的版本中也提供了用于 systemd 的 service 文件。

扩展编译

如果 PHP 编译完成之后，发现还需要一些没有编译进去的核心扩展或者第三方扩展，你可以单独编译它们。

扩展编译的整个过程一共四句命令：

phpize
./configure
make
make install

phpize 命令是用来准备 PHP 扩展库的编译环境的。在执行 phpize 的时候，如果有多个版本的 PHP，用哪个就要选哪个。这个命令和编译后的 php 的二进制文件在同一个目录中，也是一个 shell 脚本。

执行 configure 的时候，如果当前 $PATH 中找不到 php-config 或者有多个版本的 PHP 时，也需要通过 --with-php-config 的指令来指定 php-config 的目录。php-config 是一个用于获取所安装的 PHP 配置的信息，它也一样是和 php 的二进制文件在同一个目录的 shell 脚本。

phpize 和 php-config 的源码生成文件都是在 scripts 目录下。

所有工作完成之后，就可以愉快的使用你自己定制的 PHP 了。

原文 http://0x1.im/blog/php/learn-compile-php.html

正文到此结束