Laravel Elixir ialah API yang menyepadukan Gulp dan menyediakan penyelesaian mudah untuk menyusun Less, Sass, CoffeeScript dan mengendalikan banyak tugas harian lain dalam projek Laravel, dengan itu mengurangkan kerumitan menulis masa tugas yang membosankan di atas, meningkatkan dengan berkesan kecekapan pengaturcaraan.
Persekitaran pengendalian tutorial ini: sistem Windows 7, Laravel versi 8.5, komputer Dell G3.
Laravel bertujuan untuk menjadikan pembangunan PHP mudah dan menyeronokkan, jadi bermula dari Laravel 5, API baharu yang dipanggil LaravelElixir disediakan. API ini menyepadukan Gulp, menyediakan penyelesaian mudah untuk menyusun projek Less, Sass, CoffeeScript dalam Laravel dan mengendalikan banyak tugas harian lain, dengan itu mengurangkan masa menulis tugasan yang membosankan di atas dan meningkatkan kecekapan pengaturcaraan dengan berkesan.
Laravel Elixir menyediakan API yang ringkas dan lancar yang membolehkan anda mentakrifkan tugasan asas Gulp dalam aplikasi Laravel anda. Elixir menyokong banyak prapemproses CSS dan JavaScript biasa dan juga termasuk alat ujian. Menggunakan panggilan berantai, Elixir membolehkan anda mentakrifkan proses pembangunan dengan lancar, contohnya:
elixir(function(mix) { mix.sass('app.scss') .coffee('app.coffee'); });
Jika anda pernah keliru tentang memulakan Gulp dan menyusun fail sumber, anda akan sukakannya. Laravel Elixir, tetapi Laravel tidak memaksa anda untuk menggunakan Elixir Anda bebas menggunakan alat proses pembangunan automatik kegemaran anda.
Sebelum anda mula menggunakan Elixir, anda mesti memastikan mesin anda Telah memasang Node.js.
node -v
Secara lalai, Laravel Homestead akan menyertakan semua yang anda perlukan, namun jika anda tidak menggunakan Vagrant, anda boleh menyemak imbas ke halaman muat turun Nod (http://nodejs.org/download/) untuk dipasang. [Cadangan berkaitan: tutorial video laravel]
Seterusnya, anda perlu memasang Gulp secara global (http : //gulpjs.com) Pakej sambungan NPM:
npm install --global gulp
Langkah akhir Hanya pasang Elixir! Dalam setiap kod Laravel yang baru dipasang, anda akan menemui fail bernama package.json
dalam direktori root. Fikirkan ia seperti fail composer.json
anda, kecuali ia mentakrifkan pakej sambungan bergantung Node dan bukannya PHP. Anda boleh menggunakan arahan berikut untuk memasang pakej sambungan bergantung:
npm install
Jika anda sedang membangun pada sistem Windows atau menjalankan VM pada sistem hos Windows, anda perlu menjalankan npm install
Hidupkan --no-bin-links
apabila menjalankan arahan:
npm install --no-bin-links
Elixir is dicipta dalam Gulp di atas, jadi untuk menjalankan tugas Elixir anda, jalankan sahaja perintah gulp
pada baris arahan. Menambahkan bendera --production
pada arahan akan memberitahu Elixir untuk memampatkan fail CSS dan JavaScript anda:
// 运行所有任务... gulp // 运行所有任务并压缩所有 CSS 及 JavaScript... gulp --production
kerana Menyusahkan untuk menjalankan perintah gulp
pada baris arahan setiap kali anda mengubah suai fail sumber anda, jadi anda boleh menggunakan perintah gulp watch
. Perintah ini akan dijalankan dari baris arahan anda dan memantau fail sumber untuk sebarang pengubahsuaian. Apabila pengubahsuaian berlaku, fail baharu akan disusun secara automatik:
gulp watch
gulpfile.js
direktori akar projek Mengandungi semua tugas Elixir anda. Tugas eliksir boleh dirantai bersama untuk menentukan cara fail sumber anda harus disusun.
Untuk menyusun Kurang kepada CSS, anda boleh menggunakan kaedah less
. Kaedah less
akan menganggap bahawa fail Kurang anda disimpan dalam folder resources/assets/less
. Secara lalai, tugas contoh ini akan meletakkan CSS yang disusun dalam public/css/app.css
:
elixir(function(mix) { mix.less('app.less'); });
Anda mungkin mahu menggabungkan berbilang fail Kurang ke dalam satu fail CSS. Begitu juga, CSS yang dijana akan diletakkan dalam public/css/app.css
:
elixir(function(mix) { mix.less([ 'app.less', 'controllers.less' ]); });
Jika anda ingin menyesuaikan lokasi output CSS yang disusun, anda boleh menghantar parameter kedua kepada less
Kaedah:
elixir(function(mix) { mix.less('app.less', 'public/stylesheets'); }); // 指定输出的文件名称... elixir(function(mix) { mix.less('app.less', 'public/stylesheets/style.css'); });
sass
方法让你能编译 Sass 至 CSS。Sass 文件的默认读取路径是 resources/assets/sass
,你可以使用此方法:
elixir(function(mix) { mix.sass('app.scss'); });
同样的,如同 less
方法,你可以编译多个 Sass 文件至单个的 CSS 文件,甚至可以自定义生成的 CSS 的输出目录:
elixir(function(mix) { mix.sass([ 'app.scss', 'controllers.scss' ], 'public/assets/css'); });
如果你只是想将一些纯 CSS 样式合并成单个的文件,你可以使用 styles
方法。此方法的默认路径为 resources/assets/css
目录,而生成的 CSS 会被放置于 public/css/all.css
:
elixir(function(mix) { mix.styles([ 'normalize.css', 'main.css' ]); });
当然,你也可以通过传递第二个参数至 styles
方法,将生成的文件输出至指定的位置:
elixir(function(mix) { mix.styles([ 'normalize.css', 'main.css' ], 'public/assets/css'); });
Source maps 在默认情况下是开启的。因此,针对每个被编译的文件,同目录内都会伴随着一个 *.css.map
文件。这个文件能够让你在浏览器调试时,可以追踪编译后的样式选择器至原始的 Sass 或 Less 位置。
如果你不想为你的 CSS 生成 source maps,你可以使用一个简单的配置选项关闭它们:
elixir.config.sourcemaps = false; elixir(function(mix) { mix.sass('app.scss'); });
Elixir 也提供了一些函数来帮助你使用 JavaScript 文件,像是编译 ECMAScript 6、编译 CoffeeScript、Browserify、压缩、及简单的串联纯 JavaScript 文件。
coffee
方法可以用于编译 CoffeeScript 至纯 JavaScript。coffee
函数接收一个相对于 resources/assets/coffee
目录的 CoffeeScript 文件名字符串或数组,接着在 public/js
目录生成单个的 app.js
文件:
elixir(function(mix) { mix.coffee(['app.coffee', 'controllers.coffee']); });
Elixir 还附带了一个 browserify
方法,给予你在浏览器引入模块及 ECMAScript 6 的有用的特性。
此任务假设你的脚本都保存在 resources/assets/js
,并会将生成的文件放置于 public/js/main.js
:
elixir(function(mix) { mix.browserify('main.js'); });
虽然 Browserify 附带了 Partialify 及 Babelify 转换器,但是只要你愿意,你可以随意安装并增加更多的转换器:
npm install aliasify --save-dev
elixir.config.js.browserify.transformers.push({ name: 'aliasify', options: {} }); elixir(function(mix) { mix.browserify('main.js'); });
babel
方法可被用于编译 ECMAScript 6 与 7 至纯 JavaScript。此函数接收一个相对于 resources/assets/js
目录的文件数组,接着在 public/js
目录生成单个的 all.js
文件:
elixir(function(mix) { mix.babel([ 'order.js', 'product.js' ]); });
若要选择不同的输出位置,只需简单的指定你希望的路径作为第二个参数。该方法除了 Babel 的编译外,特色与功能同等于 mix.scripts()
。
如果你想将多个 JavaScript 文件合并至单个文件,你可以使用 scripts
方法。
scripts
方法假设所有的路径都相对于 resources/assets/js
目录,且默认会将生成的 JavaScript 放置于 public/js/all.js
:
elixir(function(mix) { mix.scripts([ 'jquery.js', 'app.js' ]); });
如果你想多个脚本的集合合并成不同文件,你可以使用调用多个 scripts
方法。给予该方法的第二个参数会为每个串联决定生成的文件名称:
elixir(function(mix) { mix.scripts(['app.js', 'controllers.js'], 'public/js/app.js') .scripts(['forum.js', 'threads.js'], 'public/js/forum.js'); });
如果你想合并指定目录中的所有脚本,你可以使用 scriptsIn
方法。生成的 JavaScript 会被放置在 public/js/all.js
:
elixir(function(mix) { mix.scriptsIn('public/js/some/directory'); });
copy
方法可以复制文件与目录至新位置。所有操作路径都相对于项目的根目录:
elixir(function(mix) { mix.copy('vendor/foo/bar.css', 'public/css/bar.css'); }); elixir(function(mix) { mix.copy('vendor/package/views', 'resources/views'); });
许多的开发者会在它们编译后的资源文件中加上时间戳或是唯一的 token,强迫浏览器加载全新的资源文件以取代提供的旧版本代码副本。你可以使用 version
方法让 Elixir 处理它们。
version
方法接收一个相对于 public
目录的文件名称,接着为你的文件名称加上唯一的哈希值,以防止文件被缓存。举例来说,生成出来的文件名称可能像这样:all-16d570a7.css
:
elixir(function(mix) { mix.version('css/all.css'); });
在为文件生成版本之后,你可以在你的 视图 中使用 Laravel 的全局 elixir
PHP 辅助函数来正确加载名称被哈希后的文件。elixir
函数会自动判断被哈希的文件名称:
<link rel="stylesheet" href="{{ elixir('css/all.css') }}">
你可以传递一个数组至 version
方法来为多个文件生成版本:
elixir(function(mix) { mix.version(['css/all.css', 'js/app.js']); });
一旦该文件被加上版本,你需要使用 elixir
辅助函数来生成哈希文件的正确链接。切记,你只需要传递未哈希文件的名称至 elixir
辅助函数。此函数会自动使用未哈希的名称来判断该文件为目前的哈希版本:
<link rel="stylesheet" href="{{ elixir('css/all.css') }}">
当你对前端资源进行修改后,BrowserSync 会自动刷新你的网页浏览器。你可以使用 browserSync
方法来告知 Elixir,当你运行 gulp watch
命令时启动 BrowserSync 服务器:
elixir(function(mix) { mix.browserSync(); });
一旦你运行 gulp watch
,就能使用连接端口 3000 启用浏览器同步并访问你的网页应用程序:http://homestead.app:3000
。如果你在本机开发所使用的域名不是 homestead.app
,那么你可以传递一个 选项 的数组作为 browserSync
方法的第一个参数:
elixir(function(mix) { mix.browserSync({ proxy: 'project.app' }); });
如果你需要在 Elixir 调用一个既有的 Gulp 任务,你可以使用 task
方法。举个例子,假设你有一个 Gulp 任务,当你调用时会输出一些简单的文本:
gulp.task('speak', function() { var message = 'Tea...Earl Grey...Hot'; gulp.src('').pipe(shell('say ' + message)); });
如果你希望在 Elixir 中调用这个任务,使用 mix.task
方法并传递该任务的名称作为该方法唯一的参数:
elixir(function(mix) { mix.task('speak'); });
如果你想注册一个监控器让你的自定义任务能在每次文件改变时就运行,只需传递一个正则表达式作为 task
方法的第二个参数:
elixir(function(mix) { mix.task('speak', 'app/**/*.php'); });
如果你需要比 Elixir 的 task
方法更灵活的方案,你可以创建自定义的 Elixir 扩展功能。Elixir 扩展功能允许你传递参数至你的自定义任务。举例来说,你可以编写一个扩展功能,像是:
// 文件:elixir-extensions.js var gulp = require('gulp'); var shell = require('gulp-shell'); var Elixir = require('laravel-elixir'); var Task = Elixir.Task; Elixir.extend('speak', function(message) { new Task('speak', function() { return gulp.src('').pipe(shell('say ' + message)); }); }); // mix.speak('Hello World');
就是这样!注意,你的 Gulp 具体的逻辑必须被放置在 Task
第二个参数传递的构造器函数里面。你可以将此扩展功能放置在 Gulpfile 的上方,取而代之也可以导出至一个自定义任务的文件。举个例子,如果你将你的扩展功能放置在 elixir-extensions.js
文件中,那么你可以在 Gulpfile
中像这样引入该文件:
// 文件:Gulpfile.js var elixir = require('laravel-elixir'); require('./elixir-extensions') elixir(function(mix) { mix.speak('Tea, Earl Grey, Hot'); });
如果你想在运行 gulp watch
时能够重新触发你的自定义任务,你可以注册一个监控器:
new Task('speak', function() { return gulp.src('').pipe(shell('say ' + message)); }) .watch('./app/**');
相关推荐:最新的五个Laravel视频教程
Atas ialah kandungan terperinci apakah elixir laravel. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!