AppVeyor CI 构建和发布PHP扩展

Tinywan

发布于 2024-06-04 19:03:02

1000

发布于 2024-06-04 19:03:02

介绍

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是我本地项目看源码模拟的