随着 web 技术的不断发展,前后端分离已经成为了一种趋势。前端框架 vue.js 目前也越来越流行,那么在 thinkphp 中如何使用 vue 呢?本文将介绍使用 thinkphp5.1 框架集成 vue.js 的方法。
一、安装 Node.js
在开始之前,确保你已安装 Node.js 环境,若未安装可前往官网下载并进行安装。
二、创建新项目
使用 Composer 命令,在终端输入以下命令:
立即学习“PHP免费学习笔记(深入)”;
composer create-project topthink/think=5.1.* myapp
运行以上命令后,会在当前路径下生成一个 myapp 文件夹。接着运行以下进入目录并安装 ThinkPHP 依赖:
cd myapp composer install
三、安装前端依赖
在确认已进入 myapp 目录后,在命令行工具中输入以下指令,安装所需前端依赖:
npm install
安装完成后,可在 myapp 目录下的 node_modules 文件夹中,看到已成功安装的依赖包。
四、配置 webpack.mix.js
webpack.mix.js 文件用于引入自定义的编译器和前端依赖包之间的联系。通过 webpack.mix.js 文件,能够定制如何构建和打包前端代码。
在 myapp 项目文件夹下,创建一个新文件 webpack.mix.js,添加以下代码:
let mix = require('laravel-mix'); mix.js('resources/js/app.js', 'public/js') .sass('resources/sass/app.scss', 'public/css');
以上代码的作用是:
- 引入 Laravel Mix 工具
- 指定入口文件 resources/js/app.js 和资源编译输出路径 public/js
- 指定 Sass 入口文件路径 resources/sass/app.scss 和编译输出路径 public/css
顺便说一句,Laravel Mix 是一个将 Webpack 与其他构建工具结合的工具,用于统一前端工作流程。
五、创建 Vue.js 组件
在开始编写 Vue.js 组件之前,首先需要新建一个 resources/views 目录,并在其下新建一个文件夹 index,在 index 文件夹中新建一个名为 vue.blade.php 的文件。这个文件将会是 Vue.js 组件的渲染模板,代码如下:
<title>Vue component - ThinkPHP</title><meta name="csrf-token" content="{{ csrf_token() }}"><link rel="stylesheet" href="%7B%7B%20mix('css/app.css')%20%7D%7D"><div id="app"> <example-component></example-component> </div> <script src="%7B%7B%20mix('js/app.js')%20%7D%7D"></script>
以上代码中:
- 用于跨域攻击防御;
- 引入样式;
-
作为 Vue.js 组件的容器;
即为 Vue.js 组件。 接下来在 resources/js/ 目录下新建一个文件夹 components,并在其中新建 ExampleComponent.vue 文件。这个文件是一个 Vue 单文件组件,将会被渲染到 vue.blade.php 文件。代码如下:
<template><div class="container"> <h1 class="title">Vue component - ThinkPHP</h1> <p>Message: {{ message }}</p> </div> </template><script> export default { data () { return { message: 'Hello, Vue!' } } } </script><style> .container { margin: 0 auto; max-width: 640px; } .title { font-size: 32px; color: #333; } </style>
以上代码中:
- 标签用于插入 HTML 模板;
- <script> 标签用于插入 JavaScript 代码,通过 export default 导出 Vue 单文件组件;</script>
六、在 Blade 模板中使用 Vue.js 组件
完成以上步骤后,即可在 blade 模板中使用 Vue.js 组件添加以下代码:
@extends('index.vue') @section('content') <example-component></example-component> @endsection
以上代码中的 @extends(‘index.vue’) 引用了刚才创建的 vue.blade.php 模板, @section(‘content’) 为 Vue.js 组件指定了渲染位置,通过 example-component 指定调用的组件名称。
七、编译前端代码
在执行以下命令进行编译时,会自动生成 public/js/app.js 和 public/css/app.css。通过 public 目录下的 HTML 文件即可看到效果。
npm run dev
八、集成 Vue.js
在将 Laravel Mix 集成到 ThinkPHP 项目中后,下一步就是集成 Vue.js。这里使用了 Laravel Mix 和 Lodash.debounce 依赖,代码如下:
let mix = require('laravel-mix'); let debounce = require('lodash.debounce'); // styles mix.sass('resources/assets/sass/app.scss', 'public/css'); // scripts mix.js('resources/assets/js/app.js', 'public/js') .vue({ version: 2 }) .babel(['public/js/app.js'], 'public/js/app.js') .webpackConfig({ module: { rules: [ { test: /.vue$/, loader: 'vue-loader' } ] } }); // browserSync if (process.env.NODE_ENV !== 'production') { mix.browserSync({ proxy: process.env.APP_URL || 'localhost:8000', notify: false, files: [ 'app/**/*.php', 'resources/views/**/*.php', 'public/**/*.{css,js}' ], snippetOptions: { rule: { match: /