0

0

Laravel怎么使用Blade模板引擎_Laravel模板继承与Component组件复用【手册】

冰火之心

冰火之心

发布时间:2025-12-30 15:59:42

|

538人浏览过

|

来源于php中文网

原创

Blade 是 Laravel 内置模板引擎,通过 @extends、@section、@yield 实现模板继承;Component 适用于可复用、带逻辑的 UI 单元,支持属性绑定与插槽;修改后需运行 php artisan view:clear 清除缓存。

laravel怎么使用blade模板引擎_laravel模板继承与component组件复用【手册】

Blade 是 Laravel 自带的模板引擎,不是独立库,不需要额外安装;只要用 Laravel 就默认可用。它本质是 PHP 的编译层,所有 .blade.php 文件最终都会被缓存为原生 PHP 脚本,所以性能没问题。

如何定义和使用 Blade 布局(layout)与模板继承

Blade 继承靠 @extends + @section + @yield 三者配合。父模板用 @yield('name') 预留内容槽,子模板用 @section('name')...@endsection 填充,再通过 @extends('layouts.app') 指定继承关系。

常见错误:

  • 子模板里漏写 @extends,导致页面直接输出原始 Blade 语法(如显示 @section 字符串)
  • @yield 名字和 @section 不一致,对应内容不渲染
  • 在子模板中写了非 @section 区块的 HTML 内容(比如直接写 <h1>Hello</h1>),这部分会被忽略——Blade 要求所有内容必须包裹在 @section 里,除非你用 @parent 显式插入父级内容
@extends('layouts.app')

@section('title', '用户列表')

@section('content')
    <h2>用户管理</h2>
    <ul>
        @foreach($users as $user)
            <li>{{ $user->name }}</li>
        @endforeach
    </ul>
@endsection

什么时候该用 Component 而不是普通 Blade 模板

Component 更适合「带逻辑、可传参、多处复用」的 UI 单元,比如一个带状态切换的卡片、带验证提示的表单字段、或一套主题色按钮。它比 @include 更健壮:支持属性绑定、slot 插槽、生命周期方法(如 mount() 在 Livewire 中)、以及自动命名空间解析。

使用前提:

  • 组件类必须放在 app/View/Components/ 下,类名首字母大写,如 Alert
  • 对应视图路径是 resources/views/components/alert.blade.php
  • 注册方式有两种:自动发现(Laravel 8+ 默认开启)或手动在 AppServiceProvider::boot() 中调用 Blade::component()

调用时用 <x-alert type="error" :message="$msg"></x-alert>,注意冒号表示该属性会作为变量传递(即 PHP 表达式),不加冒号就是字符串字面量。

百宝箱
百宝箱

百宝箱是支付宝推出的一站式AI原生应用开发平台,无需任何代码基础,只需三步即可完成AI应用的创建与发布。

下载

Component 中的 slot 和 attributes 怎么配合用

Slot 是组件内部预留的“内容占位”,{{ $slot }} 输出传入的默认内容;@props(['type' => 'info']) 声明组件接收的属性,默认值可选;$attributes 是一个 MergeableAttributeBag 实例,能合并外部传入的 HTML 属性(如 classid)并安全渲染。

典型误用:

  • 在组件视图里直接 echo $attributes(会输出对象字符串),正确写法是 {{ $attributes }}{{ $attributes->merge(['class' => 'alert']) }}
  • 把动态 class 拼接写成 class="alert {{ $type }}",没过滤 $type 可能引入 XSS —— 应该用 $attributes->merge() 并确保参数来自可信源或已校验
  • 多个 slot 场景下忘记用命名 slot:<x-card><header>标题<p>正文</p></header></x-card>,对应组件内用 {{ $header ?? '' }}
@props(['type' => 'info'])

<div {{ $attributes->merge(['class' => "alert alert-{$type}"]) }}>
    {{ $slot }}
</div>

Blade 编译缓存和调试技巧

Blade 文件修改后不会实时生效,因为默认启用缓存。开发时如果改了模板但页面没变,先运行:

php artisan view:clear
。生产环境务必保持缓存开启,否则每次请求都要重新编译,性能断崖下跌。

遇到报错如 Undefined variable: $users,别急着查控制器——Blade 错误堆常指向缓存后的 PHP 文件(路径类似 storage/framework/views/xxx.php)。这时要看原始 .blade.php 行号,并确认 compact()with()view() 第二个参数是否漏传了变量。

进阶技巧:用 @php ... @endphp 快速调试,但仅限开发;正式代码里应避免,逻辑尽量移出模板。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

340

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

293

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

772

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

141

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

489

2026.03.04

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号