php/php-src
一句话理解
这个仓库保存 PHP 解释器的源码。想检查某一份源码的行为,可以先把它编译成可运行的解释器,再用仓库附带的测试套件检查构建结果。编译产物和测试结果分别回答两个问题:能否构建,以及所运行的测试是否通过。
它解决什么问题
如果你想在本机检查一份 PHP 源码,或者验证自己对解释器所做的修改,需要让这份源码对应到一个实际可运行的构建。输入是选定的源码、构建依赖和配置选项,输出是编译产物和测试结果。一次基础尝试的成功标准是编译完成,选定的测试能够运行,并且你能从结果里判断哪些用例通过、哪些需要排查。只想开始写 PHP 脚本的读者可以直接使用预编译包。
从输入到输出
流程可以分成五步。第一,从 Git 源码做最小构建需要 autoconf、bison 和 re2c,默认构建还需要 libxml2 和 libsqlite3。缺少前三项中的任何一项,就不满足最小构建的前提。缺少后两项中的任何一项,就不满足默认构建的依赖要求。第二,运行 ./buildconf 生成配置脚本,供下一步使用。第三,运行 ./configure 确定本次怎样构建,做解释器开发时可采用建议的 –enable-debug。第四,用 make 编译,因为测试以编译成功为前提,所以构建中断时应先排查编译环节。第五,用 make test 检查构建结果。构建和测试完成后,可按需要用 make install 将产物安装到系统中。
用一个小任务理解
理解示例(未实测):假设你在 Ubuntu 上准备参与解释器开发,想先记录一份源码在本机的测试结果,供后续修改时比较。输入是一份选定的源码和已备齐的构建依赖。先用 ./buildconf 生成配置脚本,再用 ./configure –enable-debug 配置开发构建,接着用 make -j4 编译。编译完成后运行 make TEST_PHP_ARGS=-j4 test,让测试最多使用四个并行任务。预期得到一份调试构建和一次测试结果。把源码提交、配置选项和测试结果一起记下,后续发现失败时就有一份修改前的记录可供对照。
改变一个条件会怎样
预测与验证(待检验):只把案例中的测试并发上限从四个改为一个,预计测试会由最多四个任务并行变为逐个执行。验证时在同一台机器上用同一份编译产物,先运行 make TEST_PHP_ARGS=-j4 test,再运行 make TEST_PHP_ARGS=-j1 test。观察两次运行中同时执行的测试任务数,检查第二次是否始终最多只有一个。第一次如果有足够多可并行执行的用例,就可以直接观察到差别。
适合谁,哪里会失效
根据资料推断:这条路径适合想检查解释器行为、验证源码改动或准备贡献补丁的人。只需要运行 PHP 应用时,预编译包更直接。Windows 的源码构建有单独的指引,实践时应转到对应文档。现有片段没有给出各构建依赖的最低版本,也没有提供特定环境下的实际测试结果,因此具体机器上的构建和测试情况要以当地环境的运行结果为准。
第一次尝试时看什么
如果首次尝试只想检查语言相关用例,可以在编译成功后运行 make TESTS=tests/lang/ test。遇到构建选项问题时查阅 ./configure –help。准备提交源码改动时,再查阅仓库的贡献指南和内部文档。
发表回复