在 Yii2 中，控制器动作无法直接通过参数名接收含连字符（如 customer-id）的 GET 参数，因为 PHP 变量名不支持 -；正确做法是在 action 内部使用 $this->request->get('customer-id') 显式获取。
在 yii2 中，控制器动作无法直接通过参数名接收含连字符（如 `customer-id`）的 get 参数，因为 php 变量名不支持 `-`；正确做法是在 action 内部使用 `$this->request->get('customer-id')` 显式获取。
在 Yii2 的路由与参数绑定机制中，框架仅将 URL 查询参数（如 ?customer-id=7414）自动注入到 action 方法签名中，当且仅当参数名完全匹配且符合 PHP 变量命名规范（即只能由字母、数字和下划线组成，且不能以数字开头）。由于 customer-id 包含非法字符 -，以下写法会导致语法错误：
// ❌ 错误：PHP 解析失败，不是合法变量名
public function actionContact($customer-id) { ... }
因此，必须放弃“自动绑定”，改用显式方式提取参数。推荐使用控制器内置的 Request 组件（通过 $this->request 访问），这是最简洁、安全且符合 Yii2 最佳实践的方式：
public function actionContact()
{
// ✅ 正确：通过 request 组件获取带连字符的参数
$customerId = $this->request->get('customer-id', null); // 第二个参数为默认值（可选）
// 或等价写法（全局访问）
// $customerId = \Yii::$app->request->get('customer-id');
if ($customerId === null) {
throw new BadRequestHttpException('Missing required parameter: customer-id');
}
// 后续业务逻辑，例如查询用户
$customer = Customer::findOne((int)$customerId);
// ...
}
⚠️ 注意事项：
- 始终对获取的参数进行类型转换与校验（如 (int)$customerId），避免注入或类型混淆风险；
- 使用 get() 的第二个参数指定默认值（如 0 或 null），可避免未定义键触发 Notice；
- 若需同时支持 POST/GET，可用 post('customer-id') 或统一用 getBodyParam('customer-id')（适用于表单提交）；
- 不建议通过 $_GET['customer-id'] 直接访问——绕过 Yii 请求组件将丢失过滤、CSRF 防护及统一日志能力。
✅ 总结：Yii2 不支持连字符参数自动注入是语言限制所致，而非框架缺陷。拥抱显式获取模式不仅解决当前问题，更提升了代码可读性与健壮性。如需频繁处理此类参数，可封装为行为（Behavior）或基类方法复用，但切勿尝试重写参数绑定逻辑——它已由 yii\base\InlineAction 严格限定，修改成本高且易引发兼容问题。
