Console commands

The extension provides the following console commands:

warming:cachewarmup

A command to trigger cache warmup of single pages and/or whole sites using their XML sitemaps.

Important

You must pass at least the --pages or --sites command option.

Tip

If you use warming:cachewarmup in your deployment process and the sitemap is protected with HTTP authentication (basic auth) or the website does not have a valid SSL certificate, you can configure this in the extension configuration with verboseCrawlerOptions and parserClientOptions.

vendor/bin/typo3 warming:cachewarmup

The following command options are available:

-p|--pages
Required

false

Type

integer

Default

none

Multiple allowed

true

Use this option to provide IDs of pages whose Frontend caches should be warmed up. You can pass this option multiple times, either as single integer values or as a comma-separated list of integer values.

Example:

vendor/bin/typo3 warming:cachewarmup -p 1 -p 2 -p 3
vendor/bin/typo3 warming:cachewarmup -p 1,2,3
-s|--sites
Required

false

Type

integer or string (site identifier)

Default

none

Multiple allowed

true

Use this option to provide a list of sites to be warmed up. You can either pass the appropriate site identifiers or the site's root page IDs.

Example:

vendor/bin/typo3 warming:cachewarmup -s my-cool-site
vendor/bin/typo3 warming:cachewarmup -s 1
-l|--languages
Required

false

Type

integer

Default

-1 (all languages)

Multiple allowed

true

You can optionally limit the languages of sites to be warmed up to a given list of language IDs. If this option is omitted, all site languages will be included in the cache warmup.

Example:

vendor/bin/typo3 warming:cachewarmup -l 0 -l 1
vendor/bin/typo3 warming:cachewarmup -l 0,1
--limit
Required

false

Type

integer

Default

limit value from extension configuration

Multiple allowed

false

Maximum number of pages to be crawled. Set to 0 to disable the limit. If this option is omitted, the limit value from extension configuration is used.

Example:

vendor/bin/typo3 warming:cachewarmup --limit 100
--strategy
Required

false

Type

string

Default

strategy value from extension configuration

Multiple allowed

false

Name of an available crawling strategy to use for cache warmup. If this option is omitted, the strategy value from extension configuration is used.

Example:

vendor/bin/typo3 warming:cachewarmup --strategy sort-by-priority
-x|--strict
Required

false

Type

boolean

Default

false

Multiple allowed

false

Exit with a non-zero status code in case cache warmup fails or errors occur during cache warmup.

Example:

vendor/bin/typo3 warming:cachewarmup --strict

warming:showuseragent

A command that shows the custom User-Agent header that is used for cache warmup requests by default crawlers.

Note

This command is not schedulable.

vendor/bin/typo3 warming:showuseragent