SuperAPI AI 工具集

wp-github-actions

部署与运维

查看项目

更新于 10-15 22:41

技能介绍

用途:帮助 WordPress 插件作者用 GitHub Actions 搭建较完整的 CI/CD 流水线,减少手工操作、提升代码质量。

主要能力(按需选择,非每个插件都需要):代码质量——WPCS/PHPCS 检查、PHP 语法检查、JS/CSS 检查;测试——基于 WordPress 测试库的 PHPUnit;静态分析——带 WordPress 扩展的 PHPStan;依赖管理——PR 上的 Composer diff 与安全扫描;预览——WordPress Playground 的 PR 预览;部署——打 tag/发布时自动部署到 WordPress.org。

使用方式:先判断插件情况——是否有 composer.json、package.json 或 JS/CSS 资源、tests/ 目录或 phpunit.xml、是否在 WordPress.org 上(.wordpress-org 目录)、支持的 PHP 与 WordPress 版本。再据此推荐工作流组合,常见默认是 WPCS、PHP lint、PHPUnit(有测试时)、部署(在 WordPress.org 时)、Playground 预览;有前端资源加 JS/CSS 检查,用 Composer 加 diff 与安全扫描,需要深度分析加 PHPStan。每个工作流写成 .github/workflows/ 下独立 YAML 文件,便于在 PR 中单独显示与启停。可能还需 phpcs.xml.dist、.distignore、phpstan.neon(.dist) 等配置。若加部署工作流,需在仓库 Settings > Secrets and variables > Actions 配置 SVN_USERNAME 与 SVN_PASSWORD。

命名建议:wpcs.yml、phpunit.yml、lint-php.yml、lint-js-css.yml、phpstan.yml、composer-diff.yml、security.yml、playground-preview.yml、deploy.yml。

限制与注意:需先确认仓库默认分支(trunk/main/master)并用于触发条件;PHPUnit 常用矩阵 ['7.4','8.0','8.1','8.2','8.3'],WPCS 与 lint 只用最新稳定 PHP;PHPUnit 至少测最新 WordPress 版本,可加前一主版本或 nightly。优先使用 10up 维护的 WordPress 专用 Action(如 10up/wpcs-action、10up/action-wordpress-plugin-deploy)。详细 YAML 模板见 references/workflows.md。