讲师中心 微信公众号
AI工具推荐 视频效率加速

Laravel 中控制器(Controller)的正确使用方式

云萱大大_7809

云萱大大_7809

发布时间:2026-06-09 09:18:20

|

504人浏览过

|

来源于php中文网

原创

Laravel 中控制器(Controller)的正确使用方式

本文详解 laravel mvc 架构下控制器的规范职责:控制器应专注处理请求、协调业务逻辑与数据传递,绝不直接在视图中调用控制器静态方法或执行数据库查询。

本文详解 laravel mvc 架构下控制器的规范职责:控制器应专注处理请求、协调业务逻辑与数据传递,绝不直接在视图中调用控制器静态方法或执行数据库查询。

在 Laravel 的 MVC(Model-View-Controller)设计模式中,控制器的核心职责是接收 HTTP 请求、调用模型获取/处理数据,并将结果传递给视图进行渲染——它绝不是数据访问层,更不应被视图为“工具类”直接静态调用。

你原始代码中的写法:

<?php $states = App\Http\Controllers\StatesController::getStates(); ?>

存在多个严重问题:

  • ❌ 违反单一职责原则:控制器方法被当作工具函数滥用,破坏了请求生命周期;
  • ❌ 绕过路由机制:未通过 Route → Controller → View 流程,导致中间件、认证、CSRF 防护等 Laravel 核心能力全部失效;
  • ❌ 紧耦合且不可测试:视图强依赖控制器类路径和静态方法,无法单元测试,也难以维护;
  • ❌ 模型逻辑泄露到控制器:getStates() 直接操作 DB::table(),本应由 Eloquent Model 封装。

✅ 正确做法遵循标准 Laravel 流程:

  1. 定义路由(routes/web.php)

    use App\Http\Controllers\LocationController;
    
    Route::get('/', [LocationController::class, 'index'])->name('home');
  2. 在控制器中组织逻辑(app/Http/Controllers/LocationController.php)

    <?php
    
    namespace App\Http\Controllers;
    
    use App\Models\State;
    use App\Models\Country;
    use Illuminate\Http\Request;
    
    class LocationController extends Controller
    {
        public function index()
        {
            // 使用 Eloquent Model(推荐)——语义清晰、支持关系、可测试
            $states = State::orderBy('name')->get();
            $countries = Country::orderBy('name')->get();
    
            // 或使用查询构造器(如需复杂原生逻辑)
            // $states = DB::table('states')->orderBy('name')->get();
    
            return view('home', compact('states', 'countries'));
        }
    }
  3. 在 Blade 视图中仅负责展示(resources/views/home.blade.php)

    laravel-specialist
    laravel-specialist

    精通 Laravel 10+,遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

    下载
    <!DOCTYPE html>
    <html>
    <head><title>Locations</title></head>
    <body>
        <h2>States</h2>
        @forelse($states as $state)
            <p>{{ $state->name }}</p>
        @empty
            <p>No states found.</p>
        @endforelse
    
        <h2>Countries</h2>
        @forelse($countries as $country)
            <p>{{ $country->name }}</p>
        @empty
            <p>No countries found.</p>
        @endforelse
    </body>
    </html>

? 关键注意事项:

  • ✅ 始终通过 view() 返回响应,确保完整的 Laravel 生命周期(事件、中间件、异常处理等)生效;
  • ✅ 数据库操作应封装在 Model 层(如 State::all()),控制器只做协调;若需复用查询逻辑,可提取为 Model 的 scope 或 Repository;
  • ✅ 避免在视图中写 PHP 逻辑(如 )、调用静态方法或直连数据库;
  • ✅ 对于多模型数据,优先使用 compact()、with() 或数组解构传递,保持视图轻量;
  • ⚠️ 若未来需分页、搜索或缓存,上述结构可无缝扩展(例如 State::paginate(15) + {{ $states->links() }})。

总结:Laravel 的控制器不是“万能助手”,而是 MVC 中承上启下的协调者。坚守“路由驱动、控制器调度、模型承载、视图呈现”的分工,才能写出可维护、可测试、符合 Laravel 哲学的高质量应用。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

12144

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6941

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2215

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4428

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5134

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4031

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5837

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4582

2023.11.13

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 221人学习

Composer手册
Composer手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn