必须安装具体子包（如symfony/polyfill-php80）而非元包symfony/polyfill，因其无autoload且不提供函数；子包通过bootstrap.php按需定义函数，需确保vendor/autoload.php正确引入并执行dump-autoload。
直接装 symfony/polyfill 没用，它只是个元包，不提供任何函数；必须按需安装具体子包，比如 symfony/polyfill-php80 或 symfony/polyfill-mbstring，否则 str_starts_with()、json_validate() 这类函数照样报错。
为什么 composer require symfony/polyfill 不生效
这个包在 Composer 里被定义为 metapackage（元包），它的 composer.json 里只有 "require" 字段，没有 "autoload"，也不含任何 PHP 文件。它只起“依赖声明汇总”作用，不会注册任何 autoload.files，更不会加载 bootstrap.php。
- 运行
composer require symfony/polyfill后，vendor/autoload.php里依然找不到array_key_first()的定义 - 真正提供函数的是子包，如
symfony/polyfill-php73（含array_key_first）、symfony/polyfill-php80（含json_validate） - 函数归属不看“PHP 官方文档写的最低版本”，而看 Symfony Polyfill 的实际归类——
json_validate虽然 PHP 7.3 就有雏形，但官方归入 PHP 8.0 特性，必须装symfony/polyfill-php80
如何选对 polyfill 子包并确保函数可用
每个子包都通过 autoload.files 声明了对应的 bootstrap.php，该文件在自动加载阶段执行，内部用 function_exists() 判断是否需要定义函数。只要 vendor/autoload.php 被项目入口正确且唯一引入，就无需手动 require。
- 确认
vendor/symfony/polyfill-php80/bootstrap.php文件存在 - 运行
composer dump-autoload -o，然后检查vendor/composer/autoload_files.php是否包含该路径 - 不要手动
require 'vendor/symfony/polyfill-php80/bootstrap.php'——会破坏function_exists()检测逻辑，可能触发重复定义警告 - 验证方式：写一行
var_dump(function_exists('str_contains'));，输出bool(true)才算真正生效
用 replace 移除冗余 polyfill 降低开销
当你升级 PHP 版本或启用原生扩展后，对应 polyfill 就成了累赘。Composer 的 replace 字段能明确告诉它：“这个功能我原生支持，别再装了”。这能减少依赖树体积、缩短 composer install 时间，并避免潜在的函数覆盖冲突。
- 例如 PHP 8.0+ 环境下，可在
composer.json中添加："replace": { "symfony/polyfill-php80": "*" } - 执行
composer update --lock后，运行composer show | grep polyfill应不再列出被 replace 的包 - 注意：仅当服务器确实具备对应能力时才加
replace，比如启用了mbstring扩展才能安全replace "symfony/polyfill-mbstring"
扩展缺失时的替代方案：xmlrpc、DS 等非核心扩展
像 xmlrpc 或 ds 这类非默认启用的扩展，polyfill 方案更侧重“功能模拟”而非“版本降级”。它们不依赖 PHP 版本号判断，而是直接提供完整实现，只要函数签名一致，业务代码完全不用改。
-
phpxmlrpc/polyfill-xmlrpc提供全部xmlrpc_*函数，兼容 PHP 5.4–8.3，但不支持xmlrpc_server_call_method()的第三个回调上下文参数 -
php-ds/polyfill实现Map、Set等数据结构接口，行为与原生ext-ds一致，适合跨版本兼容老项目 - 这类 polyfill 同样依赖
autoload.files，安装后只需确保vendor/autoload.php被引入，无需额外配置
最容易被忽略的一点：polyfill 生效的前提是“原生函数不存在”，而这个判断发生在第一次调用时；如果某处代码在 autoload 阶段就提前检测了 function_exists()，但此时 bootstrap 尚未执行，结果会是 false——这种竞态问题在自定义 autoloader 或早期引导逻辑里容易出现。
