<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* The error class.

[2] Fix | Delete

*

[3] Fix | Delete

* @package LiteSpeed

[4] Fix | Delete

* @since 3.0

[5] Fix | Delete

*/

[6] Fix | Delete

[7] Fix | Delete

namespace LiteSpeed;

[8] Fix | Delete

[9] Fix | Delete

defined( 'WPINC' ) || exit();

[10] Fix | Delete

[11] Fix | Delete

/**

[12] Fix | Delete

* Class Error

[13] Fix | Delete

*

[14] Fix | Delete

* Handles error message translation and throwing for LiteSpeed Cache.

[15] Fix | Delete

*

[16] Fix | Delete

* @since 3.0

[17] Fix | Delete

*/

[18] Fix | Delete

class Error {

[19] Fix | Delete

[20] Fix | Delete

/**

[21] Fix | Delete

* Error code mappings to numeric values.

[22] Fix | Delete

*

[23] Fix | Delete

* @since 3.0

[24] Fix | Delete

* @var array

[25] Fix | Delete

*/

[26] Fix | Delete

private static $code_set = [

[27] Fix | Delete

'HTA_LOGIN_COOKIE_INVALID' => 4300, // .htaccess did not find.

[28] Fix | Delete

'HTA_DNF' => 4500, // .htaccess did not find.

[29] Fix | Delete

'HTA_BK' => 9010, // backup

[30] Fix | Delete

'HTA_R' => 9041, // read htaccess

[31] Fix | Delete

'HTA_W' => 9042, // write

[32] Fix | Delete

'HTA_GET' => 9030, // failed to get

[33] Fix | Delete

];

[34] Fix | Delete

[35] Fix | Delete

/**

[36] Fix | Delete

* Throw an error with message

[37] Fix | Delete

*

[38] Fix | Delete

* Throws an exception with the translated error message.

[39] Fix | Delete

*

[40] Fix | Delete

* @since 3.0

[41] Fix | Delete

* @access public

[42] Fix | Delete

* @param string $code Error code.

[43] Fix | Delete

* @param mixed $args Optional arguments for message formatting.

[44] Fix | Delete

* @throws \Exception Always throws an exception with the error message.

[45] Fix | Delete

*/

[46] Fix | Delete

public static function t( $code, $args = null ) {

[47] Fix | Delete

throw new \Exception( wp_kses_post( self::msg( $code, $args ) ) );

[48] Fix | Delete

}

[49] Fix | Delete

[50] Fix | Delete

/**

[51] Fix | Delete

* Translate an error to description

[52] Fix | Delete

*

[53] Fix | Delete

* Converts error codes to human-readable messages.

[54] Fix | Delete

*

[55] Fix | Delete

* @since 3.0

[56] Fix | Delete

* @access public

[57] Fix | Delete

* @param string $code Error code.

[58] Fix | Delete

* @param mixed $args Optional arguments for message formatting.

[59] Fix | Delete

* @return string Translated error message.

[60] Fix | Delete

*/

[61] Fix | Delete

public static function msg( $code, $args = null ) {

[62] Fix | Delete

switch ( $code ) {

[63] Fix | Delete

case 'qc_setup_required':

[64] Fix | Delete

$msg =

[65] Fix | Delete

sprintf(

[66] Fix | Delete

__( 'You will need to finish %s setup to use the online services.', 'litespeed-cache' ),

[67] Fix | Delete

'<strong>QUIC.cloud</strong>'

[68] Fix | Delete

) .

[69] Fix | Delete

Doc::learn_more(

[70] Fix | Delete

admin_url( 'admin.php?page=litespeed-general' ),

[71] Fix | Delete

__( 'Click here to set.', 'litespeed-cache' ),

[72] Fix | Delete

true,

[73] Fix | Delete

false,

[74] Fix | Delete

true

[75] Fix | Delete

);

[76] Fix | Delete

break;

[77] Fix | Delete

[78] Fix | Delete

case 'out_of_daily_quota':

[79] Fix | Delete

$msg = __( 'You have used all of your daily quota for today.', 'litespeed-cache' );

[80] Fix | Delete

$msg .=

[81] Fix | Delete

' ' .

[82] Fix | Delete

Doc::learn_more(

[83] Fix | Delete

'https://docs.quic.cloud/billing/services/#daily-limits-on-free-quota-usage',

[84] Fix | Delete

__( 'Learn more or purchase additional quota.', 'litespeed-cache' ),

[85] Fix | Delete

false,

[86] Fix | Delete

false,

[87] Fix | Delete

true

[88] Fix | Delete

);

[89] Fix | Delete

break;

[90] Fix | Delete

[91] Fix | Delete

case 'out_of_quota':

[92] Fix | Delete

$msg = __( 'You have used all of your quota left for current service this month.', 'litespeed-cache' );

[93] Fix | Delete

$msg .=

[94] Fix | Delete

' ' .

[95] Fix | Delete

Doc::learn_more(

[96] Fix | Delete

'https://docs.quic.cloud/billing/services/#daily-limits-on-free-quota-usage',

[97] Fix | Delete

__( 'Learn more or purchase additional quota.', 'litespeed-cache' ),

[98] Fix | Delete

false,

[99] Fix | Delete

false,

[100] Fix | Delete

true

[101] Fix | Delete

);

[102] Fix | Delete

break;

[103] Fix | Delete

[104] Fix | Delete

case 'too_many_requested':

[105] Fix | Delete

$msg = __( 'You have too many requested images, please try again in a few minutes.', 'litespeed-cache' );

[106] Fix | Delete

break;

[107] Fix | Delete

[108] Fix | Delete

case 'too_many_notified':

[109] Fix | Delete

$msg = __( 'You have images waiting to be pulled. Please wait for the automatic pull to complete, or pull them down manually now.', 'litespeed-cache' );

[110] Fix | Delete

break;

[111] Fix | Delete

[112] Fix | Delete

case 'empty_list':

[113] Fix | Delete

$msg = __( 'The image list is empty.', 'litespeed-cache' );

[114] Fix | Delete

break;

[115] Fix | Delete

[116] Fix | Delete

case 'lack_of_param':

[117] Fix | Delete

$msg = __( 'Not enough parameters. Please check if the QUIC.cloud connection is set correctly', 'litespeed-cache' );

[118] Fix | Delete

break;

[119] Fix | Delete

[120] Fix | Delete

case 'unfinished_queue':

[121] Fix | Delete

$msg = __( 'There is proceeding queue not pulled yet.', 'litespeed-cache' );

[122] Fix | Delete

break;

[123] Fix | Delete

[124] Fix | Delete

case 0 === strpos( $code, 'unfinished_queue ' ):

[125] Fix | Delete

$msg = sprintf(

[126] Fix | Delete

__( 'There is proceeding queue not pulled yet. Queue info: %s.', 'litespeed-cache' ),

[127] Fix | Delete

'<code>' . substr( $code, strlen( 'unfinished_queue ' ) ) . '</code>'

[128] Fix | Delete

);

[129] Fix | Delete

break;

[130] Fix | Delete

[131] Fix | Delete

case 'err_alias':

[132] Fix | Delete

$msg = __( 'The site is not a valid alias on QUIC.cloud.', 'litespeed-cache' );

[133] Fix | Delete

break;

[134] Fix | Delete

[135] Fix | Delete

case 'site_not_registered':

[136] Fix | Delete

$msg = __( 'The site is not registered on QUIC.cloud.', 'litespeed-cache' );

[137] Fix | Delete

break;

[138] Fix | Delete

[139] Fix | Delete

case 'err_key':

[140] Fix | Delete

$msg = __( 'The QUIC.cloud connection is not correct. Please try to sync your QUIC.cloud connection again.', 'litespeed-cache' );

[141] Fix | Delete

break;

[142] Fix | Delete

[143] Fix | Delete

case 'heavy_load':

[144] Fix | Delete

$msg = __( 'The current server is under heavy load.', 'litespeed-cache' );

[145] Fix | Delete

break;

[146] Fix | Delete

[147] Fix | Delete

case 'redetect_node':

[148] Fix | Delete

$msg = __( 'Online node needs to be redetected.', 'litespeed-cache' );

[149] Fix | Delete

break;

[150] Fix | Delete

[151] Fix | Delete

case 'err_overdraw':

[152] Fix | Delete

$msg = __( 'Credits are not enough to proceed the current request.', 'litespeed-cache' );

[153] Fix | Delete

break;

[154] Fix | Delete

[155] Fix | Delete

case 'W':

[156] Fix | Delete

$msg = __( '%s file not writable.', 'litespeed-cache' );

[157] Fix | Delete

break;

[158] Fix | Delete

[159] Fix | Delete

case 'HTA_DNF':

[160] Fix | Delete

if ( ! is_array( $args ) ) {

[161] Fix | Delete

$args = [ '<code>' . $args . '</code>' ];

[162] Fix | Delete

}

[163] Fix | Delete

$args[] = '.htaccess';

[164] Fix | Delete

$msg = __( 'Could not find %1$s in %2$s.', 'litespeed-cache' );

[165] Fix | Delete

break;

[166] Fix | Delete

[167] Fix | Delete

case 'HTA_LOGIN_COOKIE_INVALID':

[168] Fix | Delete

$msg = sprintf( __( 'Invalid login cookie. Please check the %s file.', 'litespeed-cache' ), '.htaccess' );

[169] Fix | Delete

break;

[170] Fix | Delete

[171] Fix | Delete

case 'HTA_BK':

[172] Fix | Delete

$msg = sprintf( __( 'Failed to back up %s file, aborted changes.', 'litespeed-cache' ), '.htaccess' );

[173] Fix | Delete

break;

[174] Fix | Delete

[175] Fix | Delete

case 'HTA_R':

[176] Fix | Delete

$msg = sprintf( __( '%s file not readable.', 'litespeed-cache' ), '.htaccess' );

[177] Fix | Delete

break;

[178] Fix | Delete

[179] Fix | Delete

case 'HTA_W':

[180] Fix | Delete

$msg = sprintf( __( '%s file not writable.', 'litespeed-cache' ), '.htaccess' );

[181] Fix | Delete

break;

[182] Fix | Delete

[183] Fix | Delete

case 'HTA_GET':

[184] Fix | Delete

$msg = sprintf( __( 'Failed to get %s file contents.', 'litespeed-cache' ), '.htaccess' );

[185] Fix | Delete

break;

[186] Fix | Delete

[187] Fix | Delete

case 'failed_tb_creation':

[188] Fix | Delete

$msg = __( 'Failed to create table %1$s! SQL: %2$s.', 'litespeed-cache' );

[189] Fix | Delete

break;

[190] Fix | Delete

[191] Fix | Delete

case 'crawler_disabled':

[192] Fix | Delete

$msg = __( 'Crawler disabled by the server admin.', 'litespeed-cache' );

[193] Fix | Delete

break;

[194] Fix | Delete

[195] Fix | Delete

case 'try_later': // QC error code

[196] Fix | Delete

$msg = __( 'Previous request too recent. Please try again later.', 'litespeed-cache' );

[197] Fix | Delete

break;

[198] Fix | Delete

[199] Fix | Delete

case 0 === strpos( $code, 'try_later ' ):

[200] Fix | Delete

$msg = sprintf(

[201] Fix | Delete

__( 'Previous request too recent. Please try again after %s.', 'litespeed-cache' ),

[202] Fix | Delete

'<code>' . Utility::readable_time( substr( $code, strlen( 'try_later ' ) ), 3600, true ) . '</code>'

[203] Fix | Delete

);

[204] Fix | Delete

break;

[205] Fix | Delete

[206] Fix | Delete

case 'waiting_for_approval':

[207] Fix | Delete

$msg = __( 'Your application is waiting for approval.', 'litespeed-cache' );

[208] Fix | Delete

break;

[209] Fix | Delete

[210] Fix | Delete

case 'callback_fail_hash':

[211] Fix | Delete

$msg = __( 'The callback validation to your domain failed due to hash mismatch.', 'litespeed-cache' );

[212] Fix | Delete

break;

[213] Fix | Delete

[214] Fix | Delete

case 'callback_fail':

[215] Fix | Delete

$msg = __( 'The callback validation to your domain failed. Please make sure there is no firewall blocking our servers.', 'litespeed-cache' );

[216] Fix | Delete

break;

[217] Fix | Delete

[218] Fix | Delete

case substr( $code, 0, 14 ) === 'callback_fail ':

[219] Fix | Delete

$msg =

[220] Fix | Delete

__( 'The callback validation to your domain failed. Please make sure there is no firewall blocking our servers. Response code: ', 'litespeed-cache' ) .

[221] Fix | Delete

substr( $code, 14 );

[222] Fix | Delete

break;

[223] Fix | Delete

[224] Fix | Delete

case 'forbidden':

[225] Fix | Delete

$msg = __( 'Your domain has been forbidden from using our services due to a previous policy violation.', 'litespeed-cache' );

[226] Fix | Delete

break;

[227] Fix | Delete

[228] Fix | Delete

case 'err_dns_active':

[229] Fix | Delete

$msg = __(

[230] Fix | Delete

'You cannot remove this DNS zone, because it is still in use. Please update the domain\'s nameservers, then try to delete this zone again, otherwise your site will become inaccessible.',

[231] Fix | Delete

'litespeed-cache'

[232] Fix | Delete

);

[233] Fix | Delete

break;

[234] Fix | Delete

[235] Fix | Delete

default:

[236] Fix | Delete

$msg = __( 'Unknown error', 'litespeed-cache' ) . ': ' . $code;

[237] Fix | Delete

break;

[238] Fix | Delete

}

[239] Fix | Delete

[240] Fix | Delete

if ( null !== $args ) {

[241] Fix | Delete

$msg = is_array( $args ) ? vsprintf( $msg, $args ) : sprintf( $msg, $args );

[242] Fix | Delete

}

[243] Fix | Delete

[244] Fix | Delete

if ( isset( self::$code_set[ $code ] ) ) {

[245] Fix | Delete

$msg = 'ERROR ' . self::$code_set[ $code ] . ': ' . $msg;

[246] Fix | Delete

}

[247] Fix | Delete

[248] Fix | Delete

return $msg;

[249] Fix | Delete

}

[250] Fix | Delete

}

[251] Fix | Delete

[252] Fix | Delete