[![Header with logo](docs/img/header.png)](https://cache-warmup.dev/)
[![PHAR downloads](https://img.shields.io/github/downloads/eliashaeussler/cache-warmup/total?label=PHAR+downloads&logo=github&logoColor=white)](https://github.com/eliashaeussler/cache-warmup/releases)
[![GHCR pulls](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fipitio.github.io%2Fbackage%2Feliashaeussler%2Fcache-warmup%2Fcache-warmup.json&query=%24.downloads&logo=github&label=GHCR%20pulls)](https://github.com/eliashaeussler/cache-warmup/pkgs/container/cache-warmup)
[![Docker pulls](https://img.shields.io/docker/pulls/eliashaeussler/cache-warmup?label=Docker+pulls&logo=docker&logoColor=white)](https://hub.docker.com/r/eliashaeussler/cache-warmup)
[![Packagist downloads](https://img.shields.io/packagist/dt/eliashaeussler/cache-warmup?label=Packagist+downloads&logo=packagist&logoColor=white)](https://packagist.org/packages/eliashaeussler/cache-warmup)
[![License](https://img.shields.io/github/license/eliashaeussler/cache-warmup?label=License&logo=gnu&logoColor=white)](LICENSE.md)
# Sitemap Crawler & Cache Warmer
A PHP library to warm up website caches of URLs located in XML sitemaps.
[**Explore the docs »**](https://cache-warmup.dev/)
[Report Bug](https://github.com/eliashaeussler/cache-warmup/issues/new?template=bug_report.yml&title=%5BBUG%5D) ·
[Request Feature](https://github.com/eliashaeussler/cache-warmup/issues/new?template=feature_request.yml&title=%5BFEATURE%5D) ·
[Join Discussions](https://github.com/eliashaeussler/cache-warmup/discussions) ·
[Latest Release](https://github.com/eliashaeussler/cache-warmup/releases/latest) ·
[Sponsor](https://cache-warmup.dev/sponsor.html)
โจ Features
- Warm up caches of URLs located in XML sitemaps
- Console command and PHP API for cache warmup
- Out-of-the-box support for sitemap indexes
- Exclusion patterns for sitemaps and URLs
- Various crawling strategies to modify crawling behavior
- Support for gzipped XML sitemaps
- Interface for custom crawler implementations
๐ Getting Started
# Download latest release
curl -LO https://github.com/eliashaeussler/cache-warmup/releases/latest/download/cache-warmup.phar
chmod +x cache-warmup.phar
# Run cache warmup
./cache-warmup.phar "https://www.example.com/sitemap.xml"
Find more installation methods
in the official documentation.
๐ Documentation
Find all available installation methods, configuration options and customization
opportunities in the official documentation.
๐งโ๐ป Contributing
Please have a look at CONTRIBUTING.md
.
โญ License
This project is licensed under GNU General Public License 3.0 (or later).