本文旨在解决Yii 2框架中使用Gii生成的CRUD模块，在配置了URL美化后，访问Product控制器时出现404错误的问题。通过分析目录结构和视图文件存放位置，提供详细的解决方案，帮助开发者正确配置和访问CRUD模块，避免常见的URL路由问题。
问题分析
在使用Yii 2的Gii工具生成CRUD（Create, Read, Update, Delete）模块后，如果启用了URL美化，可能会遇到访问控制器时出现404错误。这通常是由于视图文件存放位置不正确导致的。Yii 2框架对视图文件的存放位置有严格的要求，如果视图文件存放位置不符合规范，会导致框架无法正确找到对应的视图文件，从而抛出404错误。
解决方案
正确的视图文件存放位置应该在views目录下，并以控制器名称命名子目录。例如，对于ProductController，其对应的视图文件应该存放在views/product目录下。
步骤如下：
-
检查视图文件目录结构： 确保你的视图文件目录结构如下所示：
views/ product/ _form.php _search.php create.php index.php update.php view.php如果你的视图文件存放在views/layouts/product目录下，你需要将其移动到views/product目录下。
-
确认 URL 管理器配置： 检查你的config/web.php（或config/main.php）文件中的URL管理器配置，确保启用了URL美化，并设置了正确的规则。
'components' => [ 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ // 可以在这里添加自定义规则，但通常情况下，默认规则已经足够 ], ], ],enablePrettyUrl设置为true表示启用URL美化，showScriptName设置为false表示隐藏index.php入口文件。
检查控制器名称： 确认你的控制器名称是否正确。例如，ProductController应该对应于product路由。
-
清除缓存： 在修改了配置文件或视图文件后，建议清除Yii 2的缓存。可以使用以下命令：
php yii cache/flush-all
示例代码
假设你的ProductController的代码如下：
<?php
namespace backend\controllers;
use Yii;
use backend\models\Product;
use backend\models\ProductSearch;
use yii\web\Controller;
use yii\web\NotFoundHttpException;
use yii\filters\VerbFilter;
/**
* ProductController implements the CRUD actions for Product model.
*/
class ProductController extends Controller
{
/**
* {@inheritdoc}
*/
public function behaviors()
{
return [
'verbs' => [
'class' => VerbFilter::class,
'actions' => [
'delete' => ['POST'],
],
],
];
}
/**
* Lists all Product models.
* @return string
*/
public function actionIndex()
{
$searchModel = new ProductSearch();
$dataProvider = $searchModel->search(Yii::$app->request->queryParams);
return $this->render('index', [
'searchModel' => $searchModel,
'dataProvider' => $dataProvider,
]);
}
/**
* Displays a single Product model.
* @param int $id ID
* @return string
* @throws NotFoundHttpException if the model cannot be found
*/
public function actionView($id)
{
return $this->render('view', [
'model' => $this->findModel($id),
]);
}
/**
* Creates a new Product model.
* If creation is successful, the browser will be redirected to the 'view' page.
* @return string|\yii\web\Response
*/
public function actionCreate()
{
$model = new Product();
if ($model->load(Yii::$app->request->post()) && $model->save()) {
return $this->redirect(['view', 'id' => $model->id]);
}
return $this->render('create', [
'model' => $model,
]);
}
/**
* Updates an existing Product model.
* If update is successful, the browser will be redirected to the 'view' page.
* @param int $id ID
* @return string|\yii\web\Response
* @throws NotFoundHttpException if the model cannot be found
*/
public function actionUpdate($id)
{
$model = $this->findModel($id);
if ($model->load(Yii::$app->request->post()) && $model->save()) {
return $this->redirect(['view', 'id' => $model->id]);
}
return $this->render('update', [
'model' => $model,
]);
}
/**
* Deletes an existing Product model.
* If deletion is successful, the browser will be redirected to the 'index' page.
* @param int $id ID
* @return \yii\web\Response
* @throws NotFoundHttpException if the model cannot be found
*/
public function actionDelete($id)
{
$this->findModel($id)->delete();
return $this->redirect(['index']);
}
/**
* Finds the Product model based on its primary key value.
* If the model is not found, a 404 HTTP exception will be thrown.
* @param int $id ID
* @return Product the loaded model
* @throws NotFoundHttpException if the model cannot be found
*/
protected function findModel($id)
{
if (($model = Product::findOne($id)) !== null) {
return $model;
}
throw new NotFoundHttpException('The requested page does not exist.');
}
}确保actionIndex()方法渲染的视图文件是views/product/index.php，actionView()方法渲染的视图文件是views/product/view.php，以此类推。
注意事项
- 视图文件命名： 视图文件的命名应该与控制器中的 action 方法相对应。例如，actionIndex 对应 index.php，actionCreate 对应 create.php。
- 布局文件： views/layouts 目录用于存放布局文件，而不是 CRUD 模块的视图文件。
- URL 规则： 如果需要自定义 URL 规则，可以在 URL 管理器的 rules 数组中添加。
总结
解决Yii 2 CRUD模块访问出现404错误的关键在于确保视图文件存放位置正确。遵循Yii 2的目录结构规范，将视图文件存放在以控制器名称命名的子目录下，可以避免此类问题。同时，正确配置URL管理器，并清除缓存，可以确保URL路由正常工作。通过以上步骤，可以成功访问Gii生成的CRUD模块，并进行后续的开发工作。
