当前位置: 欣欣网 > 码农

AppVeyor CI 构建和发布PHP扩展

2024-05-26码农

感谢 yangweijie 大佬的投稿

介绍

AppVeyor 是一个持续集成的托管平台,它可以对GitHub等开源的项目提供免费支持,也可以通过自建方式,对私有库进行CI/CD流程,它支持Windows、Linux、MacOS系统。

AppVeyor 作为 Windows 开发者提供的持续集成工具 。它允许开发者在 Windows 环境下测试代码,并为使用 C 扩展的项目构建面向 Windows 的二进制文件 。AppVeyor 与 GitHub 和 Bitbucket 集成,能够在代码提交到这些平台后自动触发构建 。对于开源项目,AppVeyor 提供了免费的账户层,足以满足基本的持续集成需求。

开始

该工具的研究来源于我看了一个工具php monitor的里面有一个扩展,tidaways。官方个给的windows扩展点过去却看不到构建产物。

于是研究了下如何用他自己生成windows用的php扩展。

首先,是自己 fork 了一下官方的仓库到 yangweijie 账号下。登录后有个导入项目

将其导入。因为里面如果需要交互发布zip 作为release 到github 那肯定需要github 的 token 的。所以想着是将仓库转私有 再新建导入。结果发先fork 的不能转私有。网上有说免费如何用私有库的,没试。

主要是将官方的 token 通过加密后再写到 deplo 里的 auth_token 里。本来想着用环境变量的,结果折腾半天读取不对。

原官方 appveyor 配置。

image: Visual Studio 2015
version: '{branch}.{build}'
cache:
- c:\build-cache -> .appveyor.yml, .appveyor/*.cmd
environment:
PHP_BUILD_CACHE_BASE_DIR: c:\build-cache
PHP_BUILD_OBJ_DIR: c:\obj
PHP_BUILD_CACHE_SDK_DIR: c:\build-cache\sdk
PHP_BUILD_SDK_BRANCH: php-sdk-2.2.0
SDK_REMOTE: https://github.com/OSTC/php-sdk-binary-tools.git
SDK_BRANCH: php-sdk-2.2.0
matrix:
- PHP_REL: 8.0
ARCHITECTURE: x64
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
PHP_BUILD_CRT: vs16
- PHP_REL: 8.0
ARCHITECTURE: x64
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
PHP_BUILD_CRT: vs16
- PHP_REL: 8.0
ARCHITECTURE: x86
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
PHP_BUILD_CRT: vs16
- PHP_REL: 8.0
ARCHITECTURE: x86
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
PHP_BUILD_CRT: vs16
- PHP_REL: 7.4
ARCHITECTURE: x64
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.3
ARCHITECTURE: x64
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.2
ARCHITECTURE: x64
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.4
ARCHITECTURE: x64
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.3
ARCHITECTURE: x64
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.2
ARCHITECTURE: x64
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.4
ARCHITECTURE: x86
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.3
ARCHITECTURE: x86
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.2
ARCHITECTURE: x86
ZTS_STATE: enable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.4
ARCHITECTURE: x86
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.3
ARCHITECTURE: x86
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
- PHP_REL: 7.2
ARCHITECTURE: x86
ZTS_STATE: disable
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
PHP_BUILD_CRT: vc15
install:
- .appveyor\install.cmd
build_script:
- .appveyor\build.cmd

可以看出来和 github action 编译 php 扩展一样。用到了矩阵。我们要做的就是补上gitbub 部署那步。

官方文档是这么写的:

auth_token 通过 account 里的加密 yaml

获取到就行,别人最多拿到加密后字符串也没法操作你的github其他只能用于构建。然后我就尝试构建。

经过多此尝试后终于构建成功了第一次。点击项目下【构建历史】,右面显示 jobs


能看到4个job因为我精简了,只构建 7.4 , 7.3 (x86、x64) 。不然一个任务job不完成,会影响下次提交导致的构建(排队中)。只能手动取消。他文档里说 可以在构建初始化时后,rdp远程连接电脑看。

为了搞清楚最后构建成功的文件在哪里。我就加上了。他每次远程后会在桌面产生一个delete 开头的文件。构建后job 就卡住,删除文件就会继续job 测试生成的dll。

加上后 init 会显示机器远程ip:端口 用户名都固定的,密码是


自己配的。最终研究发现 他会在被远程的电脑上建一个project 里clone 除php-src 源码,然后将源码 拉取到ext 目录里,构建的dll 在build目录下。

然而,我第一次成功的名字都很奇怪,只有源码的zip。

这个得细看文档。

release: php_tideways_xhprof-v$(APPVEYOR_BUILD_VERSION)

当时yaml 是这么写的,v 因为没有tag name 他只好以分支名来作为tag,5是第5次发布。

后来既然能生成了,我干脆改了。

固定了一个名字

补了一个 tag name 的环境变量。结合架构,php版本。

这个源码的压缩包怎么来的。


build_task.cmd 里有 7zip 压缩 ext 扩展源码为压缩包,最后上传。

我依葫芦画瓢,补上了 build下dll 压缩 为dll.zip,并上传至产物。


最终我研究了半天 上传至github 只需要把deploy 下的 artifacts 或 artifacts 删除用默认的,保证 build_cmd里有

7z a php_tideways_xhprof-%APPVEYOR_REPO_TAG_NAME%-%PHP_REL%-%PHP_BUILD_CRT%!ZTS_IN_FILENAME!!ARCH_IN_FILENAME!.zip %APPVEYOR_BUILD_FOLDER%\php_tideways_xhprof-%PHP_REL%-!ZTS_SHORT!-%PHP_BUILD_CRT%-%PHP_SDK_ARCH%\*
 appveyor PushArtifact php_tideways_xhprof-%APPVEYOR_REPO_TAG_NAME%-%PHP_REL%-%PHP_BUILD_CRT%!ZTS_IN_FILENAME!!ARCH_IN_FILENAME!.zip -FileName php_tideways_xhprof-%APPVEYOR_REPO_TAG_NAME%-%PHP_REL%-%PHP_BUILD_CRT%!ZTS_IN_FILENAME!!ARCH_IN_FILENAME!.zip

类似这两行代码,就是将 build 扩展名目录压缩为压缩包,然后上传至本地 ci 的产物里。所有产物都会被上传作为release的附件。压缩包内容类似


剩下的一个方向是,这个构建用的别人电脑,能否自己电脑用于编译?

答案是可以的。


bYOC 点了新增电脑


windows 后按照要求在家里电脑执行就行。

PS> 坑很多,需要自己尝试。

之前我那个init 远程脚本没删,导致我电脑被创建了账户,关闭的防火墙又加了N多规则,本地github 连不通之类的。很麻烦。

这个 ci server 也可以局域网服务器 本地部署。

反正,折腾来折腾去半天,大部分配置、环境、网络问题。总算解决了, windows dll 生成难的问题。


贴两张 php-monitor 成功后的图 互勉。

成功也是各种问题, monitor 用的 db illuminate tp env collection 冲突啊。项目7 monitor 8 之类的。也想过这种性能数据 应该只上报,监控平台应该独立出来。可他实现接入的是通过 append php 源文件来开启的。两个项目杂交。一地鸡毛。 tidyawyes 4.17.5 后又不支持 sql 了。你看到的 sql 是我本地项目看源码模拟的

结果也不是span 那种样式。 tp trace 默日可以取到 sql 执行时间的。就是函数耗时不知道。不禁让我想到 如果ui 层做成 headless ui 多好。扩展只采集上报。当然pecl 扩展以后都是composer包了,无非性能问题。