PHP 编译器 BPC 编译实战: workerman/GatewayWorker

不了解 BPC 是什么的可以翻看之前的贴子.

简言之,BPC 可以将 PHP 代码最终转译成 C 语言,然后编译成动态链接库或者可执行程序,实现 PHP Native AOT.

1. 背景

最近在做一个招聘求职类的项目,B 端 HR 使用的是云招 OurATS 招聘管理系统,C 端求职者使用的是微信小程序.

HR 在 B 端创建的职位会显示在微信小程序上,求职者在小程序上可以浏览职位信息,就某职位和 HR 在线聊天沟通.

求职者投递简历后,也可以就此次投递和 HR 在线聊天沟通.

其中在线聊天功能是基于 workerman/GatewayWorker 实现的.

整个项目(OurATS+小程序后端+在线聊天)都使用 PHP 开发,交付给客户时,经 BPC 编译成.so 和 elf 可执行文件部署到客户的服务器上.

虽然之前就尝试着编译过 workerman,但毕竟不是真刀真枪的项目,$eventLoopClass用的还是Select.

借着这个在线聊天的机会,BPC 实现了event(core)扩展,针对 BPC 调整了部分 workerman/GatewayWorker 的代码,把 BPC 编译版本的 workerman/GatewayWorker 推向生产环境.

2. PHP 编译器 BPC 用前须知

1. BPC target 的目标是 php 7.2, 更精确地说是 php 7.2.19
2. 测试用例参看 bpc-php-7.2.19-tests
3. BPC 不支持的语法特性可以使用 phptobpc 进行转换,如果 phptobpc 也不支持,那就只能修改你的代码或者等待 BPC 升级了.
4. BPC 当前不支持的扩展一般不是大问题,因为 BPC 的扩展开发是比较容易的.
5. 目前 BPC 及其编译产物仅在 ubuntu 18.04 amd64 上完善测试过,在其它 linux 发行版上有可能能运行,大概率会遇到问题.但这并不是说 BPC 无法在其它发行版上运行,我曾在自己的 CubieBoard 7 上的 debian stretch 系统下成功编译并跑通了 phpt 测试.

3. BPC 支持编译的 workerman/GatewayWorker 版本

workerman

workerman 在 5.0 新版本中引入了 Typed Properties 特性. 也就是如下代码:

class Worker 
{
    public int $id = 0; // 注意 public 和 $id 中间的 int
}

BPC 目前不支持这一特性,所以不支持编译 workerman 5.0 版本.

BPC 当前调整好的,可以编译,基本测试没问题的版本是 workerman 4.1 版本.

Gatewayworker

GatewayWorker master 分支引入了 class method 的返回类型.也就是如下代码:

class BusinessWorker extends Worker
{
    public function run(): void // 注意 run() 后边的 : void
    {}
}

BPC 目前不支持这一特性,所以不支持编译 GatewayWorker master 分支.

BPC 当前调整好的,可以编译,基本测试没问题的版本是 GatewayWorker 3.x 分支.

4. 为了能够成功编译,需要对 workerman/GatewayWorker 源码做哪些调整?

workerman

1. 在编译的场景下, __DIR__ 的语义发生了变化,所以涉及到读写文件的__DIR__都需要调整一下.

2. BPC 不支持STREAM_CLIENT_ASYNC_CONNECT, 所以不能用 AsyncTcpConnection.php.我写了一个 SyncTcpConnection.php 来替代 AsyncTcpConnection.php,两者的区别在于最开始建立连接是同步还是异步,其它都一样.

3. BPC 实现的__destruct()不适用于 workerman 这种需要长时间运行的程序,所以有 __destruct() 方法的类都做了调整.

4. BPC 实现的 event 扩展对于长期运行的程序需要手动 free event,所以对Events/Event.php做了调整.

大的调整就这 4 点,具体细节可以查看 github commits.

GatewayWorker

1. 用到 AsyncTcpConnection 的地方都换成了 SyncTcpConnection

2. BPC 不支持class_alias, 所以代码中的 class_alias('GatewayWorker\Protocols\GatewayProtocol', 'Protocols\GatewayProtocol'); 都去掉了,需要在自己的项目里加一个如下的 class.

   <?php
   namespace Protocols;
   class GatewayProtocol extends \GatewayWorker\Protocols\GatewayProtocol
   {}
   

3. BPC 实现的 pdo 扩展对于长期运行的程序需要明确的调用 $pdo->closeConnection() 和 $stmt->destroy(), 所以对 src/Lib/DbConnection.php 做了调整.

大的调整就这 3 点,具体细节可以查看 github commits.

5. 怎么编译 workerman 4.1 和 GatewayWorker 3.x ?

1. 首先需要安装 bpc-compiler 和 phptobpc

2.  git clone [email protected]:bob-php-compiler/bpc-workerman-4.1-branch.git
    cd bpc-workerman-4.1-branch
    make
    cd Workerman
    sudo bpc -l workerman --install
   

3.  git clone [email protected]:bob-php-compiler/bpc-GatewayWorker-3.x-branch.git
    cd bpc-GatewayWorker-3.x-branch/src
    make
    cd ../GatewayWorker
    sudo bpc -l gatewayworker --install
   

现在 workerman 和 gatewaywoker 已经被编译成 .so 和 .a 并安装到 /usr/local/lib 目录下了.

接下来在编译 workerman 和 GatewayWorker 应用时只需要给 bpc 加上 -u workerman -u gatewayworker 就可以了.

关于 BPC 的高级用法请看 Wiki: 05_Advanced_usage.

6. 在 BPC Playground 里立即尝试

https://bpc.dev Try it online (BPC Playground) 里已经加上了 workerman 和 GatewayWorker 示例.

不想自己安装编译环境的可以使用这个 online compiler 立即尝试编译 workerman 和 GatewayWorker 应用.