php 8.0+ 版本严格要求函数中所有可选参数必须位于必需参数之后，否则会触发“deprecated functionality”警告。本文详解该错误成因及两种合规修复方案。
php 8.0+ 版本严格要求函数中所有可选参数必须位于必需参数之后，否则会触发“deprecated functionality”警告。本文详解该错误成因及两种合规修复方案。
在 Magento 2（尤其是 2.4.4+）项目中执行 bin/magento setup:di:compile 时，若遇到如下报错：
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 及以上版本对函数签名的严格校验：可选参数（带默认值）不得出现在必需参数（无默认值）之前。而原代码中：
public function getTreeCategory($category, $parent, $ids = [], $checkedCat)
$ids = [] 是可选参数，但紧随其后的 $checkedCat 是必需参数——这在 PHP 7.x 中仅触发 E_DEPRECATED 警告（常被忽略），而在 PHP 8.0+ 中已被明确视为不合规语法，导致编译失败或运行异常。
✅ 正确修复方式有两种（推荐后者）：
方案一：为所有后续参数补全默认值（推荐）
将 $checkedCat 显式设为可选，并赋予合理默认值（如 null、[] 或 false，需结合业务逻辑判断）：
public function getTreeCategory($category, $parent, $ids = [], $checkedCat = null)
{
// 注意：调用方需适配 —— 原先传 4 个参数的调用仍有效；
// 若原逻辑中 $checkedCat 必须存在，建议改用方案二
if ($checkedCat === null) {
$checkedCat = []; // 或其他默认行为
}
// ... 实现逻辑
}
方案二：调整参数顺序（更安全，兼容性最佳）
将必需参数前置，可选参数后置，彻底符合 PHP 规范：
public function getTreeCategory($category, $parent, $checkedCat, $ids = [])
{
// $category, $parent, $checkedCat 均为必需；$ids 为可选
// 调用示例：$this->getTreeCategory($cat, $parent, $myCheckedCat, [1,2,3]);
}
⚠️ 重要注意事项：
- 修改后务必检查所有对该方法的调用点（包括模板、插件、Observer 等），确保参数顺序与数量匹配；
- 若该 Helper 方法被第三方模块或自定义代码广泛引用，建议优先采用方案一并补充类型声明（如 ?array $checkedCat = null），降低破坏性；
- 长期建议升级至 Magento 官方支持的最新稳定版（如 2.4.7+），其核心代码已全面适配 PHP 8.1/8.2；
- 执行修复后，清空生成目录并重新编译：
rm -rf generated/* bin/magento setup:di:compile bin/magento cache:clean
遵循此规范不仅能消除弃用警告，更是保障系统在高版本 PHP 环境下长期稳定运行的基础实践。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
