在 Yii2 中，控制器动作无法直接通过参数名接收含连字符（如 customer-id）的 GET 请求参数，因为 PHP 变量名不支持 -；正确做法是在动作方法中通过 \Yii::$app->request->get('customer-id') 显式获取。
在 yii2 中，控制器动作无法直接通过参数名接收含连字符（如 `customer-id`）的 get 请求参数，因为 php 变量名不支持 `-`；正确做法是在动作方法中通过 `\yii::$app->request->get('customer-id')` 显式获取。
在 Yii2 的路由与参数绑定机制中，框架仅将请求参数（GET 或 POST）按严格名称匹配注入到 action 方法的形参中。例如，当访问 https://example.com/site/contact?customer-id=7414 时，Yii2 会尝试查找名为 customer-id 的方法参数——但这是非法的 PHP 标识符，会导致语法错误（Parse error: syntax error, unexpected '-'），因此以下写法不可行：
// ❌ 错误：PHP 语法不允许变量名含连字符
public function actionContact($customer-id) { }✅ 正确方案是放弃参数自动绑定，改用 Request 组件显式提取：
use yii\web\Controller;
class SiteController extends Controller
{
public function actionContact()
{
// 推荐：使用 $this->request（需确保继承自 yii\web\Controller）
$customerId = $this->request->get('customer-id', null); // 第二个参数为默认值
// 或等价写法（全局方式，兼容性更强）
// $customerId = \Yii::$app->request->get('customer-id', 0);
if ($customerId === null) {
throw new \yii\web\BadRequestHttpException('Missing required parameter: customer-id');
}
// 后续业务逻辑，例如查询用户
$customer = \app\models\Customer::findOne($customerId);
return $this->render('contact', ['customer' => $customer]);
}
}⚠️ 注意事项：
- 不要尝试用 $_GET['customer-id'] 替代——这绕过了 Yii2 的请求组件，丢失了类型安全、过滤（如 get() 支持默认值和类型转换）、CSRF 防护上下文及统一日志追踪能力；
- 若需频繁处理此类参数，可封装为行为（Behavior）或基类方法，例如：
protected function getParam($key, $default = null) { return $this->request->get(str_replace('_', '-', $key), $default); } - 对于 RESTful 场景，建议统一使用下划线命名（customer_id）或驼峰式（customerId）以避免该问题；若必须兼容外部系统传入的 kebab-case，显式获取是最清晰、最可控的方式。
总结：Yii2 的 action 参数绑定基于 PHP 语言规范，不支持非标准标识符；面对 customer-id 这类参数，应主动调用 $this->request->get() 获取，兼顾健壮性、可读性与框架最佳实践。
