polyfill 不是自动补全黑盒，需按需安装子包、确保 autoload.files 注册、且原生函数不存在时才生效；symfony/polyfill 是无代码的元包，首次使用应直装如 symfony/polyfill-php73 等子包。
直接说结论：polyfill 不是“装了就自动补全所有缺失功能”的黑盒，它必须按需安装具体子包、依赖 autoload.files 正确注册、且函数调用时原生不存在才会生效——漏掉任一环节，Call to undefined function 照样报。
为什么 composer require symfony/polyfill 没用？
因为 symfony/polyfill 是元包（metapackage），只声明依赖，不提供任何实际代码。它不会自动加载任何 bootstrap 文件，也不会定义任何函数。
- 运行
composer require symfony/polyfill后，vendor/autoload.php里仍没有array_key_first()的定义 - 真正起作用的是子包，比如
symfony/polyfill-php73或symfony/polyfill-mbstring - 元包只有在你已安装部分 polyfill 后，再执行
composer update才可能补全遗漏项；纯新项目请跳过它，直装子包
如何选对 polyfill 子包？
别看 PHP 官方文档写的“PHP 7.3+”，得查 Symfony Polyfill 的实际归属——同一个函数，在不同版本的 polyfill 包里可能归属不同。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
mb_str_split()在symfony/polyfill-php73中 → 装composer require symfony/polyfill-php73 -
json_validate()虽然 PHP 7.3 就有雏形，但官方归入 PHP 8.0 特性 → 必须装symfony/polyfill-php80，装 php73 包无效 - 缺
ext-intl但用了IntlCalendar::createInstance()→ 要symfony/polyfill-intl-idn+symfony/polyfill-intl-normalizer，单装一个不够 - 想一揽子解决常见缺失？可试
composer require symfony/polyfill，但它只在已有 polyfill 基础上做增量补充，首次使用仍推荐按需点名安装
函数还是报错？检查 autoload.files 是否生效
每个 symfony/polyfill-* 子包都在其 composer.json 的 autoload.files 字段中声明了 bootstrap.php。这个文件才是函数定义的实际载体。
- 确认该文件存在：
vendor/symfony/polyfill-php73/bootstrap.php - 确认它被注册进 autoloader：运行
composer dump-autoload -o，然后检查vendor/composer/autoload_files.php是否包含对应路径 - 不要手动
require 'vendor/symfony/.../bootstrap.php'—— 这会破坏 polyfill 的function_exists()检测逻辑，可能导致重复定义警告 - 如果你用的是自定义 autoloader（非 Composer 默认），或入口脚本没引入
vendor/autoload.php，polyfill 根本不会触发
扩展类 polyfill（如 intl、xmlrpc）和函数 polyfill 的关键区别
函数 polyfill 靠 function_exists() 判断后定义；扩展类 polyfill（如 phpxmlrpc/polyfill-xmlrpc 或 symfony/polyfill-intl-* ）往往还依赖数据文件或静态初始化，行为更重。
-
phpxmlrpc/polyfill-xmlrpc会自动注册XmlRpcClient类，但若你代码里写的是new \XmlRpcClient()而不是new \PhpXmlRpc\Client()，依然会失败——注意命名空间是否匹配 -
symfony/polyfill-intl-*包含 ICU 数据文件（如Resources/unidata/），这些文件随包发布，但某些精简部署会误删Resources/目录，导致IntlDateFormatter构造失败 - polyfill 的
class_alias()或 trait 注入，无法骗过instanceof或反射获取原始类名，框架内做类型校验时可能绕不过
最常被忽略的一点：polyfill 补的是“函数是否存在”和“类能否 new”，不补“扩展是否启用”的运行时环境判断。比如你代码里写了 if (extension_loaded('mbstring')) { ... }，即使 symfony/polyfill-mbstring 已生效，这个条件仍是 false —— polyfill 不会伪造 extension_loaded() 返回值。
