Installation

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:

PHAR

curl -LO https://github.com/eliashaeussler/cache-warmup/releases/latest/download/cache-warmup.phar
chmod +x cache-warmup.phar

PHIVE

phive install cache-warmup

Docker

# Docker Hub
docker pull eliashaeussler/cache-warmup

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

Composer

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:

# 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:

PHAR

./cache-warmup.phar "https://www.example.com/sitemap.xml"

PHIVE

./tools/cache-warmup "https://www.example.com/sitemap.xml"

Docker

# 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"

Composer

./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.