所属分类:php教程
本文给大家分享以下 Laravel 9.x 下的前端工作流的使用心得,之前用 Laravel Mix,现在咱们这次就用用官方推荐的 vite 工具,同时继续使用 bootstrap 5,这样的话既能方便课程学者即能掌握最新的前端工作流,又能低门槛的调整自己喜欢的样式。最重要的是不影响教程的学习进度和节奏。【推荐:laravel视频教程】
写在前面
开发环境:
大环境上是 Windows 10/11 + Homestead,均为最新稳定版本
两个平台都安装 Node.js
Laravel 版本为 9.x(发文时我用的是最新的 9.38.0) ,其他未提及的按照 9.x 版本的教程来
不使用 Laravel Mix,使用官方推荐的新前端打包工具 vite 完成教程里关于样式的修改任务。
我的目的:在 Windows 和 homestead 两个平台使用 Node.js 来规避安装 Bootstrap 中能踩到的坑,让苦逼的 Win 用户学习《L01 Laravel 教程 - Web 开发实战入门》的《4.2. 样式美化》章节做到 优雅且轻松。
不多废话,线上操作
操作方法
首先默认读者已经学习到《4.2. 样式美化》章节,并且很不幸的被卡住,其次,自己的 Windows 电脑和 Homestread 环境都可以运行 Node.js。Windows 下没有装 Node.js 的可通过搜索引擎搜索下载,傻瓜式的安装流程,不再赘述。
首先我们根据教程做到下方这一步,但先别执行
composer require laravel/ui:3.4.5 --dev
登录后复制
我们改改,这里直接获取默认的最新 laravel/ui 版本,并在 linux 内执行
composer require laravel/ui // 发文时最新的版本是 4.0.1,对不住了版主,我自己偷摸的上到最新的版本惹
php artisan ui bootstrap
登录后复制
然后我们到 windows 环境下开一个终端,比如 powershell,并执行
npm config set registry=https://registry.npm.taobao.org
npm i
登录后复制
然后回到你的编辑器,找到项目根目录下刚生成的 vite.coffig.js 我们修改成如下的效果
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import path from 'path'
export default defineConfig({
plugins: [
laravel([
'resources/js/app.js',
]),
],
resolve: {
alias: {
'~bootstrap': path.resolve(__dirname, 'node_modules/bootstrap'),
}
},
});
登录后复制
然后在 app.js 中导入 boostrap 5 的 scss
import './bootstrap';
// 以下为新增部分
import '../sass/app.scss'
import * as bootstrap from 'bootstrap'
登录后复制
之后再去项目的 blade 模板中,更换原本的 mix () 代码。这里的话要是根据教程来,我们只改那个 default.blade.php 文件即可,即将其中的这两行代码
<link rel="stylesheet" href="{{ mix('css/app.css') }}">
<script src="{{ mix('js/app.js') }}"></script>
登录后复制
全部换成 @vite 代码
@vite(['resources/js/app.js'])
登录后复制
下面是我在 default.blade.php 放的位置
<!DOCTYPE html>
<html>
<head>
<title>@yield('title', 'Weibo App') - Laravel 入门教程</title>
@vite(['resources/js/app.js']) <--- here!
</head>
<body>
<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
<div class="container">
<a class="navbar-brand" href="/">Weibo App</a>
<ul class="navbar-nav justify-content-end">
<li class="nav-item"><a class="nav-link" href="/help">帮助</a></li>
<li class="nav-item"><a class="nav-link" href="#">登录</a></li>
</ul>
</div>
</nav>
<div class="container">
@yield('content')
</div>
</body>
</html>
登录后复制
之后我们后期学习中,但凡牵扯到 Mix 的一律按照这个思路处理。
最后,在 windows 终端输入如下指令
npm run build
// 或者
npm run dev
登录后复制
操作结束,刷新以下浏览器就可看到效果。
至于 dev 和 build 的区分就是:
dev 适合开发的时候随时调整,你的修改是实时生效且自动的,建议开发的时候一直开个窗口挂后台就行
build 会一步处理完毕并输出 css 和 js 文件,只会执行一次不会自动,适合最后发布阶段。
速度方面,相比较 laravel Mix 前端工作流,vite 会以闪电般的速度给你稳健的处理好,放心,vite 的处理速度实在是太快惹。
项目部署
当我们的代码上传到远端 git 仓库后,再拉到生产环境时,vite 使用 npm run build 生成的 css 和 js 文件是不会纳入 git 管理的,也就是你在本地 git add -A 是包括不了他俩的,我们需要在本地开发项目的根目录找到.gitignore 文件,注释或者删除 /public/build 这一行,具体如下
/node_modules
# /public/build <-- here
/public/hot
/public/storage
/storage/*.key
/vendor
.env
.env.backup
.phpunit.result.cache
Homestead.json
Homestead.yaml
auth.json
npm-debug.log
yarn-error.log
/.idea
/.vscode
登录后复制
之后我们 build 的文件就可以被 git add -A 检测到。
当然,你也完全可以在线上编译样式,这个思路你懂就行,举一反三嘛。
其他小贴士
bootstrap 5 已经删除原本 4 版本的 Jumbotron 组件,所以你看不到对应的样式,正常现象。想改的请发挥自己的想象,去自己写一个。
关于 4.4. 浏览器缓存问题 章节,若你使用 vite 的前端工作流,build 完毕后,会自动给样式文件加上后缀,所以这一章节可以不看,使用 vite 的工作模式是不存在这个问题的,跳过继续学习。
是否发现本文有些地方你可以提出你自己的方法,这样最好,我的回答不是最完美的,大家学习过程中能提出自己独立思考的疑问或者解决方案,才是最棒的结果,欢迎大家探索适合自己的解决方案。
最后碎碎念
然后相比较版主教程里让我们用特定版本学习 laravel 的方法,但我还是喜欢遵循官方的文档说明,尽量用原生方法实现相关效果,且方方面面的都是用最新版本,也算是版主推荐规范化思路下的一个 “叛逆邪道” 吧,自己也需要解决时不时遇到的新版本兼容问题。总之希望这篇文章可以为初学者提供一个新思路,毕竟我们是学习阶段,而非生产环境开发,多学一点是一点。
相比我之前 8.x 的经验分享,这个属于新技术的学习与适配,第一次遇到新版本内容我也栽了。自行学习,寻找方案,然后解决问题,学会思路比学会方法更重要,相信后期的 10.x 、100.x 版本也会有更多新内容、新变动,大家一定要掌握解决问题的思路,死板学方法是行不通的,希望各位学习路上的初学者们不要放弃这一优美的框架,要不太可惜了!
以上就是详解如何在Laravel9.x中快速安装Bootstrap的详细内容,更多请关注zzsucai.com其它相关文章!