Yii 2 CRUD 生成后 URL 出现 404 错误的解决方法

本文旨在解决 Yii 2 框架中使用 Gii 生成 CRUD 后，访问对应 URL 出现 404 错误的问题。通过分析目录结构和 URL 管理器的配置，提供清晰的解决方案，帮助开发者快速定位并解决问题，确保 CRUD 功能正常访问。

Yii 2 框架的 Gii 工具可以快速生成 CRUD（Create, Read, Update, Delete）代码，极大地提高了开发效率。然而，在生成 CRUD 后，有时会出现访问 URL 时返回 404 错误的情况。这通常是由于目录结构不正确导致的。

正确的目录结构

在使用 Gii 生成 CRUD 代码后，务必确保视图文件（如 _form.php, _search.php, create.php, index.php, update.php, view.php）位于正确的目录下。 正确的目录结构应该如下所示：

backend
 common/models
  Product.php  (模型文件)

 controllers
  ProductController.php (控制器文件)

 views
  product  (视图文件目录)
   _form.php
   _search.php
   create.php
   index.php
   update.php
   view.php

错误的目录结构

常见的错误是将视图文件放置在 views/layouts 目录下。views/layouts 目录用于存放布局文件，这些文件定义了页面的整体结构，例如页眉、页脚和侧边栏。视图文件应该放置在以控制器名称命名的目录中，该目录位于 views 目录下。 例如，如果控制器是 ProductController，那么视图文件应该放置在 views/product 目录下。

URL 管理器配置

确保 URL 管理器已正确配置，以便启用美化 URL 并隐藏脚本名称。在 config/web.php 或 config/main.php 文件中，检查 urlManager 组件的配置：

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // 可以添加自定义规则，但基本配置应如上所示
        ],
    ],
],

enablePrettyUrl 必须设置为 true 才能启用美化 URL。showScriptName 必须设置为 false 才能隐藏脚本名称（例如 index.php）。rules 数组可以用于定义自定义 URL 规则，但对于基本的 CRUD 功能，通常不需要额外的规则。

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

31

查看详情

解决方法

如果遇到 404 错误，请按照以下步骤进行排查和解决：

1. 检查目录结构： 确保视图文件位于以控制器名称命名的 views 目录下的子目录中。例如，ProductController 的视图文件应位于 views/product 目录下。如果文件位置不正确，请将其移动到正确的位置。

2. 检查 URL 管理器配置： 确保 urlManager 组件已正确配置，启用了美化 URL 并隐藏了脚本名称。

3. 清除缓存： 在修改了目录结构或 URL 管理器配置后，建议清除应用程序缓存。可以使用以下命令清除缓存：

   php yii cache/flush-all

   登录后复制

4. 检查控制器名称和模型名称： 确保 URL 中的控制器名称和模型名称与实际的控制器类名和模型类名匹配。例如，如果控制器类名为 ProductController，则 URL 应该类似于 /product。

总结

Yii 2 CRUD 生成后出现 404 错误通常是由于目录结构不正确导致的。 确保视图文件位于正确的目录下，并正确配置 URL 管理器，即可解决此问题。 遵循以上步骤，可以快速定位并解决 404 错误，确保 CRUD 功能正常访问。

以上就是Yii 2 CRUD 生成后 URL 出现 404 错误的解决方法的详细内容，更多请关注php中文网其它相关文章！