环境准备与模板引擎说明
Laravel 自带 Blade 模板引擎,无需额外安装模板包。开始前请确认:
- PHP >= 8.1,Composer 已全局安装
- 已通过
composer create-project laravel/laravel blog创建项目 - 项目根目录可执行
php artisan serve
Blade 文件存放在 resources/views 目录,文件后缀为 .blade.php。只要该目录存在,模板系统即可工作。
创建第一个 Blade 模板
新建视图文件
在 resources/views 下创建 welcome.blade.php:
{{ $title }}
当前时间:{{ now() }}
编写路由返回视图
打开 routes/web.php,添加:
Route::get(‘/’, function () {
return view(‘welcome’, [‘title’ => ‘Laravel 模板已生效’]);
});
执行 php artisan serve,浏览器访问 http://127.0.0.1:8000 即可看到渲染结果。
模板继承与布局复用
定义主布局
新建 resources/views/layouts/app.blade.php:
@include(‘partials.header’)
子模板继承
新建 resources/views/home.blade.php:
@extends(‘layouts.app’)
@section(‘title’, ‘首页’)
@section(‘content’)
这是首页内容。
@endsection
路由改为 return view('home'); 即可。@extends 指定布局,@section 填充区块,@include 引入公共片段。
数据传递与常用指令
在控制器中传递数据:
return view(‘home’, [‘users’ => $users]);
模板内循环输出:
@foreach ($users as $user)
@endforeach
注意:{{ }} 会自动转义 HTML,输出原始 HTML 用 {!! !!}。判断登录状态可用 @auth / @guest。
编译缓存与常见问题
Blade 模板首次访问时编译到 storage/framework/views。修改模板后一般自动重新编译;若未生效,执行:
php artisan view:clear
常见报错“View [xxx] not found”通常是文件名或路径大小写不一致,Linux 环境区分大小写。确保 resources/views 目录权限可写,否则编译失败。
按以上步骤操作,Laravel 模板安装与基础配置即可完成。

