iulyanp/elixir-mix-bundle

A Symfony bundle that integrates Laravel Mix

, _(*1)

ElixirMixBundle

Note! Starting with Symfony 4 you can use the official webpack wrapper from Symfony: Encore. I also wrote a short blog post about how you can Compile your assets with Symfony Encore., _(*2)

ElixirMixBundle is a Symfony bundle that integrates Laravel Mix. The purpose of the bundle is to offer the mix() twig function. This is exactly the same mix() function from Laravel blade template system., _(*3)

Requirements

Before you start installing this bundle you first have to ensure that Node.js and NPM are installed on your machine., _(*4)

Installation

Step 1: Require the bundle with composer

Open your terminal and run one of the following commands to download the bundle into your vendor directory., _(*5)

If you have composer installed globally you can run:, _(*6)

$ composer require iulyanp/elixir-mix-bundle

Else you can go with:, _(*7)

$ php composer.phar require iulyanp/elixir-mix-bundle

Step 2: Register the bundle in your AppKernel class

Register the bundle in the app/AppKernel.php file of your project:, _(*8)

<?php
/** app/AppKernel.php */

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(

            new Iulyanp\ElixirMixBundle\IulyanpElixirMixBundle(),
        );
    }
}

Step 3: Configure the bundle

In order to be able to use the bundle you have to give it some configuration specific to your application., _(*9)

# config/parameters.yml
parameters:
    # ...
    web_dir: "%kernel.root_dir%/../web"

# config/config.yml
iulyanp_elixir_mix:
    web_dir: "%web_dir%"

The web_dir configuration is just the public path where you want the output for your assets to be saved. I used web directory from Symfony., _(*10)

Step 4: Initialize larave-mix package

If you already have installed Node.js, npm you should be all set to run:, _(*11)

$ php bin/console mix:init

A base package.json and webpack.mix.js file will be generated into your project root directory., _(*12)

Then run npm install to install all the dependencies and laravel-mix., _(*13)

Usage

Now you can use mix() function to version a file like this:, _(*14)

<link rel="stylesheet" type="text/css" href="{{ mix('css/app.css') }}" />

You can find more about laravel mix usage on the official documentation, _(*15)

License

The ElixirMixBundle is open-sourced software licensed under the MIT license., _(*16)