Laravel Elixir provides a clean, fluent API for defining some basic Gulp tasks for your Laravel application. Elixir supports several common CSS, JavaScript and even testing tools!
Before triggering Elixir, you must first ensure that Node.js is installed on your machine.
node -v
By default, Laravel Homestead includes everything you need; however, if you aren't using Vagrant, then you can easily install Node by visiting nodejs.org, and clicking install. Don't worry, it's quick and easy!
Next, you'll want to pull in Gulp globally, like so:
npm install --global gulp
The only remaining step is to install Elixir! With a new install of Laravel, you'll find a package.json
file in the root. You may
install the dependencies it references by running:
npm install
Now that you've installed Elixir, you'll be compiling, concatenating, and watching in no time!
elixir(function(mix) {
mix.less("app.less");
});
elixir(function(mix) {
mix.sass("app.scss");
});
elixir(function(mix) {
mix.coffee();
});
elixir(function(mix) {
mix.less()
.coffee();
});
elixir(function(mix) {
mix.phpUnit();
});
elixir(function(mix) {
mix.phpSpec();
});
elixir(function(mix) {
mix.styles([
"css/normalize.css",
"css/main.css"
]);
});
This will assume that the public/
folder is the base directory.
elixir(function(mix) {
mix.stylesIn("public/css");
});
elixir(function(mix) {
mix.scripts([
"js/jquery.js",
"js/app.js"
]);
});
elixir(function(mix) {
mix.scriptsIn("resources/assets/scripts");
});
elixir(function(mix) {
mix.scripts(['js/jquery.js', 'js/main.js'])
.scripts(['js/forum.js', 'js/threads.js']);
});
elixir(function(mix) {
mix.version("css/all.css");
});
This will append a unique hash to the filename, allowing for cache-busting. Perhaps something like: all-16d570a7.css
.
Within your views, you may use the elixir()
function to load the appropriately hashed asset. Here's an example:
<link rel="stylesheet" href="{{ elixir("css/all.css") }}">
Behind the scenes, the elixir()
function will determine the name of the hashed file that should be included.
elixir(function(mix) {
mix.copy('vendor/foo/bar.css', 'public/css/bar.css');
});
elixir(function(mix) {
mix.copy('vendor/package/views', 'resources/views');
});
elixir(function(mix) {
mix.less("app.less")
.coffee()
.phpUnit()
.version("css/bootstrap.css");
});
Now that you've told Elixir which tasks to execute, you only need to trigger Gulp from the command line.
gulp
gulp watch
gulp tdd
Note: All tasks will assume a development environment, and will exclude minification. For production, use
gulp --production
.
While Elixir will assume the default Laravel 5 directory structure, it's possible that you'd prefer to put your assets, styles, and scripts within a different location. No problem!
Create a elixir.json
file within the root of your project, and update the necessary paths as needed.
{
"assetsDir": "app/assets/",
"cssOutput": "public/css/",
"jsOutput": "public/js/"
}
assetsDir
: The path to the base directory for Sass, Less, CoffeeScript, etc.cssOutput
: The path to where compiled CSS should be saved.jsOutput
: The path to where compiled JavaScript should be saved.
You can even create your own Gulp tasks, and hook them into Elixir. Imagine that you want to add a fun task that uses the Terminal to verbally notify you with some message. Here's what that might look like:
var elixir = require("laravel-elixir");
var gulp = require("gulp");
var shell = require("gulp-shell");
elixir.extend("message", function(message) {
gulp.task("say", function() {
gulp.src("").pipe(shell("say " + message));
});
return this.queueTask("say");
});
Notice that we extend
Elixir's API by passing the key that we will use within our Gulpfile, as well as a callback function that will create the Gulp task.
If you want your custom task to be monitored, then register a watcher as well.
this.registerWatcher("message", "**/*.php");
This lines designates that when any file that matches the regex, **/*.php
is modified, we want to trigger the message
task.
That's it! You may either place this at the top of your Gulpfile, or instead extract it to a custom tasks file. If you choose the latter approach, simple require it into your Gulpfile, like so:
require("./custom-tasks")
You're done! Now, you can mix it in.
elixir(function(mix) {
mix.message("Tea, Earl Grey, Hot");
});
With this addition, each time you trigger Gulp, Picard will request some tea.
You'll find a number of Elixir extensions at npmjs.org, under the "laravel-elixir-*" namespace.