build.php
is a very simple command line build script designed to take groups of CSS or JS files and combine them into a built file.
- Combines files
- Works on the command line
- PHP!
build.php
does not:
- ...Try to do smart URL rewriting by itself. You can, however, specify a list of string replacements for each bundle.
- ...Do any kind of path error checking -- it's up to you to make sure things make sense.
- ...Strip whitespace characters.
- ...Strip comments.
- ...Make you coffee.
Each site's configuration will likely be a little different. I've found it useful to structure assets like this:
assets/
config.php
load.php
asset-build/ # This repo
config-example.php # Includes Builder.php. Defines the bundles.
load-example.php # Includes config.php. Handles enqueueing assets/bundles into WordPress.
build.php # Includes config.php. The command-line build script.
lib/
Bundler.php # This class keeps track of all the assets, bundles, and has a method to write files.
Bundler_Loader.php
Setting up bundles is easy using the define_bundle()
and add_to_bundle()
methods. For example:
$bundler = new Bundler('/asset/path/prefix/');
$bundler->define('bundle_name', 'path/to/built/file.css');
$bundler->add_to('bundle_name', 'common/css/base.css');
$bundler->add_to('bundle_name', 'common/css/main.css', array('../img/', '../../../common/img/'));
At the very end, register your instance of Bundler to be built by the build script like so:
$bundler->add_to_build_profiles();
To write the files, In the command line,
$ cd /path/to/build.php
then...
$ php build.php
By default, build.php will look for your config file at ../config.php
. You can specify a path to your config file like this, though:
$ php build.php --config=../path/to/config.php
That's it! Assuming PHP has write access, new files will be created for each bundle in the same directory as your old development files. Your development files will not be touched.