easybib / asset-php
Prefixing files with a content MD5, as a composer script.
This package is not auto-updated.
Last update: 2024-10-26 16:26:06 UTC
README
Prefixing files with a content MD5, as a composer script.
Does
- copy any file you want to a
[content-md5]-original-file-name.ext
file - provide that filename to your app
Does Not
- do anything else to your files (no minification, no nothing)
Setup/Usage
$ composer require easybib/asset-php 1.\*
composer
The script exposes two composer "scripts" - EasyBib\\Asset::run
and
EasyBib\\Asset::clear
. You'll also need to add the configuration
to your composer.json
.
For example:
"config": { "asset": { "/js/main.js": {"from": "frontend/src", "to": "frontend/dist"}, "/css/main.css": {"from": "web/css", "to": "web/css"} } }, "scripts": { "build": "EasyBib\\Asset::run" },
The config.asset
syntax is as follows:
"the name you call Asset::path() with" => {from: "source directory", to: "target directory"}
You can choose other script names, of course. Composer also has some magic script names that it triggers automatically.
app
In your app, replace the path to the file with a call to EasyBib\Asset::path
.
For example, with the above configuration, the following
<script src="<?php EasyBib\\Asset::path('/js/main.js'); ?>"></script>
Will expand into
<script src="/js/123abcdwhatever-main.js"></script>
once you ran composer build
.
To make it fall-back to the source file, you can run EasyBib\Asset::clear()
.
But because of how the APC works in PHP, you'll have to run that from within
the app (or at least using the same SAPI).