Public Member Functions
	__construct ()

	setInitialPaths ()

	setRelativePath ($relativePath)

	setRootPath ($rootPath)

	setBackPath ($backPath)

	concatenateCssFiles (array $cssFiles, array $options=[])

	concatenateJsFiles (array $jsFiles)

	compressCssFiles (array $cssFiles)

	compressCssFile ($filename)

	compressJsFiles (array $jsFiles)

	compressJsFile ($filename)

Static Public Member Functions
static	compressCssPregCallback ($matches)

Protected Member Functions
	setInitialBackPath ()

	setInitialRootPath ()

	setInitialRelativePath ()

	createMergedCssFile (array $filesToInclude)

	createMergedJsFile (array $filesToInclude)

	createMergedFile (array $filesToInclude, $type='css')

	getFilenameFromMainDir ($filename)

	checkBaseDirectory ($filename, array $baseDirectories)

	cssFixRelativeUrlPaths ($contents, $oldDir)

	findAndReplaceUrlPathsByRegex ($contents, $regex, $newDir, $wrap='\|')

	cssFixStatements ($contents)

	writeFileAndCompressed ($filename, $contents)

	returnFileReference ($filename)

	retrieveExternalFile ($url)

	compressCssString ($contents)

Protected Attributes
	$targetDirectory = 'typo3temp/compressor/'

	$relativePath = ''

	$rootPath = ''

	$backPath = ''

	$createGzipped = false

	$gzipCompressionLevel = -1

	$htaccessTemplate

Detailed Description

Compressor This merges and compresses CSS and JavaScript files of the TYPO3 Backend.

Definition at line 26 of file ResourceCompressor.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Core\Resource\ResourceCompressor::__construct ( )

Constructor

Definition at line 71 of file ResourceCompressor.php.

References $GLOBALS, TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger(), TYPO3\CMS\Core\Utility\GeneralUtility\mkdir(), TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialPaths(), and TYPO3\CMS\Core\Utility\GeneralUtility\writeFile().

Member Function Documentation

◆ checkBaseDirectory()

TYPO3\CMS\Core\Resource\ResourceCompressor::checkBaseDirectory	(		$filename,
		array	$baseDirectories
	)

protected

Decides whether a file comes from one of the baseDirectories

Parameters

string	$filename	Filename
array	$baseDirectories	Base directories

Returns: bool File belongs to a base directory or not

Definition at line 607 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\isFirstPartOfStr().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\concatenateCssFiles().

◆ compressCssFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::compressCssFile ( $filename )

Compresses a CSS file

Options: baseDirectories If set, only include files below one of the base directories

removes comments and whitespaces Adopted from https://github.com/drupal/drupal/blob/8.0.x/core/lib/Drupal/Core/Asset/CssOptimizer.php

Parameters

string $filename Source filename, relative to requested page

Returns: string Compressed filename, relative to requested page

Definition at line 423 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssString(), TYPO3\CMS\Core\Resource\ResourceCompressor\cssFixRelativeUrlPaths(), TYPO3\CMS\Core\Utility\PathUtility\dirname(), TYPO3\CMS\Core\Resource\ResourceCompressor\getFilenameFromMainDir(), TYPO3\CMS\Core\Utility\GeneralUtility\getUrl(), TYPO3\CMS\Core\Utility\PathUtility\pathinfo(), TYPO3\CMS\Core\Utility\GeneralUtility\resolveBackPath(), TYPO3\CMS\Core\Resource\ResourceCompressor\returnFileReference(), and TYPO3\CMS\Core\Resource\ResourceCompressor\writeFileAndCompressed().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFiles().

◆ compressCssFiles()

TYPO3\CMS\Core\Resource\ResourceCompressor::compressCssFiles ( array $cssFiles )

Compress multiple css files

Parameters

array $cssFiles The files to compress (array key = filename), relative to requested page

Returns: array The CSS files after compression (array key = new filename), relative to requested page

Definition at line 394 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile().

◆ compressCssPregCallback()

static TYPO3\CMS\Core\Resource\ResourceCompressor::compressCssPregCallback ( $matches )

static

Callback function for preg_replace

See also: compressCssFile

Parameters

array $matches

Returns: string the compressed string

Deprecated:: since TYPO3 CMS 7, will be removed in TYPO3 CMS 8, not in use anymore

Definition at line 455 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\logDeprecatedFunction().

◆ compressCssString()

TYPO3\CMS\Core\Resource\ResourceCompressor::compressCssString ( $contents )

protected

Compress a CSS string by removing comments and whitespace characters

Parameters

string $contents

Returns: string

Definition at line 785 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile().

◆ compressJsFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::compressJsFile ( $filename )

Compresses a javascript file

Parameters

string $filename Source filename, relative to requested page

Returns: string Filename of the compressed file, relative to requested page

Definition at line 540 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\getFilenameFromMainDir(), TYPO3\CMS\Core\Utility\GeneralUtility\getUrl(), TYPO3\CMS\Core\Utility\PathUtility\pathinfo(), TYPO3\CMS\Core\Utility\GeneralUtility\resolveBackPath(), TYPO3\CMS\Core\Resource\ResourceCompressor\returnFileReference(), and TYPO3\CMS\Core\Resource\ResourceCompressor\writeFileAndCompressed().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressJsFiles().

◆ compressJsFiles()

TYPO3\CMS\Core\Resource\ResourceCompressor::compressJsFiles ( array $jsFiles )

Compress multiple javascript files

Parameters

array $jsFiles The files to compress (array key = filename), relative to requested page

Returns: array The js files after compression (array key = new filename), relative to requested page

Definition at line 517 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\compressJsFile().

◆ concatenateCssFiles()

TYPO3\CMS\Core\Resource\ResourceCompressor::concatenateCssFiles	(	array	$cssFiles,
		array	$options = `[]`
	)

Concatenates the Stylesheet files

Options: baseDirectories If set, only include files below one of the base directories

Parameters

array	$cssFiles	CSS files to process
array	$options	Additional options

Returns: array CSS files

Definition at line 192 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\checkBaseDirectory(), TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedCssFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\getFilenameFromMainDir().

◆ concatenateJsFiles()

TYPO3\CMS\Core\Resource\ResourceCompressor::concatenateJsFiles ( array $jsFiles )

Concatenates the JavaScript files

Parameters

array $jsFiles JavaScript files to process

Returns: array JS files

Definition at line 251 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedJsFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\getFilenameFromMainDir().

◆ createMergedCssFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::createMergedCssFile ( array $filesToInclude )

protected

Creates a merged CSS file

Parameters

array $filesToInclude Files which should be merged, paths relative to root path

Returns: mixed Filename of the merged file

Definition at line 298 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\concatenateCssFiles().

◆ createMergedFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::createMergedFile	(	array	$filesToInclude,
			$type = `'css'`
	)

protected

Creates a merged file with given file type

Parameters

array	$filesToInclude	Files which should be merged, paths relative to root path
string	$type	File type

Exceptions

Definition at line 323 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\StringUtility\beginsWith(), TYPO3\CMS\Core\Resource\ResourceCompressor\cssFixRelativeUrlPaths(), TYPO3\CMS\Core\Resource\ResourceCompressor\cssFixStatements(), TYPO3\CMS\Core\Utility\PathUtility\dirname(), TYPO3\CMS\Core\Utility\GeneralUtility\getIndpEnv(), TYPO3\CMS\Core\Utility\GeneralUtility\getUrl(), TYPO3\CMS\Core\Utility\GeneralUtility\isFirstPartOfStr(), TYPO3\CMS\Core\Utility\GeneralUtility\isOnCurrentHost(), TYPO3\CMS\Core\Utility\GeneralUtility\isValidUrl(), TYPO3\CMS\Core\Utility\GeneralUtility\resolveBackPath(), TYPO3\CMS\Core\Resource\ResourceCompressor\retrieveExternalFile(), and TYPO3\CMS\Core\Utility\GeneralUtility\writeFile().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedCssFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedJsFile().

◆ createMergedJsFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::createMergedJsFile ( array $filesToInclude )

protected

Creates a merged JS file

Parameters

array $filesToInclude Files which should be merged, paths relative to root path

Returns: mixed Filename of the merged file

Definition at line 309 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\concatenateJsFiles().

◆ cssFixRelativeUrlPaths()

TYPO3\CMS\Core\Resource\ResourceCompressor::cssFixRelativeUrlPaths	(	$contents,
		$oldDir
	)

protected

Fixes the relative paths inside of url() references in CSS files

Parameters

string	$contents	Data to process
string	$oldDir	Directory of the original file, relative to TYPO3_mainDir

Returns: string Processed data

Definition at line 625 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\findAndReplaceUrlPathsByRegex().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile().

◆ cssFixStatements()

TYPO3\CMS\Core\Resource\ResourceCompressor::cssFixStatements ( $contents )

protected

Definition at line 680 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile().

◆ findAndReplaceUrlPathsByRegex()

TYPO3\CMS\Core\Resource\ResourceCompressor::findAndReplaceUrlPathsByRegex	(	$contents,
		$regex,
		$newDir,
		$wrap = `'\|'`
	)

protected

Finds and replaces all URLs by using a given regex

Parameters

string	$contents	Data to process
string	$regex	Regex used to find URLs in content
string	$newDir	Path to prepend to the original file
string	$wrap	Wrap around replaced values

Returns: string Processed data

Definition at line 651 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\cssFixRelativeUrlPaths().

◆ getFilenameFromMainDir()

TYPO3\CMS\Core\Resource\ResourceCompressor::getFilenameFromMainDir ( $filename )

protected

Finds the relative path to a file, relative to the root path.

Parameters

string $filename the name of the file

Returns: string the path to the file relative to the root path

Definition at line 566 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$backPath, and TYPO3\CMS\Core\Utility\GeneralUtility\resolveBackPath().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile(), TYPO3\CMS\Core\Resource\ResourceCompressor\compressJsFile(), TYPO3\CMS\Core\Resource\ResourceCompressor\concatenateCssFiles(), and TYPO3\CMS\Core\Resource\ResourceCompressor\concatenateJsFiles().

◆ retrieveExternalFile()

TYPO3\CMS\Core\Resource\ResourceCompressor::retrieveExternalFile ( $url )

protected

Retrieves an external file and stores it locally.

Parameters

string $url

Returns: string Temporary local filename for the externally-retrieved file

Definition at line 766 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\getUrl(), and TYPO3\CMS\Core\Utility\GeneralUtility\writeFile().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile().

◆ returnFileReference()

TYPO3\CMS\Core\Resource\ResourceCompressor::returnFileReference ( $filename )

protected

Decides whether a client can deal with gzipped content or not and returns the according file name, based on HTTP_ACCEPT_ENCODING

Parameters

string $filename File name

Returns: string $filename suffixed with '.gzip' or not - dependent on HTTP_ACCEPT_ENCODING

Definition at line 750 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\getIndpEnv().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\compressJsFile().

◆ setBackPath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setBackPath ( $backPath )

Sets relative back path

Parameters

string $backPath Back path

Returns: void

Definition at line 175 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$backPath.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialBackPath().

◆ setInitialBackPath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setInitialBackPath ( )

protected

Sets relative back path

Returns: void

Definition at line 115 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$backPath, $GLOBALS, and TYPO3\CMS\Core\Resource\ResourceCompressor\setBackPath().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialPaths().

◆ setInitialPaths()

TYPO3\CMS\Core\Resource\ResourceCompressor::setInitialPaths ( )

Sets initial values for paths.

Returns: void

Definition at line 103 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialBackPath(), TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRelativePath(), and TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRootPath().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\__construct().

◆ setInitialRelativePath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setInitialRelativePath ( )

protected

Sets relative path to PATH_site

Returns: void

Definition at line 137 of file ResourceCompressor.php.

References $GLOBALS, TYPO3\CMS\Core\Resource\ResourceCompressor\$relativePath, and TYPO3\CMS\Core\Resource\ResourceCompressor\setRelativePath().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialPaths().

◆ setInitialRootPath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setInitialRootPath ( )

protected

Sets absolute path to working directory

Returns: void

Definition at line 126 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$rootPath, and TYPO3\CMS\Core\Resource\ResourceCompressor\setRootPath().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialPaths().

◆ setRelativePath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setRelativePath ( $relativePath )

Sets relative path to PATH_site

Parameters

string $relativePath Relative path to site root

Returns: void

Definition at line 149 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$relativePath.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRelativePath().

◆ setRootPath()

TYPO3\CMS\Core\Resource\ResourceCompressor::setRootPath ( $rootPath )

Sets absolute path to working directory

Parameters

string $rootPath Absolute path

Returns: void

Definition at line 162 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Resource\ResourceCompressor\$rootPath.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRootPath().

◆ writeFileAndCompressed()

TYPO3\CMS\Core\Resource\ResourceCompressor::writeFileAndCompressed	(	$filename,
		$contents
	)

protected

Writes $contents into file $filename together with a gzipped version into $filename.gz

Parameters

string	$filename	Target filename
string	$contents	File contents

Returns: void

Definition at line 733 of file ResourceCompressor.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\writeFile().

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\compressCssFile(), and TYPO3\CMS\Core\Resource\ResourceCompressor\compressJsFile().

Member Data Documentation

◆ $backPath

TYPO3\CMS\Core\Resource\ResourceCompressor::$backPath = ''

protected

Definition at line 46 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\getFilenameFromMainDir(), TYPO3\CMS\Core\Resource\ResourceCompressor\setBackPath(), and TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialBackPath().

◆ $createGzipped

TYPO3\CMS\Core\Resource\ResourceCompressor::$createGzipped = false

protected

Definition at line 53 of file ResourceCompressor.php.

◆ $gzipCompressionLevel

TYPO3\CMS\Core\Resource\ResourceCompressor::$gzipCompressionLevel = -1

protected

Definition at line 58 of file ResourceCompressor.php.

◆ $htaccessTemplate

TYPO3\CMS\Core\Resource\ResourceCompressor::$htaccessTemplate

protected

Initial value:

= '<FilesMatch "\\.(js|css)(\\.gzip)?$">
    <IfModule mod_expires.c>
        ExpiresActive on
        ExpiresDefault "access plus 7 days"
    </IfModule>
    FileETag MTime Size
</FilesMatch>'

Definition at line 60 of file ResourceCompressor.php.

◆ $relativePath

TYPO3\CMS\Core\Resource\ResourceCompressor::$relativePath = ''

protected

Definition at line 36 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRelativePath(), and TYPO3\CMS\Core\Resource\ResourceCompressor\setRelativePath().

◆ $rootPath

TYPO3\CMS\Core\Resource\ResourceCompressor::$rootPath = ''

protected

Definition at line 41 of file ResourceCompressor.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\setInitialRootPath(), and TYPO3\CMS\Core\Resource\ResourceCompressor\setRootPath().

◆ $targetDirectory

TYPO3\CMS\Core\Resource\ResourceCompressor::$targetDirectory = 'typo3temp/compressor/'

protected

Definition at line 31 of file ResourceCompressor.php.

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkBaseDirectory()

◆ compressCssFile()

◆ compressCssFiles()

◆ compressCssPregCallback()

◆ compressCssString()

◆ compressJsFile()

◆ compressJsFiles()

◆ concatenateCssFiles()

◆ concatenateJsFiles()

◆ createMergedCssFile()

◆ createMergedFile()

◆ createMergedJsFile()

◆ cssFixRelativeUrlPaths()

◆ cssFixStatements()

◆ findAndReplaceUrlPathsByRegex()

◆ getFilenameFromMainDir()

◆ retrieveExternalFile()

◆ returnFileReference()

◆ setBackPath()

◆ setInitialBackPath()

◆ setInitialPaths()

◆ setInitialRelativePath()

◆ setInitialRootPath()

◆ setRelativePath()

◆ setRootPath()

◆ writeFileAndCompressed()

Member Data Documentation

◆ $backPath

◆ $createGzipped

◆ $gzipCompressionLevel

◆ $htaccessTemplate

◆ $relativePath

◆ $rootPath

◆ $targetDirectory