GlobAsset
class GlobAsset extends AssetCollection
A collection of assets loaded by glob.
Properties
private | $assets | from AssetCollection | |
private | $filters | from AssetCollection | |
private | $sourceRoot | from AssetCollection | |
private | $targetPath | from AssetCollection | |
private | $content | from AssetCollection | |
private | $clones | from AssetCollection | |
private | $vars | from AssetCollection | |
private | $values | from AssetCollection | |
private | $globs | ||
private | $initialized |
Methods
Constructor.
Returns all child assets.
Replaces an existing leaf with a new one.
Loads the asset into memory and applies load filters.
Applies dump filters and returns the asset as a string.
Returns an absolute path or URL to the source asset's root directory.
Returns the highest last-modified value of all assets in the current collection.
Returns an iterator for looping recursively over unique leaves.
Sets the values for the asset's variables.
Initializes the collection based on the glob(s) passed in.
Details
at line 35
__construct(string|array $globs, array $filters = [], string $root = null, array $vars = [])
Constructor.
in
AssetCollection at line 64
__clone()
No description
at line 43
array
all()
Returns all child assets.
in
AssetCollection at line 75
add(AssetInterface $asset)
Adds an asset to the current collection.
in
AssetCollection at line 80
bool
removeLeaf(AssetInterface $needle, bool $graceful = false)
Removes a leaf.
in
AssetCollection at line 102
bool
replaceLeaf(AssetInterface $needle, AssetInterface $replacement, bool $graceful = false)
Replaces an existing leaf with a new one.
in
AssetCollection at line 125
ensureFilter(FilterInterface $filter)
Ensures the current asset includes the supplied filter.
in
AssetCollection at line 130
array
getFilters()
Returns an array of filters currently applied.
in
AssetCollection at line 135
clearFilters()
Clears all filters from the current asset.
at line 52
load(FilterInterface $additionalFilter = null)
Loads the asset into memory and applies load filters.
You may provide an additional filter to apply during load.
at line 61
string
dump(FilterInterface $additionalFilter = null)
Applies dump filters and returns the asset as a string.
You may provide an additional filter to apply during dump.
Dumping an asset should not change its state.
If the current asset has not been loaded yet, it should be automatically loaded at this time.
in
AssetCollection at line 164
string
getContent()
Returns the loaded content of the current asset.
in
AssetCollection at line 169
setContent(string $content)
Sets the content of the current asset.
Filters can use this method to change the content of the asset.
in
AssetCollection at line 174
string|null
getSourceRoot()
Returns an absolute path or URL to the source asset's root directory.
This value should be an absolute path to a directory in the filesystem, an absolute URL with no path, or null.
For example:
- '/path/to/web'
- 'http://example.com'
- null
in
AssetCollection at line 179
string|null
getSourcePath()
Returns the relative path for the source asset.
This value can be combined with the asset's source root (if both are non-null) to get something compatible with file_get_contents().
For example:
- 'js/main.js'
- 'main.js'
- null
in
AssetCollection at line 183
string|null
getSourceDirectory()
Returns the asset's source directory.
The source directory is the directory the asset was located in and can be used to resolve references relative to an asset.
in
AssetCollection at line 187
string|null
getTargetPath()
Returns the URL for the current asset.
in
AssetCollection at line 192
setTargetPath(string $targetPath)
Sets the URL for the current asset.
at line 70
int|null
getLastModified()
Returns the highest last-modified value of all assets in the current collection.
at line 79
getIterator()
Returns an iterator for looping recursively over unique leaves.
in
AssetCollection at line 227
array
getVars()
Returns an array of variable names for this asset.
at line 88
setValues(array $values)
Sets the values for the asset's variables.
in
AssetCollection at line 241
array
getValues()
Returns the current values for this asset.
at line 97
private
initialize()
Initializes the collection based on the glob(s) passed in.