Composer如何使用Composer Platform Config_Composer Platform Config使用教程-composer-PHP中文网

composer 的 platform 配置仅在 composer update 时生效，用于声明目标环境的 php 版本与扩展，必须置于 config 对象内且格式严格；写错不报错但静默失效，需删 lock 和 vendor 重装验证。

composer如何使用composer platform config_composer platform config使用教程

Composer 的 platform 配置不是“让 PHP 变成另一个版本”，它只在 composer update 时起作用——告诉 Composer：“请按这个 PHP 版本和扩展列表去选包”，其他时候完全不干预。

platform 必须写在 composer.json 的 config 对象里

常见错误是把它扔到顶层、require 下，或者拼错 key 名。只有下面这种结构才生效：

{
  "require": { "monolog/monolog": "^3.0" },
  "config": {
    "platform": {
      "php": "8.1.25",
      "ext-mbstring": "*",
      "ext-openssl": "*"
    }
  }
}

错误写法包括："platforms"（多一个 s）、"platform.php"（点号非法）、"platform": "8.1.25"（必须是对象，不能是字符串）。写错后 Composer 不报错，但配置静默失效。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

改完必须删掉 composer.lock 和 vendor/，否则旧锁文件会缓存之前解析结果
运行 composer show -p php 可验证当前生效的伪装 PHP 版本
扩展名必须和 php -m 输出一致，比如 ext-gd 不能写成 gd 或 ext-gd.so

为什么必须写具体小版本，比如 "8.1.25" 而不是 "^8.1"

Composer 解析 ^8.1 时可能当作 8.1.99 处理，导致它选了一个只在 PHP 8.2 才有的函数（比如 str_starts_with()）的包版本，而你的目标环境其实是 8.1.25 —— 运行时报错，但 composer update 却没拦住。

扩展版本值可以是任意非空字符串（"1"、"present"、"8.1.25" 都行），Composer 只检查是否存在，不校验语义
如果项目 require 里写了 "php": "^8.1"，你 platform 设成 "8.0.0"，composer update 会直接失败：约束冲突
宝塔或 Docker 多 PHP 环境下，platform 再准也没用——真正执行 composer install 的 PHP 二进制路径才是关键，先查 which php，再确认对应 /www/server/php/82/bin/php -v

platform-check-file 是什么，什么时候要用

这是 Composer 2.5+ 引入的高级选项，适用于 CI/CD 中“真实 PHP 环境混乱但目标明确”的场景。比如 GitHub Actions 里用 shivammathur/setup-php 装了 PHP 8.1，但宿主机 php -v 是 8.0 —— 此时 Composer 默认会先检测真实环境，失败就退出，根本读不到你的 platform。

必须同时设置 "platform-check": false，否则 platform-check-file 不生效
platform-check-file 指向一个 JSON 文件，内容格式和 config.platform 完全一样
它不替代 platform，而是绕过真实环境检测的兜底机制；日常开发几乎用不到

别把 platform 当运行时补丁

设了 "ext-sodium": "*"，不代表生产服务器上 php -m | grep sodium 就真有；设了 "php": "8.2.0"，也不代表 php -v 会变。它只影响依赖选择逻辑，而运行时是否崩，取决于真实 PHP 版本、已加载扩展、以及函数是否存在。

宝塔中每个 PHP 版本的扩展要单独勾选启用，不是“装一次，全版本生效”
本地开发用 Xdebug，但生产禁用？可以加 "ext-xdebug": "3.0.0" 到 platform，配合 --no-dev 避免误装带调试依赖的包
团队协作时，platform 必须提交到 git，否则每人 composer update 结果可能不同