PHP项目如何配置TravisCI详解

本文详解了PHP项目在Travis CI上的正确配置要点与常见陷阱：强调`.travis.yml`必须置于项目根目录并与`composer.json`同级，PHP版本须通过`php`字段明确声明（如`"8.1"`），依赖扩展需用`addons`启用，缓存问题优先禁用验证，测试命令务必放在`script`字段执行；特别提醒PHP 8.2+需在PHPUnit配置中设置`convertDeprecationsToExceptions="false"`以避免动态属性引发的致命错误；同时指出Travis CI当前已严重限流、构建不稳定，强烈建议尽早迁移到更高效可靠的GitHub Actions生态。

Travis CI 配置文件 .travis.yml 必须放在项目根目录

PHP 项目要被 Travis CI 识别并自动构建，.travis.yml 文件不能放在 src/ 或 tests/ 下，必须和 composer.json 同级。否则 Travis 会直接跳过，连“no config file”错误都不报，只显示 Build not triggered。

常见误操作包括：

• 用 IDE 自动生成配置但保存到了子目录
• 从其他语言项目复制配置后没检查路径层级
• Git 忽略了该文件（检查 .gitignore 是否含 .travis.yml）

PHP 版本声明必须用 php 字段，不能写成 language: php 就完事

language: php 只是告诉 Travis 这是 PHP 项目，真正决定运行时环境的是 php 字段。不写它，默认用 PHP 5.6（已 EOL），CI 构建可能通过，但本地行为不一致。

推荐写法（兼容现代主流版本）：

php:
  - "8.1"
  - "8.2"
  - "8.3"

注意点：

• 字符串必须加引号，否则 7.4 会被 YAML 解析为浮点数，触发 Travis 的未知版本错误
• 不要混用 hhvm 或 nightly，它们已废弃且不稳定
• 若项目依赖扩展（如 pdo_pgsql），需用 addons 显式启用，仅声明 PHP 版本不够

Composer 安装失败常因缓存或权限问题，优先禁用缓存再排查

Travis 默认启用 Composer 缓存，但有时会卡在 composer install --no-interaction 并超时，错误信息类似：Could not fetch https://repo.packagist.org/packages.json, please review your configuration。这不是网络问题，而是缓存损坏。

临时解决方法（验证是否缓存导致）：

cache: false
before_script:
  - composer self-update
  - composer install --no-interaction --prefer-dist

长期优化建议：

• 用 cache: composer（不是 cache: true）明确指定缓存类型
• 加 composer install --no-suggest 减少非必要包下载
• 避免在 script 阶段重复执行 composer install，Travis 会自动做一次，除非你覆盖了默认流程

测试命令写错位置会导致 PHPUnit 不执行，script 字段才是关键

很多人把 phpunit 放在 before_script 或 after_success，结果 CI 显示 “build passed” 却没跑任何测试——因为 Travis 只把 script 阶段的退出码当构建成败依据，其他阶段失败默认忽略。

正确结构示例：

script:
  - vendor/bin/phpunit --configuration phpunit.xml

注意事项：

• 确保 phpunit 在 vendor/bin/ 下；若用全局安装，Travis 环境里大概率不存在
• PHP 8.2+ 默认禁用动态属性，如果测试中用了 $obj->undefined = 1，会直接 fatal，需在 phpunit.xml 中加 convertDeprecationsToExceptions="false"
• 不建议用 phpunit --testdox 做 CI 输出，部分 Travis 日志截断会导致结果误判为失败

Travis CI 对 PHP 项目的实际支持已大幅收缩（2023 年后免费版限流严重），很多构建卡在“queued”状态超过 10 分钟就超时。如果项目需要稳定、快速反馈，得提前准备好迁移到 GitHub Actions 的备用方案——它的 php-actions/composer 和 php-actions/phpunit 封装更轻量，且无需额外申请配额。

以上就是《PHP项目如何配置TravisCI详解》的详细内容，更多关于的资料请关注golang学习网公众号！