Download the PHP package schnti/cachebuster without Composer

On this page you can find all versions of the php package schnti/cachebuster. 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 schnti/cachebuster

Informations about the package cachebuster

Cachebuster plugin

A plugin for Kirby 3 CMS to add modification timestamps to your css and js files, as long as they are embedded with the css() and js() helpers.

Please note that this plugin doesn't add caching headers to your CSS and JS files. To make proper use of this plugin, you need to add caching rules to your server configuration.

What gets a timestamp – and what doesn't

Only local files that actually exist on disk are rewritten. Everything else is returned unchanged:

URL passed to css() / js() Result
assets/main.js assets/main.<timestamp>.js
https://your-site.tld/assets/css/templates/blog.css (Kirby's automatic template assets) …/blog.<timestamp>.css
https://cdn.example.com/lib.js (external) unchanged
//cdn.example.com/lib.js (protocol-relative) unchanged
https://maps.googleapis.com/maps/api/js?key=… (query string) unchanged
assets/not-generated-yet.js (file missing) unchanged

Absolute URLs of your own site are matched against $kirby->url('index'), so subfolder installations work as well. The timestamp is inserted into the original URL, which keeps absolute URLs absolute and relative ones relative.

Commercial Usage

This plugin is free but if you use it in a commercial project please consider

Installation

Download

Download the files and place them inside site/plugins/cachebuster.

Composer

Git Submodule

You can add the plugin as a Git submodule.

$ cd your/project/root
$ git submodule add https://github.com/schnti/kirby3-cachebuster.git site/plugins/cachebuster
$ git submodule update --init --recursive
$ git commit -am "Add Kirby Cachebuster plugin"

Run these commands to update the plugin:

$ cd your/project/root
$ git submodule foreach git checkout master
$ git submodule foreach git pull
$ git commit -am "Update submodules"
$ git submodule update --init --recursive

Options

You can disable the plugin with the following line in your /site/config/config.php:

How to use it

htaccess rules for Apache

The timestamp is part of the filename, and that file does not exist on disk — so the server has to rewrite main.1234567890.css back to main.css. On Apache, add these lines to your htaccess file:

The order matters. The rule has to come before Kirby's catch-all, otherwise the request is routed to index.php first and you get a 404:

Running Kirby from a public folder changes nothing about the rules. Put the .htaccess into the document root itself — the public/ folder next to index.php — and leave RewriteBase /, because that folder is served at /. Only change RewriteBase if the site lives in a URL subfolder such as https://example.com/mysite.

If nothing happens at all, check that AllowOverride All is enabled for the directory; otherwise the .htaccess is ignored.

All versions of cachebuster with dependencies

PHP Build Version
Package Version
Requires getkirby/composer-installer Version ^1.1
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 schnti/cachebuster contains the following files

Loading the files please wait ...