* LiteSpeed Cache Purge Interface CLI.
defined( 'WPINC' ) || exit();
use LiteSpeed\Admin_Display;
* LiteSpeed Cache Purge Interface
* List all site domains and ids on the network.
* For use with the blog subcommand.
* # List all the site domains and ids in a table.
* $ wp litespeed-purge network_list
public function network_list() {
if ( ! is_multisite() ) {
WP_CLI::error( 'This is not a multisite installation!' );
$buf = WP_CLI::colorize( '%CThe list of installs:%n' ) . PHP_EOL;
foreach ( $sites as $site ) {
$buf .= WP_CLI::colorize( '%Y' . $site->domain . $site->path . ':%n ID ' . $site->blog_id ) . PHP_EOL;
* Sends an AJAX request to the site.
* @param string $action The action to perform.
* @param array $extra Additional data to include in the request.
* @return object The HTTP response.
private function send_request( $action, $extra = array() ) {
Router::ACTION => $action,
Router::NONCE => wp_create_nonce( $action ),
if ( ! empty( $extra ) ) {
$data = array_merge( $data, $extra );
$url = admin_url( 'admin-ajax.php' );
WP_CLI::debug( 'URL is ' . $url );
$out = WP_CLI\Utils\http_request( 'GET', $url, $data );
* Purges all cache entries for the blog (the entire network if multisite).
* # Purge Everything associated with the WordPress install.
* $ wp litespeed-purge all
$action = is_multisite() ? Core::ACTION_QS_PURGE_EMPTYCACHE : Core::ACTION_QS_PURGE_ALL;
$purge_ret = $this->send_request( $action );
if ( $purge_ret->success ) {
WP_CLI::success( __( 'Purged All!', 'litespeed-cache' ) );
WP_CLI::error( 'Something went wrong! Got ' . $purge_ret->status_code );
* Purges all cache entries for the blog.
* : The blog id to purge.
* # In a multisite install, purge only the shop.example.com cache (stored as blog id 2).
* $ wp litespeed-purge blog 2
* @param array $args Positional arguments (blogid).
public function blog( $args ) {
if ( ! is_multisite() ) {
WP_CLI::error( 'Not a multisite installation.' );
if ( ! is_numeric( $blogid ) ) {
$error = WP_CLI::colorize( '%RError: invalid blog id entered.%n' );
$this->network_list( $args );
$site = get_blog_details( $blogid );
$error = WP_CLI::colorize( '%RError: invalid blog id entered.%n' );
$this->network_list( $args );
switch_to_blog( $blogid );
$purge_ret = $this->send_request( Core::ACTION_QS_PURGE_ALL );
if ( $purge_ret->success ) {
WP_CLI::success( __( 'Purged the blog!', 'litespeed-cache' ) );
WP_CLI::error( 'Something went wrong! Got ' . $purge_ret->status_code );
* Purges all cache tags related to a URL.
* # Purge the front page.
* $ wp litespeed-purge url https://mysite.com/
* @param array $args Positional arguments (URL).
public function url( $args ) {
Router::ACTION => Core::ACTION_QS_PURGE,
$deconstructed = wp_parse_url( $url );
if ( empty( $deconstructed ) ) {
WP_CLI::error( 'URL passed in is invalid.' );
if ( 0 === get_blog_id_from_url( $deconstructed['host'], '/' ) ) {
WP_CLI::error( 'Multisite URL passed in is invalid.' );
$deconstructed_site = wp_parse_url( get_home_url() );
if ( $deconstructed['host'] !== $deconstructed_site['host'] ) {
WP_CLI::error( 'Single site URL passed in is invalid.' );
WP_CLI::debug( 'URL is ' . $url );
$purge_ret = WP_CLI\Utils\http_request( 'GET', $url, $data );
if ( $purge_ret->success ) {
WP_CLI::success( __( 'Purged the URL!', 'litespeed-cache' ) );
WP_CLI::error( 'Something went wrong! Got ' . $purge_ret->status_code );
* Helper function for purging by IDs.
* @param array $args The ID list to parse.
* @param string $select The purge by kind.
* @param callable $callback The callback function to check the ID.
private function purgeby( $args, $select, $callback ) {
foreach ( $args as $val ) {
if ( ! ctype_digit( $val ) ) {
WP_CLI::debug( '[LSCACHE] Skip val, not a number. ' . $val );
$term = $callback( $val );
if ( ! empty( $term ) ) {
WP_CLI::line( $term->name );
$filtered[] = in_array( $callback, array( 'get_tag', 'get_category' ), true ) ? $term->name : $val;
WP_CLI::debug( '[LSCACHE] Skip val, not a valid term. ' . $val );
if ( empty( $filtered ) ) {
WP_CLI::error( 'Arguments must be integer IDs.' );
$str = implode( ',', $filtered );
Admin_Display::PURGEBY_CAT => 'Category',
Admin_Display::PURGEBY_PID => 'Post ID',
Admin_Display::PURGEBY_TAG => 'Tag',
Admin_Display::PURGEBY_URL => 'URL',
WP_CLI::line( 'Will purge the following: [' . $purge_titles[ $select ] . '] ' . $str );
Admin_Display::PURGEBYOPT_SELECT => $select,
Admin_Display::PURGEBYOPT_LIST => $str,
$purge_ret = $this->send_request( Core::ACTION_PURGE_BY, $data );
if ( $purge_ret->success ) {
WP_CLI::success( __( 'Purged!', 'litespeed-cache' ) );
WP_CLI::error( 'Something went wrong! Got ' . $purge_ret->status_code );
* Purges cache tags for a WordPress tag.
* : The Term IDs to purge.
* # Purge the tag IDs 1, 3, and 5
* $ wp litespeed-purge tag 1 3 5
* @param array $args Positional arguments (IDs).
public function tag( $args ) {
$this->purgeby( $args, Admin_Display::PURGEBY_TAG, 'get_tag' );
* Purges cache tags for a WordPress category.
* : The Term IDs to purge.
* # Purge the category IDs 1, 3, and 5
* $ wp litespeed-purge category 1 3 5
* @param array $args Positional arguments (IDs).
public function category( $args ) {
$this->purgeby( $args, Admin_Display::PURGEBY_CAT, 'get_category' );
* Purges cache tags for a WordPress Post/Product.
* : The Post IDs to purge.
* # Purge the post IDs 1, 3, and 5
* $ wp litespeed-purge post_id 1 3 5
* @param array $args Positional arguments (IDs).
public function post_id( $args ) {
$this->purgeby( $args, Admin_Display::PURGEBY_PID, 'get_post' );