假设当前请求 URL
https://localhost/CMS/public/index.php?r=news&id=1
核心属性速查表
| 获取内容 | 代码 | 返回示例 | 说明 |
| 完整域名含协议 | Yii::app()->request->hostInfo | https://localhost | 无路径 |
| 当前 URL (含查询串) | Yii::app()->request->getUrl() | /CMS/public/index.php?r=news&id=1 | 不含域名 |
| 用户返回 URL | Yii::app()->user->returnUrl | /CMS/public/index.php | 登录后跳转用 |
| 首页/根 URL | Yii::app()->homeUrl | /CMS/public/index.php | 同 returnUrl |
| 基础路径(无入口文件) | Yii::app()->request->baseUrl | /CMS/public | 资源引用常用 |
| 网站根目录相对地址 | Yii::app()->baseUrl | /CMS/public | 建议补尾随斜杠 |
| 客户端 IP | Yii::app()->request->userHostAddress | 127.0.0.1 | 自动处理代理头 |
| 是否 POST 请求 | Yii::app()->request->isPostRequest | true/false | 表单提交判断 |
| protected 物理路径 | Yii::app()->basePath | /var/www/protected | 引用配置/模型路径 |
| 上一页 URL (Referer) | Yii::app()->request->urlReferrer | https://localhost/CMS/public/index.php | 返回按钮用 |
| 当前控制器 ID | Yii::app()->getController()->getId() | news | 权限/菜单高亮 |
| 当前动作 ID | Yii::app()->getController()->getAction()->id | view | 面包屑/埋点 |
| 项目根目录物理路径 | dirname(Yii::app()->basePath) | /var/www | 跨模块引用 |
| GET/POST 统一获取 | Yii::app()->request->getParam('id') | 1 | 合并 $_GET/$_POST |
进阶用法
1. 构建绝对 URL
<?php
$absolute = Yii::app()->request->hostInfo . Yii::app()->request->getUrl();
// https://localhost/CMS/public/index.php?r=news&id=1
2. 安全获取客户端真实 IP(反代后)
<?php
// 配置 components.request.trustedProxies = ['10.0.0.0/8', '192.168.0.0/16']
// Yii 自动从 X-Forwarded-For / X-Real-IP 解析
$ip = Yii::app()->request->userHostAddress;
3. 设置时区(config/main.php)
return [
'timeZone' => 'Asia/Shanghai', // 或 Asia/Chongqing
// ...
];
4. 防重复提交:PRG 模式
<?php
public function actionCreate() {
if (Yii::app()->request->isPostRequest) {
// 处理表单
if ($model->save()) {
$this->redirect(['view', 'id' => $model->id]); // 重定向到 GET 页面
}
}
$this->render('create', ['model' => $model]);
}
Yii 2 对应速查(差异点)
| Yii 1.1 | Yii 2.0 |
Yii::app()->request->hostInfo | Yii::$app->request->hostInfo |
Yii::app()->request->getUrl() | Yii::$app->request->url |
Yii::app()->user->returnUrl | Yii::$app->user->returnUrl |
Yii::app()->baseUrl | Yii::$app->request->baseUrl |
Yii::app()->request->userHostAddress | Yii::$app->request->userIP |
Yii::app()->request->isPostRequest | Yii::$app->request->isPost |
Yii::app()->basePath | Yii::$app->basePath |
Yii::app()->request->urlReferrer | Yii::$app->request->referrer |
Yii::app()->getController()->getAction()->id | Yii::$app->controller->action->id |
Yii::app()->request->getParam('id') | Yii::$app->request->get('id') / post('id') |
最佳实践
- 封装为 Helper 类
RequestHelper::getClientIp() 统一调用
- 视图中用
Yii::app()->createUrl('route', $params) 生成链接,自动处理 baseUrl
- 避免在模型/服务层直接访问
Yii::app()->request,控制器接收后作为参数传入,便于单测
收藏此速查表,Yii 开发不再查文档。