Composer require symfony/polyfill无效，因该包仅为元包，需安装具体版本如symfony/polyfill-php80；函数生效依赖autoload.files自动加载bootstrap.php，且须确保vendor/autoload.php被正确唯一引入。
为什么composer require装不上symfony/polyfill？
因为symfony/polyfill本身不是直接运行的库，它是一组“按需加载”的兼容层，Composer 默认不会自动启用——你得手动声明需要哪些 polyfill 功能，否则require后什么也不会发生。
常见错误现象：composer require symfony/polyfill成功，但array_key_first()在 PHP 7.2 下仍报Call to undefined function。
- 必须指定具体 polyfill 包，比如
symfony/polyfill-php80，而不是笼统的symfony/polyfill - 安装后要确保自动加载机制生效：polyfill 的
bootstrap.php需被主动引入，或依赖已启用autoload.files（如symfony/polyfill-*<code>包已预配置）</li> <li>检查<code>vendor/symfony/polyfill-*/bootstrap.php
是否存在并被 Composer 的autoload.files注册（可通过composer dump-autoload -o确认）
PHP 7.1 项目里怎么让mb_str_split()可用？
这个函数是 PHP 7.3 加入的，但symfony/polyfill-php73提供了兼容实现——前提是你的代码真正在调用它，且 polyfill 已加载。
使用场景：处理多字节字符串分片，又不想升级 PHP 版本。
立即学习“PHP免费学习笔记（深入）”；
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 执行
composer require symfony/polyfill-php73 - 确认
vendor/autoload.php已被项目入口包含（绝大多数框架/脚本都已做） - 不要手动
require 'vendor/symfony/polyfill-php73/bootstrap.php'——该包已在composer.json的autoload.files中声明，自动加载器会按需触发 - 注意：polyfill 不提供
function_exists('mb_str_split')为true的“假存在”，而是通过class_alias或function定义真正注入函数，所以function_exists检测有效
json_validate()在 PHP 7.3 以下怎么补？
这个函数直到 PHP 7.3 才出现，但symfony/polyfill-php73没包含它——它属于symfony/polyfill-php80，因为 PHP 官方把它归为“PHP 8.0 新增函数”（尽管实际 7.3 就有了，但语义上被后置了）。
容易踩的坑：查文档说“PHP 7.3+”，就去装php73 polyfill，结果json_validate()还是找不到。
- 正确做法：
composer require symfony/polyfill-php80 - 该 polyfill 会检查 PHP 版本，若原生支持则跳过覆盖，否则定义函数体（内部用
json_decode($json, null, 512, JSON_THROW_ON_ERROR)模拟） - 性能影响极小：仅首次调用时做版本探测，后续直接走原生或缓存后的 polyfill 实现
- 注意
JSON_THROW_ON_ERROR常量同样由该 polyfill 提供，无需额外处理
旧项目升级时 polyfill 自动加载失效怎么办？
典型表现：本地composer install正常，function_exists('str_starts_with')返回false，但 CI 环境或生产环境却可用——本质是vendor/autoload.php没被统一路径加载，或 Composer autoloader 被重置/绕过。
关键点：polyfill 的函数定义依赖autoload.files项，而这项只在vendor/autoload.php被完整加载时才生效。
- 检查是否用了
require_once __DIR__.'/vendor/autoload.php';，而不是相对路径或拼接路径（如require_once '../vendor/autoload.php'） - 确认没有在
autoload.php之后又执行require其他 autoload 文件，导致重复初始化或覆盖 - 某些微框架（如 Slim v3）或自定义 bootstrap 可能跳过 Composer autoloader，此时需显式
require 'vendor/symfony/polyfill-php80/bootstrap.php' - 运行
composer show symfony/polyfill-php80看是否真被安装；若被其他依赖conflict掉，会静默失败
最常被忽略的是：以为装了 polyfill 就万事大吉，其实它完全依赖 Composer 的自动加载机制是否被正确、唯一、首次载入。路径错一点，或者提前触发了类加载器重置，函数就永远不出现。
