nanjingboy/assets

Assets Manager for PHP

v0.1.7 2014-11-14 05:26 UTC

This package is not auto-updated.

Last update: 2024-11-05 05:02:56 UTC


README

Assets:

Assets is a assets manager for PHP.

Getting Started:

  • Create composer.json file in root directory of your application:
{
    "require": {
        "php": ">=5.4.0",
        "nanjingboy/assets": "*"
    },
    "config": {
        "bin-dir": "bin/"
    }
}
  • Install it via composer

  • Create directories in root directory of your application:

 $ mkdir tmp/assets -p
 $ mkdir tmp/assetLoader -p
 $ chmod -R a+w tmp

 $ mkdir uglified/assets -p
 $ chmod -R a+w uglified
  • Create configs/$assetEnv/assets.php in root directory of your application($assetEnv is environment value named ASSETS_ENV):
<?php
return array(
    'path' => array(
        'serverRoot' => string,
        'javascripts' => string, // relative to serverRoot path, default is the serverRoot path
        'stylesheets' => string, // relative to serverRoot path, default is the serverRoot path
        'images' => string, // relative to serverRoot path, default is the serverRoot path
        'fonts' => string // relative to serverRoot path, default is the serverRoot path
    ),
    'precompile' => array() // the file's extension must be js or css, and it's relative to root javascripts(stylesheets) path
);
  • Init the config in your bootstrap.php:
<?php
require __DIR__ . '/vendor/autoload.php';
\Assets\Config::init($configFilePath);

Dependencies:

If you don't use coffeeScript, sass or less, you don't have to install coffeeScript, sass or less compiler.

Api:

require & require_dir directives:

Get more details about require & require_dir directives in javascript(css) file from: assetloader

Console Line:

$ bin/assets

assets version 0.1.7

Usage:
  [options] command [arguments]

Options:
  --help           -h Display this help message.
  --quiet          -q Do not output any message.
  --verbose        -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
  --version        -V Display this application version.
  --ansi              Force ANSI output.
  --no-ansi           Disable ANSI output.
  --no-interaction -n Do not ask any interactive question.

Available commands:
  clean        Remove old compiled assets
  cleanup-tmp  Remove unuseful files in tmp/assets directory
  help         Displays help for a command
  list         Lists commands
  precompile   Compile all the assets named in $config["precompile"]

Example:

Get a example from test

License:

MIT