Download the PHP package hnhdigital-os/laravel-php-elixir without Composer

Provides a replacement of the Node.js based elixir pre-packaged with Laravel Framework. Tasks are sequentially run in the order that they are declared in the configuration file. You can specify more than one task module block.

This package has been developed by H&H|Digital, an Australian botique developer. Visit us at hnh.digital.

Pre-install requirement

This package requires ext-inotify which can be installed by:

$ pecl install inotify

You will likely need to enable this extension. You can use the following (may not match your specific OS settings).

$ echo "extension=inotify.so" | sudo tee /etc/php/7.1/mods-available/inotify.ini && sudo ln -s /etc/php/7.1/mods-available/inotify.ini /etc/php/7.1/cli/conf.d/20-inotify.ini

Install

Via composer:

$ composer require-dev bluora/laravel-php-elixir ~2.0

Enable the service provider by editing config/app.php:

Usage

Run the command with the default config file (.elixir.yml).

$ php artisan elixir

Run the command with a custom config file:

$ php artisan elixir --config=***

Run the folder watcher to automatically run elixir on file changes with the default config file (.elixir.yml).

$ php artisan elixir:watch

Run the folder watcher to automatically run elixir on file changes using a custom config file:

$ php artisan elixir:watch --config=***

Configuration

Configuration for this package is done in the '.elixir.yml' located in your base directory or in the 'vendor/bluora/laravel-php-elixir/src/.elixir.yml.example'.

First declare the task name and the class name in the configuration file (these modules are installed by default).

List tasks using the first level in the YAML file or, if you need to declare more than one task module in different location of the config file, simply prepend the task with a number (unique to the task) and a hash. For example:

If you are testing php-elixir, you can stop tasks from running by prepending them with an exclaimation mark (!).

Options

• dry-run - runs the script but doesn't actually do anything.
• verbose - provides further feedback of what is happening.

Paths

Paths lets you declare path constants that can be used in your other tasks.

Watch

Watch configuruation item is only used by the elixir:watch console command.

Empty

Deletes all files and folders in the listed paths.

Exec

Executes a given file and arguments.

SASS

Processes and compiles a *.scss file and outputs it to specified path.

Formatted as: {SOURCE_FILE_PATH}: {DESTINATION_FILE_PATH}

Combine

Gets the contents of one or many files and combines it into the specified file.

Source folders can be specified with single level or multi-level lookup, and the ability to filter files by extension.

Copy

Copies files from a file path or a folder path to a specified folder or file name.

Folder paths can be configured to get the top level directory using '/*' or for all files and folders in path by using '/**'.

Further configuration can be added using the standard query string format.

• filter - comma deliminated list of extensions.

Replace

You can replace specific text in files or folder paths.

Revision

Provides revisioning of files in a specified folder location.

Options that are available:

• hash_length - defaults is 8.
• minify - default is false.
• php_manifest - generates a php equivalent of the json revision file.

Contributing

Please see CONTRIBUTING for details.

Credits

• Rocco Howard
• All Contributors

License

The MIT License (MIT). Please see License File for more information.