* QUIC.cloud API CLI for LiteSpeed integration.
defined( 'WPINC' ) || exit();
* Constructor for Online CLI.
public function __construct() {
Debug2::debug( 'CLI_Cloud init' );
$this->cloud = Cloud::cls();
* Init domain on QUIC.cloud server (See https://quic.cloud/terms/)
* # Activate domain on QUIC.cloud (! Require SERVER IP setting to be set first)
* $ wp litespeed-online init
$resp = $this->cloud->init_qc_cli();
if ( ! empty( $resp['qc_activated'] ) ) {
$main_domain = ! empty( $resp['main_domain'] ) ? $resp['main_domain'] : false;
$this->cloud->update_qc_activation( $resp['qc_activated'], $main_domain );
WP_CLI::success( 'Init successfully. Activated type: ' . $resp['qc_activated'] );
WP_CLI::error( 'Init failed!' );
* Init domain CDN service on QUIC.cloud server (See https://quic.cloud/terms/)
* : The method to use (e.g., cname, ns, cfi).
* : Path to SSL certificate.
* : Cloudflare token for CFI method.
* : Output format (e.g., json).
* # Activate domain CDN on QUIC.cloud (support --format=json)
* $ wp litespeed-online cdn_init --method=cname|ns
* $ wp litespeed-online cdn_init --method=cname|ns --ssl-cert=xxx.pem --ssl-key=xxx
* $ wp litespeed-online cdn_init --method=cname|ns --ssl-cert=xxx.pem --ssl-key=xxx --json
* $ wp litespeed-online cdn_init --method=cfi --cf-token=xxxxxxxx
* $ wp litespeed-online cdn_init --method=cfi --cf-token=xxxxxxxx --ssl-cert=xxx.pem --ssl-key=xxx
* $ wp litespeed-online cdn_init --method=cfi --cf-token=xxxxxxxx --ssl-cert=xxx.pem --ssl-key=xxx --format=json
* @param array $args Positional arguments.
* @param array $assoc_args Associative arguments.
public function cdn_init( $args, $assoc_args ) {
if ( empty( $assoc_args['method'] ) ) {
WP_CLI::error( 'Init CDN failed! Missing parameters `--method`.' );
if ( ( ! empty( $assoc_args['ssl-cert'] ) && empty( $assoc_args['ssl-key'] ) ) || ( empty( $assoc_args['ssl-cert'] ) && ! empty( $assoc_args['ssl-key'] ) ) ) {
WP_CLI::error( 'Init CDN failed! SSL cert must be present together w/ SSL key.' );
if ( 'cfi' === $assoc_args['method'] && empty( $assoc_args['cf-token'] ) ) {
WP_CLI::error( 'Init CDN failed! CFI must set `--cf-token`.' );
$cert = ! empty( $assoc_args['ssl-cert'] ) ? $assoc_args['ssl-cert'] : '';
$key = ! empty( $assoc_args['ssl-key'] ) ? $assoc_args['ssl-key'] : '';
$cf_token = ! empty( $assoc_args['cf-token'] ) ? $assoc_args['cf-token'] : '';
$resp = $this->cloud->init_qc_cdn_cli( $assoc_args['method'], $cert, $key, $cf_token );
if ( ! empty( $resp['qc_activated'] ) ) {
$main_domain = ! empty( $resp['main_domain'] ) ? $resp['main_domain'] : false;
$this->cloud->update_qc_activation( $resp['qc_activated'], $main_domain, true );
if ( ! empty( $assoc_args['format'] ) && 'json' === $assoc_args['format'] ) {
WP_CLI::log( wp_json_encode( $resp ) );
if ( ! empty( $resp['qc_activated'] ) ) {
WP_CLI::success( 'Init QC CDN successfully. Activated type: ' . $resp['qc_activated'] );
WP_CLI::error( 'Init QC CDN failed!' );
if ( ! empty( $resp['cname'] ) ) {
WP_CLI::success( 'cname: ' . $resp['cname'] );
if ( ! empty( $resp['msgs'] ) ) {
WP_CLI::success( 'msgs: ' . wp_json_encode( $resp['msgs'] ) );
* Link user account by api key
* : User email for QUIC.cloud account.
* : API key for QUIC.cloud account.
* # Link user account by api key
* $ wp litespeed-online link --email=xxx@example.com --api-key=xxxx
* @param array $args Positional arguments.
* @param array $assoc_args Associative arguments.
public function link( $args, $assoc_args ) {
if ( empty( $assoc_args['email'] ) || empty( $assoc_args['api-key'] ) ) {
WP_CLI::error( 'Link to QUIC.cloud failed! Missing parameters `--email` or `--api-key`.' );
$resp = $this->cloud->link_qc_cli( $assoc_args['email'], $assoc_args['api-key'] );
if ( ! empty( $resp['qc_activated'] ) ) {
$main_domain = ! empty( $resp['main_domain'] ) ? $resp['main_domain'] : false;
$this->cloud->update_qc_activation( $resp['qc_activated'], $main_domain, true );
WP_CLI::success( 'Link successfully!' );
WP_CLI::log( wp_json_encode( $resp ) );
WP_CLI::error( 'Link failed!' );
* Sync usage data from QUIC.cloud
* : Output format (e.g., json).
* # Sync QUIC.cloud service usage info
* $ wp litespeed-online sync
* $ wp litespeed-online sync --json
* $ wp litespeed-online sync --format=json
* @param array $args Positional arguments.
* @param array $assoc_args Associative arguments.
public function sync( $args, $assoc_args ) {
$json = $this->cloud->sync_usage();
if ( ! empty( $assoc_args['format'] ) ) {
WP_CLI::print_value( $json, $assoc_args );
WP_CLI::success( 'Sync successfully' );
foreach ( Cloud::$services as $v ) {
'used' => ! empty( $json['usage.' . $v]['used'] ) ? $json['usage.' . $v]['used'] : 0,
'quota' => ! empty( $json['usage.' . $v]['quota'] ) ? $json['usage.' . $v]['quota'] : 0,
'PayAsYouGo_Used' => ! empty( $json['usage.' . $v]['pag_used'] ) ? $json['usage.' . $v]['pag_used'] : 0,
'PayAsYouGo_Balance' => ! empty( $json['usage.' . $v]['pag_bal'] ) ? $json['usage.' . $v]['pag_bal'] : 0,
WP_CLI\Utils\format_items( 'table', $list, array( 'key', 'used', 'quota', 'PayAsYouGo_Used', 'PayAsYouGo_Balance' ) );
* Check QC account status
* # Check QC account status
* $ wp litespeed-online cdn_status
public function cdn_status() {
$resp = $this->cloud->cdn_status_cli();
WP_CLI::log( wp_json_encode( $resp ) );
* List all QUIC.cloud services
* : Output format (e.g., json).
* # List all services tag
* $ wp litespeed-online services
* $ wp litespeed-online services --json
* $ wp litespeed-online services --format=json
* @param array $args Positional arguments.
* @param array $assoc_args Associative arguments.
public function services( $args, $assoc_args ) {
if ( ! empty( $assoc_args['format'] ) ) {
WP_CLI::print_value( Cloud::$services, $assoc_args );
foreach ( Cloud::$services as $v ) {
WP_CLI\Utils\format_items( 'table', $list, array( 'service' ) );
* List all QUIC.cloud servers in use
* : Output format (e.g., json).
* # List all QUIC.cloud servers in use
* $ wp litespeed-online nodes
* $ wp litespeed-online nodes --json
* $ wp litespeed-online nodes --format=json
* @param array $args Positional arguments.
* @param array $assoc_args Associative arguments.
public function nodes( $args, $assoc_args ) {
$json = Cloud::get_summary();
foreach ( Cloud::$services as $v ) {
$server = ! empty( $json['server.' . $v] ) ? $json['server.' . $v] : '';
$json_output[] = array( $v => $server );
if ( ! empty( $assoc_args['format'] ) ) {
WP_CLI::print_value( $json_output, $assoc_args );
WP_CLI\Utils\format_items( 'table', $list, array( 'service', 'server' ) );
* Detect closest node server for current service
* : Service to ping (e.g., img_optm).
* : Force detection of the closest server.
* # Detect closest node for one service
* $ wp litespeed-online ping img_optm
* $ wp litespeed-online ping img_optm --force
* @param array $param Positional arguments (service).
* @param array $assoc_args Associative arguments.
public function ping( $param, $assoc_args ) {
$force = ! empty( $assoc_args['force'] );
$json = $this->cloud->detect_cloud( $svc, $force );
WP_CLI::success( 'Updated closest server.' );
WP_CLI::log( 'svc = ' . $svc );
WP_CLI::log( 'node = ' . ( $json ? $json : '-' ) );