* CDN handling for LiteSpeed Cache.
* Rewrites eligible asset URLs to configured CDN endpoints and integrates with WordPress filters.
defined( 'WPINC' ) || exit();
* Processes page content and WordPress asset URLs to map to CDN domains according to settings.
const BYPASS = 'LITESPEED_BYPASS_CDN';
* The working HTML/content buffer being processed.
* Whether CDN feature is enabled.
* List of original site URLs (may include wildcards) to be replaced.
* List of directories considered internal/original for CDN rewriting.
* CDN mapping rules; keys include mapping kinds or file extensions, values are URL(s).
* @var array<string,string|string[]>
private $_cfg_cdn_mapping = [];
* List of URL substrings/regex used to exclude items from CDN.
private $_cfg_cdn_exclude;
* Hosts used by CDN mappings for quick membership checks.
private $cdn_mapping_hosts = [];
* Initialize CDN integration and register filters if enabled.
if ( defined( self::BYPASS ) ) {
self::debug2( 'CDN bypass' );
if ( ! Router::can_cdn() ) {
if ( ! defined( self::BYPASS ) ) {
define( self::BYPASS, true );
$this->_cfg_cdn = $this->conf( Base::O_CDN );
if ( ! $this->_cfg_cdn ) {
if ( ! defined( self::BYPASS ) ) {
define( self::BYPASS, true );
$this->_cfg_url_ori = $this->conf( Base::O_CDN_ORI );
// Parse cdn mapping data to array( 'filetype' => 'url' )
$mapping_to_check = [ Base::CDN_MAPPING_INC_IMG, Base::CDN_MAPPING_INC_CSS, Base::CDN_MAPPING_INC_JS ];
foreach ( $this->conf( Base::O_CDN_MAPPING ) as $v ) {
if ( ! $v[ Base::CDN_MAPPING_URL ] ) {
$this_url = $v[ Base::CDN_MAPPING_URL ];
$this_host = wp_parse_url( $this_url, PHP_URL_HOST );
foreach ( $mapping_to_check as $to_check ) {
self::debug2( 'mapping ' . $to_check . ' -> ' . $this_url );
// If filetype to url is one to many, make url be an array
$this->_append_cdn_mapping( $to_check, $this_url );
if ( ! in_array( $this_host, $this->cdn_mapping_hosts, true ) ) {
$this->cdn_mapping_hosts[] = $this_host;
if ( $v[ Base::CDN_MAPPING_FILETYPE ] ) {
foreach ( $v[ Base::CDN_MAPPING_FILETYPE ] as $v2 ) {
$this->_cfg_cdn_mapping[ Base::CDN_MAPPING_FILETYPE ] = true;
// If filetype to url is one to many, make url be an array
$this->_append_cdn_mapping( $v2, $this_url );
if ( ! in_array( $this_host, $this->cdn_mapping_hosts, true ) ) {
$this->cdn_mapping_hosts[] = $this_host;
self::debug2( 'mapping ' . implode( ',', $v[ Base::CDN_MAPPING_FILETYPE ] ) . ' -> ' . $this_url );
if ( ! $this->_cfg_url_ori || ! $this->_cfg_cdn_mapping ) {
if ( ! defined( self::BYPASS ) ) {
define( self::BYPASS, true );
$this->_cfg_ori_dir = $this->conf( Base::O_CDN_ORI_DIR );
// In case user customized upload path
if ( defined( 'UPLOADS' ) ) {
$this->_cfg_ori_dir[] = UPLOADS;
// Check if need preg_replace
$this->_cfg_url_ori = Utility::wildcard2regex( $this->_cfg_url_ori );
$this->_cfg_cdn_exclude = $this->conf( Base::O_CDN_EXC );
if ( ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_IMG ] ) ) {
if ( function_exists( 'wp_calculate_image_srcset' ) ) {
add_filter( 'wp_calculate_image_srcset', [ $this, 'srcset' ], 999 );
add_filter( 'wp_get_attachment_image_src', [ $this, 'attach_img_src' ], 999 );
add_filter( 'wp_get_attachment_url', [ $this, 'url_img' ], 999 );
if ( ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_CSS ] ) ) {
add_filter( 'style_loader_src', [ $this, 'url_css' ], 999 );
if ( ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_JS ] ) ) {
add_filter( 'script_loader_src', [ $this, 'url_js' ], 999 );
add_filter( 'litespeed_buffer_finalize', [ $this, 'finalize' ], 30 );
* Associate all filetypes with CDN URL.
* @param string $filetype Mapping key (e.g., extension or mapping constant).
* @param string $url CDN base URL to use for this mapping.
private function _append_cdn_mapping( $filetype, $url ) {
// If filetype to url is one to many, make url be an array
if ( empty( $this->_cfg_cdn_mapping[ $filetype ] ) ) {
$this->_cfg_cdn_mapping[ $filetype ] = $url;
} elseif ( is_array( $this->_cfg_cdn_mapping[ $filetype ] ) ) {
// Append url to filetype
$this->_cfg_cdn_mapping[ $filetype ][] = $url;
// Convert _cfg_cdn_mapping from string to array
$this->_cfg_cdn_mapping[ $filetype ] = [ $this->_cfg_cdn_mapping[ $filetype ], $url ];
* Whether the given type is included in CDN mappings.
* @param string $type 'css' or 'js'.
* @return bool True if included in CDN.
public function inc_type( $type ) {
if ( 'css' === $type && ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_CSS ] ) ) {
if ( 'js' === $type && ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_JS ] ) ) {
* Run CDN processing on finalized buffer.
* NOTE: After cache finalized, cannot change cache control.
* @param string $content The HTML/content buffer.
* @return string The processed content.
public function finalize( $content ) {
$this->content = $content;
* Replace eligible URLs with CDN URLs in the working buffer.
private function _finalize() {
if ( defined( self::BYPASS ) ) {
self::debug( 'CDN _finalize' );
// Start replacing img src
if ( ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_INC_IMG ] ) ) {
$this->_replace_inline_css();
if ( ! empty( $this->_cfg_cdn_mapping[ Base::CDN_MAPPING_FILETYPE ] ) ) {
$this->_replace_file_types();
* Parse all file types and replace according to configured attributes.
private function _replace_file_types() {
$ele_to_check = $this->conf( Base::O_CDN_ATTR );
foreach ( $ele_to_check as $v ) {
if ( ! $v || false === strpos( $v, '.' ) ) {
self::debug2( 'replace setting bypassed: no . attribute ' . $v );
self::debug2( 'replace attribute ' . $v );
$attr = preg_quote( $v[1], '#' );
$pattern = '#<' . preg_quote( $v[0], '#' ) . '([^>]+)' . $attr . '=([\'"])(.+)\g{2}#iU';
$pattern = '# ' . $attr . '=([\'"])(.+)\g{1}#iU';
preg_match_all( $pattern, $this->content, $matches );
if (empty($matches[$v[0] ? 3 : 2])) {
foreach ($matches[$v[0] ? 3 : 2] as $k2 => $url) {
// self::debug2( 'check ' . $url );
$postfix = '.' . pathinfo((string) wp_parse_url($url, PHP_URL_PATH), PATHINFO_EXTENSION);
if (!array_key_exists($postfix, $this->_cfg_cdn_mapping)) {
// self::debug2( 'non-existed postfix ' . $postfix );
self::debug2( 'matched file_type ' . $postfix . ' : ' . $url );
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_FILETYPE, $postfix );
$attr_str = str_replace( $url, $url2, $matches[0][ $k2 ] );
$this->content = str_replace( $matches[0][ $k2 ], $attr_str, $this->content );
* Parse all images and replace their src attributes.
private function _replace_img() {
preg_match_all( '#<img([^>]+?)src=([\'"\\\]*)([^\'"\s\\\>]+)([\'"\\\]*)([^>]*)>#i', $this->content, $matches );
foreach ( $matches[3] as $k => $url ) {
// Check if is a DATA-URI
if ( false !== strpos( $url, 'data:image' ) ) {
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_INC_IMG );
$html_snippet = sprintf( '<img %1$s src=%2$s %3$s>', $matches[1][ $k ], $matches[2][ $k ] . $url2 . $matches[4][ $k ], $matches[5][ $k ] );
$this->content = str_replace( $matches[0][ $k ], $html_snippet, $this->content );
* Parse and replace all inline styles containing url().
private function _replace_inline_css() {
self::debug2( '_replace_inline_css', $this->_cfg_cdn_mapping );
* Excludes `\` from URL matching
* @see #959152 - WordPress LSCache CDN Mapping causing malformed URLS
preg_match_all( '/url\((?![\'"]?data)[\'"]?(.+?)[\'"]?\)/i', $this->content, $matches );
foreach ( $matches[1] as $k => $url ) {
$url = str_replace( [ ' ', '\t', '\n', '\r', '\0', '\x0B', '"', "'", '"', ''' ], '', $url );
$parsed_url = wp_parse_url( $url, PHP_URL_PATH );
$postfix = '.' . pathinfo( $parsed_url, PATHINFO_EXTENSION );
if ( array_key_exists( $postfix, $this->_cfg_cdn_mapping ) ) {
self::debug2( 'matched file_type ' . $postfix . ' : ' . $url );
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_FILETYPE, $postfix );
} elseif ( in_array( $postfix, [ 'jpg', 'jpeg', 'png', 'gif', 'svg', 'webp', 'avif' ], true ) ) {
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_INC_IMG );
$attr = str_replace( $matches[1][ $k ], $url2, $matches[0][ $k ] );
$this->content = str_replace( $matches[0][ $k ], $attr, $this->content );
self::debug2( '_replace_inline_css done' );
* Filter: wp_get_attachment_image_src.
* @since 1.7 Removed static from function.
* @param array{0:string,1:int,2:int} $img The URL of the attachment image src, the width, the height.
* @return array{0:string,1:int,2:int}
public function attach_img_src( $img ) {
$url = $this->rewrite( $img[0], Base::CDN_MAPPING_INC_IMG );
* Try to rewrite one image URL with CDN.
* @param string $url Original URL.
* @return string URL after rewriting, or original if not applicable.
public function url_img( $url ) {
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_INC_IMG );
* Try to rewrite one CSS URL with CDN.
* @param string $url Original URL.
* @return string URL after rewriting, or original if not applicable.
public function url_css( $url ) {
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_INC_CSS );
* Try to rewrite one JS URL with CDN.
* @param string $url Original URL.
* @return string URL after rewriting, or original if not applicable.
public function url_js( $url ) {
$url2 = $this->rewrite( $url, Base::CDN_MAPPING_INC_JS );
* Filter responsive image sources for CDN.
* @since 1.7 Removed static from function.
* @param array<int,array{url:string}> $srcs Srcset array.
* @return array<int,array{url:string}>
public function srcset( $srcs ) {
foreach ( $srcs as $w => $data ) {
$url = $this->rewrite( $data['url'], Base::CDN_MAPPING_INC_IMG );
$srcs[ $w ]['url'] = $url;
* Replace an URL with mapped CDN URL, if applicable.
* @param string $url Target URL.
* @param string $mapping_kind Mapping kind (e.g., Base::CDN_MAPPING_INC_IMG or Base::CDN_MAPPING_FILETYPE).