PHP 8.0+ 严格限制函数参数顺序，要求所有可选参数必须置于必需参数之后；Magento 2 中若存在如 func($a, $b = [], $c) 的写法，将触发 Deprecated 警告并阻断 setup:di:compile。
php 8.0+ 严格限制函数参数顺序，要求所有可选参数必须置于必需参数之后；magento 2 中若存在如 `func($a, $b = [], $c)` 的写法，将触发 deprecated 警告并阻断 `setup:di:compile`。
在 Magento 2.4.4（及更高版本）配合 PHP 8.0/8.1/8.2 运行时，开发者常遇到如下编译错误：
Deprecated Functionality: Optional parameter $ids declared before required parameter $checkedCat is implicitly treated as a required parameter in /app/code/MGS/Fbuilder/Helper/Data.php on line 162
该错误源于 PHP 8.0 引入的参数声明一致性规则：当函数中同时存在默认值参数（即“可选参数”）和无默认值参数（即“必需参数”）时，所有带默认值的参数必须严格位于参数列表末尾。否则，PHP 将不再隐式兼容，而是直接抛出 Deprecated 级别错误——这在 Magento 的 setup:di:compile 阶段尤为敏感，会导致编译中断。
以原始问题中的方法为例：
// ❌ 错误写法（PHP 8.0+ 不允许） public function getTreeCategory($category, $parent, $ids = [], $checkedCat)
此处 $ids = [] 是可选参数，但其后紧随必需参数 $checkedCat，违反了 PHP 参数顺序规范。
立即学习“PHP免费学习笔记（深入）”；
✅ 正确修复方式是为 $checkedCat 显式赋予默认值（通常为 null），确保所有可选参数位于末尾：
// ✅ 正确写法（兼容 PHP 8.0+）
public function getTreeCategory($category, $parent, array $ids = [], $checkedCat = null)
{
// 注意：建议同时添加类型声明（如 array $ids）提升健壮性
if ($checkedCat === null) {
$checkedCat = []; // 或根据业务逻辑设置默认行为
}
// ... 原有业务逻辑
}⚠️ 重要注意事项：
- 不要仅调整参数顺序（如 ($category, $parent, $checkedCat, $ids = [])），除非调用方代码同步修改——否则将导致运行时 ArgumentCountError；
- 务必检查所有调用该方法的位置（包括模板、控制器、插件等），确认传参逻辑与新签名兼容；
- 若 $checkedCat 在业务中必须传入，应改用运行时校验替代强制参数声明，例如：
public function getTreeCategory($category, $parent, array $ids = [], $checkedCat = null)
{
if ($checkedCat === null) {
throw new \InvalidArgumentException('Parameter $checkedCat is required.');
}
// ...
}? 批量排查建议：
可通过以下命令快速定位项目中同类问题（需在 Magento 根目录执行）：
grep -r "function [a-zA-Z_][a-zA-Z0-9_]*(" app/code/ --include="*.php" | \
grep -E "\$[a-zA-Z_]+ = | = [^;]*\$" | \
grep -A5 -B5 "function"最后，虽然升级 Magento 至最新稳定版（如 2.4.7+）能获得更完善的 PHP 8.x 兼容层支持，但主动修正扩展代码中的参数声明仍是长期可维护的最佳实践——它不仅解决当前报错，更避免未来因 PHP 版本升级引发的隐性故障。
