siteparts/asset

Generate cache busted web assets URLs

v1.0.0 2023-11-08 11:26 UTC

Requires

• php: ^7.1 || ^8.0

Requires (Dev)

• phpstan/phpstan: ^1.10

Suggests

• psr/container: ^1.0 || ^2.0 to use the factory

BSD-3-Clause

• asset
• url
• helper

README

Generate cache busted web assets URLs.

Installation

Via Composer:

$ composer require siteparts/asset

Usage

The following example assumes that your application is located at example.org/app and you have all your assets in directory public in your project root directory:

project-root
|- public
   |- css
      |- style.css
   |- img
      |- image.png
   |- index.php
|- src
|- templates
...

Create the AssetHelper and start generating cache busted assets URLs:

use SiteParts\Asset\AssetHelper;

$localPath = "public";
$basePath = "/app";

$assetHelper = new AssetHelper(
	$localPath,
	$basePath
);

$styleUrl = $assetHelper("css/style.css");
// $styleUrl contains e.g. "/app/css/style.css?v=1591103864"

$imageUrl = $assetHelper("img/image.png");
// $imageUrl contains e.g. "/app/img/image.png?v=1591057923"

For use with a PSR-11 container, you can also use the ConfigProvider supplied.