Aura.Asset_Bundle

Asset management for PHP., _(*1)

Foreword

Requirements

This package requires PHP 5.3 or later. Unlike Aura library packages, this asset package has userland dependencies:, _(*2)

aura/web

Installation

This asset-bundle is installable and autoloadable via Composer with the following require element in your composer.json file:, _(*3)

"require": {
    "aura/asset-bundle": "2.*"
}

Tests

, _(*4)

composer install
phpunit -c tests/unit

PSR Compliance

This kernel attempts to comply with PSR-1, PSR-2, and PSR-4. If you notice compliance oversights, please send a patch via pull request., _(*5)

Community

To ask questions, provide feedback, or otherwise communicate with the Aura community, please join our Google Group, follow @auraphp on Twitter, or chat with us on #auraphp on Freenode., _(*6)

Structure of Package

Assume you have a Vendor.Package. All your assets should be in the web folder. The folder names css, images, js can be according to your preffered name., _(*7)

├── src
│   ├── Cli
│   └── Web
├── tests
└── web
    ├── css
    │   └── some.css
    ├── images
    │   ├── another.jpg
    │   └── some.png
    └── js
        └── hello.js

Assuming you have the same structure, now in your template you can point to /asset/vendor/package/css/some.css, /asset/vendor/package/js/hello.js, /asset/vendor/package/images/another.jpg., _(*8)

Onething you still need to make sure in the name asset/vendor/package, _(*9)

vendor/package which is the composer package name., _(*10)

Usage in any project

Add path to the router, according to the router you are using so that vendor, package and file name can be extracted from it., _(*11)

An example of usage with Aura.Router and Aura.Dispatcher is given below. The dispacther is used for it need to recursively call the __invoke method. Else action will return responder, then you need to invoke responder to get the response and finally do send the response., _(*12)

 '/path/to/web/where/css/js/etc/',
    'my/package2' => '/path/to/web/where/css/js/etc/of/packag2'
);
$types = array();
$router->add('aura.asset', '/asset/{vendor}/{package}/{file}')
    ->setValues([
        'action' => 'aura.asset',
    ])
    ->addTokens(array(
        'file' => '(.*)'
    ));

$dispatcher->setObject(
    'aura.asset',
    function () use ($map, $types) {
        $action = new \Aura\Asset_Bundle\AssetAction(
            new \Aura\Asset_Bundle\AssetService($map, $types),
            new \Aura\Asset_Bundle\AssetResponder()
        );
        return $action;
    }
);
```

In your layout or view

```php

```

## Usage in Aura.Web_Kernel

```php
params['Aura\Asset_Bundle\AssetService']['map']['cocoframework/example'] = dirname(__DIR__) . '/web';
    }
```

Make sure you have router helper defined for Aura.View.

```php