Download the PHP package clubstudioltd/craft-asset-rev without Composer

On this page you can find all versions of the php package clubstudioltd/craft-asset-rev. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of clubstudioltd/craft-asset-rev

Informations about the package craft-asset-rev

CraftCMS Asset Rev / Cache Busting

tests Latest Stable Version Total Downloads Latest Unstable Version License

Looking for Craft 2 Support? Asset Rev for Craft 2

A Twig extension for CraftCMS that helps you cache-bust your assets using configurable strategies.

Why?

In order to speed up the load time of your pages, you can set a far-future expires header on your images, stylesheets and scripts. However, when you update those assets you'll need to update their file names to force the browser to download the updated version.

Using a manifest file is the recommended approach - you can read up on why using query strings isn't ideal here.

Strategies

This plugin allows you to configure multiple cache-busting strategies for your asset filenames. The plugin comes with three strategies out of the box:

Manifest File

css/main.css will be replaced with the corresponding hashed filename as defined within your assets manifest .json file.

If the contents of your manifest file are...

then rev('css/main.css') will expand to css/main.a9961d38.css.

Please note: This plugin does not create manifest files; instead they should be generated during your build process using Gulp Rev, Laravel Mix or another comparable tool.

Query String

Append a query string to your file, based on the time it was last modified. For example: rev('css/main.css') will expand to something like css/main.css?1473534554.

Passthrough

Returns the original filename, without modification. This is useful if all other cache-busting strategies fail.

Strategy Pipeline

Pipelines allow you to attempt multiple cache-busting strategies in sequence. If one strategy fails, the plugin can proceed to try and cache-bust the asset filename using the next strategy in the pipeline.

The default pipeline is manifest|querystring|passthrough and will:

  1. Attempt to use the ManifestFileStrategy. If it can’t, because the manifest file doesn’t exist, it will throw a ContinueException that defers cache-busting to the next strategy in the pipeline…
  2. Attempt to use the QueryStringStrategy. If it can’t, because it can’t find the asset file, it will throw another ContinueException that defers cache-busting to the final default strategy…
  3. Returns the original filename using the closure-based pass-through strategy.

Need to provide your own cache-busting logic? Simply create your own implementation of the Strategy class or define a Closure in the configuration file.

Installation

Install via the Plugin Store within your Craft 3 installation or using Composer: composer require clubstudioltd/craft-asset-rev

Configuration

The plugin comes with a config.php file that defines some sensible defaults.

If you want to set your own values you should create a assetrev.php file in your Craft config directory. The contents of this file will get merged with the plugin defaults, so you only need to specify values for the settings you want to override.

Strategies

strategies is where you define the strategies you'd like to try to rev your asset filename. You can provide the name of a class that implements StrategyContact or a custom closure. The defaults should cater to most requirements.

Pipeline

pipeline allows you to set the order of the configured strategies you'd like to try when revving your asset file names. The default of: manifest|querystring|passthrough should be adequate for most use-cases.

Manifest Path

manifestPath is where Craft should look for your manifest file. Non-absolute paths will be relative to the base path of your Craft installation (whatever CRAFT_BASE_PATH is set to).

Assets Base Path

assetsBasePath is the the base path to your assets. Again, this is relative to your craft base directory, unless you supply an absolute directory path.

Asset Url Prefix

assetUrlPrefix will be prepended to the output of rev().

Note: You can use Yii aliases in your configuration values.

An Example Config File

Usage

Once activated and configured you can use the rev() function in your templates.

Custom Strategies

Need to provide your own cache-busting logic? Create your own Strategy class or simply use a Closure.

Example Strategy Class

Example Closure

Your method will have access to the asset filename and the plugin configuration array.

All versions of craft-asset-rev with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
craftcms/cms Version ^5.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package clubstudioltd/craft-asset-rev contains the following files

Loading the files please wait ....