<?php
/**
* LiteSpeed String Operator Library Class
*
* @since 1.3
* @package LiteSpeed
*/
namespace LiteSpeed;
defined( 'WPINC' ) || exit();
/**
* Class Str
*
* Provides string manipulation utilities for LiteSpeed Cache.
*
* @since 1.3
*/
class Str {
/** Keep JSON literals safe inside HTML script elements. */
const JSON_HTML_FLAGS = JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT;
/**
* Translate QC HTML links from html.
*
* Converts `<a href="{#xxx#}">xxxx</a>` to `<a href="xxx">xxxx</a>`.
*
* @since 7.0
* @access public
* @param string $html The HTML string to process.
* @return string The processed HTML string.
*/
public static function translate_qc_apis( $html ) {
preg_match_all( '/<a href="{#(\w+)#}"/U', $html, $matches );
if ( ! $matches ) {
return $html;
}
foreach ( $matches[0] as $k => $html_to_be_replaced ) {
$link = '<a href="' . Utility::build_url( Router::ACTION_CLOUD, Cloud::TYPE_API, false, null, [ 'action2' => $matches[1][ $k ] ] ) . '"';
$html = str_replace( $html_to_be_replaced, $link, $html );
}
return $html;
}
/**
* Return safe HTML
*
* Sanitizes HTML to allow only specific tags and attributes.
*
* @since 7.0
* @access public
* @param string $html The HTML string to sanitize.
* @return string The sanitized HTML string.
*/
public static function safe_html( $html ) {
$common_attrs = [
'class' => [],
'target' => [],
'src' => [],
'color' => [],
'href' => [],
];
$tags = [ 'hr', 'h3', 'h4', 'h5', 'ul', 'li', 'br', 'strong', 'p', 'span', 'img', 'a', 'div', 'font' ];
$allowed_tags = [];
foreach ( $tags as $tag ) {
$allowed_tags[ $tag ] = $common_attrs;
}
return wp_kses( $html, $allowed_tags );
}
/**
* Generate random string
*
* Creates a random string of specified length and character type.
*
* @since 1.3
* @access public
* @param int $len Length of string.
* @param int $type Character type: 1-Number, 2-LowerChar, 4-UpperChar, 7-All.
* @return string Randomly generated string.
*/
public static function rrand( $len, $type = 7 ) {
switch ( $type ) {
case 0:
$charlist = '012';
break;
case 1:
$charlist = '0123456789';
break;
case 2:
$charlist = 'abcdefghijklmnopqrstuvwxyz';
break;
case 3:
$charlist = '0123456789abcdefghijklmnopqrstuvwxyz';
break;
case 4:
$charlist = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
break;
case 5:
$charlist = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';
break;
case 6:
$charlist = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
break;
case 7:
$charlist = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
break;
}
$str = '';
$max = strlen( $charlist ) - 1;
for ( $i = 0; $i < $len; $i++ ) {
$str .= $charlist[ random_int( 0, $max ) ];
}
return $str;
}
/**
* Trim double quotes from a string
*
* Removes double quotes from a string for use as a preformatted src in HTML.
*
* @since 6.5.3
* @access public
* @param string $text The string to process.
* @return string The string with double quotes removed.
*/
public static function trim_quotes( $text ) {
return str_replace( '"', '', $text );
}
}