Download the PHP package germania-kg/asset-timestamper without Composer
On this page you can find all versions of the php package germania-kg/asset-timestamper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download germania-kg/asset-timestamper
More information about germania-kg/asset-timestamper
Files in germania-kg/asset-timestamper
Package asset-timestamper
Short Description File modification timestamps for your website assets.
License MIT
FAQ
Example:
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 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.
Informations about the package asset-timestamper
Germania KG · AssetTimestamper
File modification timestamps for your website assets.
This Callable looks for a given asset file (e.g. CSS, JS usually) in a base directory, extracts its modification time and returns a modified asset path that contains that very timestamp.
For remote files, no timestamps will be added. AssetTimestamper will check for host entry in PHP's parse_url's result array.
See Chris Coyier's article “Strategies for Cache-Busting CSS”, chapter “Changing File Name“. Please note — As Chris Coyier points out, this technique may slow down server response. Using this technique for only some files should be fine, be aware to not over-use it.
Installation with Composer
Alternatively, add this package directly to your composer.json:
Upgrade from v1
In v1, a FileException was thrown if a given asset did not exist. As of version 2, the original asset file name will be returned. If you have not seen this FileException until now, you will have to do nothing. All others have to remove FileException catch blocks.
Deprecation warning: The FileException class is still available with this package and will be removed in Release Version 3. Discuss at issue #1.
Usage
You do not need to have a leading directory separator slash, as it will internally be “glued in” if neccessary. However, the result will have (or miss) the slash, depending on how you pass in the asset file name.
Using different base paths
You can define a custom directory where AssetTimestamper should look for the assets. This is useful when your assets are located in a directory accessed via another (sub-)domain. Let's say your project directory looks like this:
Examples for PHP and HTML:
Use AssetTimestamper with another base directory:
HTML Output:
Simple Twig Example
Alternative Twig Integration: Filter
Since AssetTimestamper is invokable and a Callable, it can be easily used as a Twig SimpleFilter:
So rendering a website like this:
…using this Twig template …
… will lead to this output:
.htaccess
Since browsers will request the modified file name (which in fact does not exist, at least with this name), you will have to rewrite the URL in your .htaccess, like so:
See Chris Coyier's article “Strategies for Cache-Busting CSS”, chapter “Changing File Name“, and Stefano's comment on this.
Issues
No issues known so far, feel free to create one at issues page.
Development
Unit tests
Either copy phpunit.xml.dist to phpunit.xml and adapt to your needs, or leave as is. Run PhpUnit test or composer scripts like this:
