composer require symfony/polyfill无效，因其仅为元包，不提供实际函数；须安装具体子包（如symfony/polyfill-php80），并确保autoload.files注册了对应bootstrap.php且被vendor/autoload.php唯一引入。
直接用 composer require 安装对应 polyfill 包即可生效，但必须确认它被自动加载且没被跳过——否则函数依然报错。
为什么 composer require symfony/polyfill 没用？
因为 symfony/polyfill 是个元包（meta package），它本身不提供任何函数定义，只声明依赖。Composer 安装后不会自动启用任何 polyfill。
- 真正起作用的是具体子包，比如
symfony/polyfill-mbstring、symfony/polyfill-php80 - 如果你只运行
composer require symfony/polyfill，而项目 PHP 版本是 8.1，它会拉取polyfill-php80等，但不会强制加载 —— 还得靠 autoloader 触发bootstrap.php - 验证方式：装完后执行
composer dump-autoload -o，再检查vendor/autoload.php是否包含autoload.files条目（如vendor/symfony/polyfill-mbstring/bootstrap.php）
该装哪个 polyfill 包？看缺什么函数或扩展
别猜，先定位报错：
- 报
Call to undefined function mb_strlen()→ 装symfony/polyfill-mbstring - 报
Call to undefined function json_validate()（PHP 8.3 新增）→ 实际属于symfony/polyfill-php83，不是php80 - 服务器没开
ext-intl，但用了Normalizer::normalize()→ 装symfony/polyfill-intl-normalizer - 想一揽子补全常用缺失 → 装
symfony/polyfill元包，它会按当前PHP_VERSION_ID自动选子包（如 PHP 7.4 环境会装polyfill-php74+polyfill-mbstring等）
装完函数还是不存在？检查加载链是否断裂
polyfill 不是“声明存在”，而是真正在运行时定义函数 —— 所以加载顺序和入口包含很关键：
- 确保项目入口（如
index.php或测试脚本）第一行是require __DIR__.'/vendor/autoload.php';，且只引入一次 - 不要手动
require 'vendor/symfony/polyfill-*/bootstrap.php'，这会绕过 Composer 的版本探测逻辑，可能导致重复定义或跳过原生函数 - 如果用了自定义 autoloader 或微框架（如 Slim、Laravel Octane），确认它没屏蔽
autoload.files的执行 - 运行
var_dump(function_exists('mb_str_split'));测试 —— 注意：mb_str_split属于 PHP 7.3，但 polyfill 在symfony/polyfill-php80中才提供（官方归类如此），不是polyfill-php73
最容易被忽略的是：polyfill 的 bootstrap 文件只在首次调用相关函数时触发加载，而不是随 autoloader 启动就全部注入。这意味着，如果你的代码在函数定义前就做了 function_exists 检查，可能拿到 false —— 这不是 bug，是设计使然。
