Download the PHP package geekwright/assetic-fork without Composer
On this page you can find all versions of the php package geekwright/assetic-fork. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download geekwright/assetic-fork
More information about geekwright/assetic-fork
Files in geekwright/assetic-fork
Package assetic-fork
Short Description Asset Management for PHP
License MIT
Homepage https://github.com/geekwright/assetic
Informations about the package assetic-fork
Assetic
This is a fork of Assetic
Assetic is a wonderful product, but sadly, it is lagging behind the PHP ecosystem. This fork is intended for use in PHP >7.1, depends on symfony/process 4, and passes tests in travis-ci.org
My sincere hope is that Assetic will be reborn and make this fork unnecessary. Until then I use:
composer require "geekwright/assetic-fork:2.*"
Assetic (original README)
Assetic is an asset management framework for PHP.
Assets
An Assetic asset is something with filterable content that can be loaded and dumped. An asset also includes metadata, some of which can be manipulated and some of which is immutable.
Property | Accessor | Mutator |
---|---|---|
content | getContent | setContent |
mtime | getLastModified | n/a |
source root | getSourceRoot | n/a |
source path | getSourcePath | n/a |
target path | getTargetPath | setTargetPath |
The "target path" property denotes where an asset (or an collection of assets) should be dumped.
Filters
Filters can be applied to manipulate assets.
The filters applied to the collection will cascade to each asset leaf if you iterate over it.
The core provides the following filters in the Assetic\Filter
namespace:
AutoprefixerFilter
: Parse and update vendor-specific properties using autoprefixerCoffeeScriptFilter
: compiles CoffeeScript into JavascriptCompassFilter
: Compass CSS authoring frameworkCssEmbedFilter
: embeds image data in your stylesheetsCssImportFilter
: inlines imported stylesheetsCssMinFilter
: minifies CSSCleanCssFilter
: minifies CSSCssRewriteFilter
: fixes relative URLs in CSS assets when moving to a new URLDartFilter
: compiles Javascript using dart2jsEmberPrecompileFilter
: precompiles Handlebars templates into Javascript for use in the Ember.js frameworkGoogleClosure\CompilerApiFilter
: compiles Javascript using the Google Closure Compiler APIGoogleClosure\CompilerJarFilter
: compiles Javascript using the Google Closure Compiler JARGssFilter
: compliles CSS using the Google Closure Stylesheets CompilerHandlebarsFilter
: compiles Handlebars templates into JavascriptJpegoptimFilter
: optimize your JPEGsJpegtranFilter
: optimize your JPEGsJSMinFilter
: minifies JavascriptJSMinPlusFilter
: minifies JavascriptJSqueezeFilter
: compresses JavascriptLessFilter
: parses LESS into CSS (using less.js with node.js)LessphpFilter
: parses LESS into CSS (using lessphp)OptiPngFilter
: optimize your PNGsPackagerFilter
: parses Javascript for packager tagsPackerFilter
: compresses Javascript using Dean Edwards's PackerPhpCssEmbedFilter
: embeds image data in your stylesheetPngoutFilter
: optimize your PNGsReactJsxFilter
: compiles React JSX into JavaScriptSass\SassFilter
: parses SASS into CSSSass\ScssFilter
: parses SCSS into CSSSassphpFilter
: parses Sass into CSS using the sassphp bindings for LibsassScssphpFilter
: parses SCSS using scssphpSeparatorFilter
: inserts a separator between assets to prevent merge failuresSprocketsFilter
: Sprockets Javascript dependency managementStylusFilter
: parses STYL into CSSTypeScriptFilter
: parses TypeScript into JavascriptUglifyCssFilter
: minifies CSSUglifyJs2Filter
: minifies JavascriptUglifyJsFilter
: minifies JavascriptYui\CssCompressorFilter
: compresses CSS using the YUI compressorYui\JsCompressorFilter
: compresses Javascript using the YUI compressor
Asset Manager
An asset manager is provided for organizing assets.
The asset manager can also be used to reference assets to avoid duplication.
Filter Manager
A filter manager is also provided for organizing filters.
Asset Factory
If you'd rather not create all these objects by hand, you can use the asset factory, which will do most of the work for you.
The AssetFactory
is constructed with a root directory which is used as the base directory for relative asset paths.
Prefixing a filter name with a question mark, as yui_css
is here, will cause
that filter to be omitted when the factory is in debug mode.
You can also register Workers on the factory and all assets created
by it will be passed to the worker's process()
method before being returned. See Cache Busting below for an example.
Dumping Assets to static files
You can dump all the assets an AssetManager holds to files in a directory. This will probably be below your webserver's document root so the files can be served statically.
This will make use of the assets' target path.
Cache Busting
If you serve your assets from static files as just described, you can use the CacheBustingWorker to rewrite the target paths for assets. It will insert an identifier before the filename extension that is unique for a particular version of the asset.
This identifier is based on the modification time of the asset and will also take depended-on assets into consideration if the applied filters support it.
Internal caching
A simple caching mechanism is provided to avoid unnecessary work.
Twig
To use the Assetic Twig extension you must register it to your Twig environment:
Once in place, the extension exposes a stylesheets and a javascripts tag with a syntax similar to what the asset factory uses:
This example will render one link
element on the page that includes a URL
where the filtered asset can be found.
When the extension is in debug mode, this same tag will render multiple link
elements, one for each asset referenced by the css/src/*.sass
glob. The
specified filters will still be applied, unless they are marked as optional
using the ?
prefix.
This behavior can also be triggered by setting a debug
attribute on the tag:
These assets need to be written to the web directory so these URLs don't return 404 errors.
Assetic is based on the Python webassets library (available on GitHub).