Skip to content

Installation ​

PHAR downloadsDocker pullsPackagist downloads

There are various installation methods for the Cache Warmup library. Choose the one that suits you best. We recommend using the PHAR file because it is the easiest to integrate into your project.

Download ​

Choose one of the following installation methods to download the Cache Warmup library:

bash
curl -LO https://github.com/eliashaeussler/cache-warmup/releases/latest/download/cache-warmup.phar
chmod +x cache-warmup.phar
bash
phive install cache-warmup
bash
# Docker Hub
docker pull eliashaeussler/cache-warmup

# GitHub Container Registry
docker pull ghcr.io/eliashaeussler/cache-warmup
bash
composer require eliashaeussler/cache-warmup

PHAR: Verify downloaded file (recommended)

It is recommended to verify the downloaded PHAR file before executing it. Each GitHub release provides an additional signature file which can be downloaded and used to verify the integrity of the downloaded PHAR file using your local GPG installation:

bash
# Download GPG signature
curl -LO https://github.com/eliashaeussler/cache-warmup/releases/latest/download/cache-warmup.phar.asc

# Import public GPG key
gpg --keyserver keys.openpgp.org --recv-keys E73F20790A629A2CEF2E9AE57C1C5363490E851E

# Verify PHAR file
gpg --verify cache-warmup.phar.asc cache-warmup.phar

First steps ​

Once downloaded, you can start by passing the URL to an XML sitemap:

bash
./cache-warmup.phar "https://www.example.com/sitemap.xml"
bash
./tools/cache-warmup "https://www.example.com/sitemap.xml"
bash
# Docker Hub
docker run --rm -it eliashaeussler/cache-warmup \
    "https://www.example.com/sitemap.xml"

# GitHub Container Registry
docker run --rm -it ghcr.io/eliashaeussler/cache-warmup \
    "https://www.example.com/sitemap.xml"
bash
./vendor/bin/cache-warmup "https://www.example.com/sitemap.xml"

For a more fine-grained configuration of the cache warmup process, please have a look at Configuration.

Released under the GNU General Public License 3.0 (or later)