Inheritance diagram for TYPO3\CMS\Core\Utility\GeneralUtility:

Static Public Member Functions
static array< int, splitCalc( $string, $operators){ $res=[];$sign='+';while( $string) { $valueLen=strcspn( $string, $operators);$value=substr( $string, 0, $valueLen);$res[]=[ $sign, trim( $value)];$sign=substr( $string, $valueLen, 1);$string=substr( $string, $valueLen+1);} reset( $res);return $res;} public static bool function validEmail( $email) { if(!is_string( $email)) { return false;} if(trim( $email) !==$email) { return false;} if(strpos( $email, '@')===false) { return false;} $validator=new EmailValidator();return $validator->	isValid ($email, new RFCValidation())

static string	idnaEncode ($value)

static string	underscoredToUpperCamelCase ($string)

static string	underscoredToLowerCamelCase ($string)

static string	camelCaseToLowerCaseUnderscored ($string)

static bool	isValidUrl ($url)

static int[]	intExplode ($delimiter, $string, $removeEmptyValues=false, $limit=0)

static string[]	revExplode ($delimiter, $string, $count=0)

static string[]	trimExplode ($delim, $string, $removeEmptyValues=false, $limit=0)

static string	implodeArrayForUrl ($name, array $theArray, $str='', $skipBlank=false, $rawurlencodeParamName=false)

static mixed	xml2array ($string, $NSprefix='', $reportDocTag=false)

static mixed	xml2arrayProcess ($string, $NSprefix='', $reportDocTag=false)

static string	xmlRecompileFromStructValArray (array $vals)

static string	minifyJavaScript ($script, &$error='')

static mixed	getUrl ($url, $includeHeader=0, $requestHeaders=null, &$report=null)

static bool	writeFile ($file, $content, $changePermissions=false)

static mixed	fixPermissions ($path, $recursive=false)

static string	writeFileToTypo3tempDir ($filepath, $content)

static bool	mkdir ($newFolder)

static	mkdir_deep ($directory)

static bool	rmdir ($path, $removeNonEmpty=false)

static bool	flushDirectory ($directory, $keepOriginalDirectory=false, $flushOpcodeCache=false)

static string[] string null	get_dirs ($path)

Public Attributes
const	ENV_TRUSTED_HOSTS_PATTERN_ALLOW_ALL = '.*'

const	ENV_TRUSTED_HOSTS_PATTERN_SERVER_NAME = 'SERVER_NAME'

static if(empty($labels)) if(isset($defaultFormats[$labels]))	else

if($base !==1000 && $base !==1024)	$labelArr = explode('\|', str_replace('"', '', $labels))

	$localeInfo = localeconv()

	$sizeInBytes = max($sizeInBytes, 0)

	$multiplier = floor(($sizeInBytes ? log($sizeInBytes) : 0) / log($base))

	$sizeInUnits = $sizeInBytes / $base ** $multiplier

if($sizeInUnits >($base *.9))	$multiplier = min($multiplier, count($labelArr) - 1)

	$nl = $spaceInd >= 0 ? LF : ''

	$output = ''

foreach($array as $k=> $v) if(! $level) return	$output

Static Public Attributes
static array< string, function explodeUrl2Array( $string) { $output=[];$p=explode('&', $string);foreach( $p as $v) { if( $v !=='') {[ $pK, $pV]=explode('=', $v, 2);$output[rawurldecode( $pK)]=rawurldecode( $pV);} } return $output;} public static array function compileSelectedGetVarsFromArray( $varList, array $getArray, $GPvarAlt=true) { $keys=self::trimExplode(',', $varList, true);$outArr=[];foreach( $keys as $v) { if(isset( $getArray[ $v])) { $outArr[ $v]=$getArray[ $v];} elseif( $GPvarAlt) { $outArr[ $v]=self::_GP( $v);} } return $outArr;} public static array function removeDotsFromTS(array $ts) { $out=[];foreach( $ts as $key=> $value) { if(is_array( $value)) { $key=rtrim( $key, '.');$out[ $key]=self::removeDotsFromTS( $value);} else { $out[ $key]=$value;} } return $out;} public static array< string, function get_tag_attributes( $tag, bool $decodeEntities=false) { $components=self::split_tag_attributes( $tag);$name='';$valuemode=false;$attributes=[];foreach( $components as $key=> $val) { if( $val !=='=') { if( $valuemode) { if( $name) { $attributes[ $name]=$decodeEntities ? htmlspecialchars_decode( $val) :$val;$name='';} } else { if( $key=strtolower(preg_replace('/[^[:alnum:]_\\:\\-]/', '', $val) ?? '')) { $attributes[ $key]='';$name=$key;} } $valuemode=false;} else { $valuemode=true;} } return $attributes;} public static string[] function split_tag_attributes( $tag) { $tag_tmp=trim(preg_replace('/^<[^[:space:]] */', '', trim( $tag)) ?? '');$tag_tmp=trim(rtrim( $tag_tmp, '>'));$value=[];while( $tag_tmp !=='') { $firstChar=$tag_tmp[0];if( $firstChar==='"' \|\| $firstChar === '\'') { $reg = explode($firstChar, $tag_tmp, 3); $value[] = $reg[1]; $tag_tmp = trim($reg[2]); } elseif ($firstChar === '=') { $value[] = '='; $tag_tmp = trim(substr($tag_tmp, 1)); } else { $reg = preg_split('/[[:space:]=]/', $tag_tmp, 2); $value[] = trim($reg[0]); $tag_tmp = trim(substr($tag_tmp, strlen($reg[0]), 1) . ($reg[1] ?? '')); } } reset($value); return $value; } public static string function implodeAttributes(array $arr, $xhtmlSafe = false, $dontOmitBlankAttribs = false) { if ($xhtmlSafe) { $newArr = []; foreach ($arr as $p => $v) { if (!isset($newArr[strtolower($p)])) { $newArr[strtolower($p)] = htmlspecialchars($v); } } $arr = $newArr; } $list = []; foreach ($arr as $p => $v) { if ((string)$v !== '' \|\| $dontOmitBlankAttribs) { $list[] = $p . '="' . $v . '"'; } } return implode(' ', $list); } public static string function wrapJS($string) { if (trim($string)) { $string = ltrim($string, LF); $match = []; if (preg_match('/^(\\t+)/', $string, $match)) { $string = str_replace($match[1], "\t", $string); } return '<script>' . $string . '</script>'; } return ''; } public static mixed function xml2tree($string, $depth = 999, $parserOptions = []) { $previousValueOfEntityLoader = null; if (PHP_MAJOR_VERSION < 8) { $previousValueOfEntityLoader = libxml_disable_entity_loader(true); } $parser = xml_parser_create(); $vals = []; $index = []; xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0); xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 0); foreach ($parserOptions as $option => $value) { xml_parser_set_option($parser, $option, $value); } xml_parse_into_struct($parser, $string, $vals, $index); if (PHP_MAJOR_VERSION < 8) { libxml_disable_entity_loader($previousValueOfEntityLoader); } if (xml_get_error_code($parser)) { return 'Line ' . xml_get_current_line_number($parser) . ': ' . xml_error_string(xml_get_error_code($parser)); } xml_parser_free($parser); $stack = [[]]; $stacktop = 0; $startPoint = 0; $tagi = []; foreach ($vals as $key => $val) { $type = $val['type']; if ($type === 'open' \|\| $type === 'complete') { $stack[$stacktop++] = $tagi; if ($depth == $stacktop) { $startPoint = $key; } $tagi = ['tag' => $val['tag']]; if (isset($val['attributes'])) { $tagi['attrs'] = $val['attributes']; } if (isset($val['value'])) { $tagi['values'][] = $val['value']; } } if ($type === 'complete' \|\| $type === 'close') { $oldtagi = $tagi; $tagi = $stack[--$stacktop]; $oldtag = $oldtagi['tag']; unset($oldtagi['tag']); if ($depth == $stacktop + 1) { if ($key - $startPoint > 0) { $partArray = array_slice($vals, $startPoint + 1, $key - $startPoint - 1); $oldtagi['XMLvalue'] = self::xmlRecompileFromStructValArray($partArray); } else { $oldtagi['XMLvalue'] = $oldtagi['values'][0]; } } $tagi['ch'][$oldtag][] = $oldtagi; unset($oldtagi); } if ($type === 'cdata') { $tagi['values'][] = $val['value']; } } return $tagi['ch']; } public static string function array2xml(array $array, $NSprefix = '', $level = 0, $docTag = 'phparray', $spaceInd = 0, array $options = [], array $stackData = []) { $binaryChars = "\0" . chr(1) . chr(2) . chr(3) . chr(4) . chr(5) . chr(6) . chr(7) . chr(8) . chr(11) . chr(12) . chr(14) . chr(15) . chr(16) . chr(17) . chr(18) . chr(19) . chr(20) . chr(21) . chr(22) . chr(23) . chr(24) . chr(25) . chr(26) . chr(27) . chr(28) . chr(29) . chr(30) . chr(31); $indentChar = $spaceInd ? ' ' : "\t"; $indentN = $spaceInd >	$spaceInd: 1

Static Protected Member Functions
static string	createDirectoryPath ($fullDirectoryPath)

Static Protected Attributes
static bool	$allowHostHeaderValue = false

static ContainerInterface null	$container

Detailed Description

The legendary "t3lib_div" class - Miscellaneous functions for general purpose. Most of the functions do not relate specifically to TYPO3 However a section of functions requires certain TYPO3 features available See comments in the source. You are encouraged to use this library in your own scripts!

USE: All methods in this class are meant to be called statically. So use \TYPO3\CMS\Core\Utility\GeneralUtility::[method-name] to refer to the functions, eg. '\TYPO3\CMS\Core\Utility\GeneralUtility::milliseconds()'

Definition at line 45 of file GeneralUtility.php.

Member Function Documentation

◆ camelCaseToLowerCaseUnderscored()

static string TYPO3\CMS\Core\Utility\GeneralUtility::camelCaseToLowerCaseUnderscored ( $string )

static

Returns a given CamelCasedString as a lowercase string with underscores. Example: Converts BlogExample to blog_example, and minimalValue to minimal_value

Parameters

string $string ‪String to be converted to lowercase underscore

Returns: ‪string lowercase_and_underscored_string

Definition at line 914 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\camelCaseToLowerCaseUnderscored(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\convertPropertyNameToColumnName(), TYPO3\CMS\Install\Controller\SettingsController\featuresGetContentAction(), TYPO3\CMS\Extbase\Mvc\Request\getControllerExtensionKey(), TYPO3\CMS\Backend\Template\Components\Menu\Menu\getDataIdentifier(), TYPO3\CMS\Backend\Utility\BackendUtility\getDropdownMenu(), TYPO3\CMS\Backend\Utility\BackendUtility\getFuncMenu(), TYPO3\CMS\Extbase\Utility\LocalizationUtility\getLanguageFilePath(), TYPO3\CMS\Extbase\Utility\ExtensionUtility\registerPlugin(), TYPO3\CMS\Fluid\ViewHelpers\Uri\ResourceViewHelper\renderStatic(), and TYPO3\CMS\Backend\Controller\BackendController\renderToolbar().

◆ createDirectoryPath()

static string TYPO3\CMS\Core\Utility\GeneralUtility::createDirectoryPath ( $fullDirectoryPath )

staticprotected

Creates directories for the specified paths if they do not exist. This functions sets proper permission mask but does not set proper user and group.

Parameters

string $fullDirectoryPath

Returns: ‪string Path to the the first created directory in the hierarchy

See also: ‪\TYPO3\CMS\Core\Utility\GeneralUtility::mkdir_deep

Exceptions

Definition at line 2048 of file GeneralUtility.php.

References $GLOBALS, and TYPO3\CMS\Core\Utility\GeneralUtility\mkdir().

◆ fixPermissions()

static mixed TYPO3\CMS\Core\Utility\GeneralUtility::fixPermissions	(	$path,
		$recursive = `false`
	)

static

Sets the file system mode and group ownership of a file or a folder.

Parameters

string	$path	‪Path of file or folder, must not be escaped. Path can be absolute or relative
bool	$recursive	‪If set, also fixes permissions of files and folders in the folder (if $path is a folder)

Returns: ‪mixed TRUE on success, FALSE on error, always TRUE on Windows OS

Definition at line 1863 of file GeneralUtility.php.

References $GLOBALS, and TYPO3\CMS\Core\Core\Environment\isWindows().

Referenced by TYPO3\CMS\Core\Locking\FileLockStrategy\acquire(), TYPO3\CMS\Core\Locking\SimpleLockStrategy\acquire(), TYPO3\CMS\Core\Resource\Driver\LocalDriver\addFile(), TYPO3\CMS\Core\Imaging\GraphicalFunctions\combineExec(), TYPO3\CMS\Core\Resource\Driver\LocalDriver\copyFileWithinStorage(), TYPO3\CMS\Core\Resource\Driver\LocalDriver\copyFolderWithinStorage(), TYPO3\CMS\Core\Tests\Unit\Resource\Driver\LocalDriverTest\copyFolderWithinStorageCopiesFileInSingleSubFolderToNewFolderName(), TYPO3\CMS\Core\Resource\Driver\LocalDriver\createFile(), TYPO3\CMS\Install\Service\EnableFileService\createInstallToolEnableFile(), TYPO3\CMS\Core\Mail\MboxTransport\doSend(), TYPO3\CMS\Core\Service\Archive\ZipService\extract(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsCorrectlySetsPermissionsRecursive(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsDoesNotSetPermissionsToNotAllowedPath(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsDefaultPermissionsToDirectory(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsDefaultPermissionsToFile(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsGroup(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsToDirectory(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsToDirectoryWithTrailingSlash(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsToFile(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsToHiddenDirectory(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsToHiddenFile(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsWithRelativeFileReference(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\YouTubeHelper\getPreviewImage(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\VimeoHelper\getPreviewImage(), TYPO3\CMS\Core\Imaging\GraphicalFunctions\gifCompress(), TYPO3\CMS\Core\Imaging\GraphicalFunctions\imageMagickExec(), TYPO3\CMS\Install\Controller\EnvironmentController\imageProcessingTrueTypeAction(), TYPO3\CMS\Core\Imaging\GraphicalFunctions\ImageWrite(), TYPO3\CMS\Core\Imaging\GraphicalFunctions\readPngGif(), TYPO3\CMS\Core\Resource\Driver\LocalDriver\replaceFile(), TYPO3\CMS\Core\Cache\Backend\FileBackend\set(), TYPO3\CMS\Core\Cache\Backend\SimpleFileBackend\set(), TYPO3\CMS\Extensionmanager\Utility\FileHandlingUtility\unzipExtensionFromFile(), TYPO3\CMS\Install\Service\LanguagePackService\unzipTranslationFile(), and TYPO3\CMS\Install\Service\Session\FileSessionHandler\write().

◆ flushDirectory()

static bool TYPO3\CMS\Core\Utility\GeneralUtility::flushDirectory	(	$directory,
		$keepOriginalDirectory = `false`,
		$flushOpcodeCache = `false`
	)

static

Flushes a directory by first moving to a temporary resource, and then triggering the remove process. This way directories can be flushed faster to prevent race conditions on concurrent processes accessing the same directory.

Parameters

string	$directory	‪The directory to be renamed and flushed
bool	$keepOriginalDirectory	‪Whether to only empty the directory and not remove it
bool	$flushOpcodeCache	‪Also flush the opcode cache right after renaming the directory.

Returns: ‪bool Whether the action was successful

Deprecated:: ‪will be removed in TYPO3 v11.0. This is a specific logic needed for the caching framework, and should be implemented where needed directly.

Definition at line 2135 of file GeneralUtility.php.

References TYPO3\CMS\Core\Utility\StringUtility\getUniqueId().

◆ get_dirs()

static string [] string null TYPO3\CMS\Core\Utility\GeneralUtility::get_dirs ( $path )

static

Returns an array with the names of folders in a specific path Will return 'error' (string) if there were an error with reading directory content. Will return null if provided path is false.

Parameters

string $path ‪Path to list directories from

Returns: ‪string[]|string|null Returns an array with the directory entries as values. If no path is provided, the return value will be null.

Definition at line 2170 of file GeneralUtility.php.

References $dir.

Referenced by TYPO3\CMS\IndexedSearch\Hook\CrawlerHook\crawler_execute_type2(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\getDirsReturnsArrayOfDirectoriesFromGivenDirectory(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\getDirsReturnsStringErrorOnPathFailure(), and TYPO3\CMS\Extensionmanager\Utility\DependencyUtility\getExtensionFromInExtensionRepository().

◆ getUrl()

static mixed TYPO3\CMS\Core\Utility\GeneralUtility::getUrl	(		$url,
			$includeHeader = `0`,
			$requestHeaders = `null`,
		&	$report = `null`
	)

static

Reads the file or url $url and returns the content If you are having trouble with proxies when reading URLs you can configure your way out of that with settings within $GLOBALS['TYPO3_CONF_VARS']['HTTP'].

Parameters

string	$url	‪File/URL to read
int	$includeHeader	‪Whether the HTTP header should be fetched or not. 0=disable, 1=fetch header+content, 2=fetch header only - deprecated and will be removed in TYPO3 v11.
array	$requestHeaders	‪HTTP headers to be used in the request - deprecated and will be removed in TYPO3 v11.
array	$report	‪Error code/message and, if $includeHeader is 1, response meta data (HTTP status and content type) - deprecated and will be removed in TYPO3 v11.

Returns: ‪mixed The content from the resource given as input. FALSE if an error has occurred.

Definition at line 1748 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Extensionmanager\Utility\UpdateScriptUtility\determineUpdateClassName(), TYPO3\CMS\Install\Service\CoreUpdateService\downloadVersion(), TYPO3\CMS\Extensionmanager\Utility\Connection\TerUtility\fetchExtension(), TYPO3\CMS\Extensionmanager\Utility\Repository\Helper\fetchFile(), TYPO3\CMS\Install\Updates\AbstractDownloadExtensionUpdate\fetchUrl(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOEmbedHelper\getOEmbedData(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\YouTubeHelper\getPreviewImage(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\VimeoHelper\getPreviewImage(), TYPO3\CMS\Dashboard\Widgets\RssWidget\getRssItems(), TYPO3\CMS\IndexedSearch\Indexer\indexExternalUrl(), TYPO3\CMS\Extensionmanager\Utility\Repository\Helper\isExtListUpdateNecessary(), TYPO3\CMS\IndexedSearch\FileContentParser\readFileContent(), TYPO3\CMS\Core\Resource\ResourceCompressor\retrieveExternalFile(), and TYPO3\CMS\Core\Tests\UnitDeprecated\Utility\GeneralUtilityTest\splitHeaderLines().

◆ idnaEncode()

static string TYPO3\CMS\Core\Utility\GeneralUtility::idnaEncode ( $value )

static

Returns an ASCII string (punicode) representation of $value

Parameters

string $value

Returns: ‪string An ASCII encoded (punicode) string

Deprecated:: ‪since TYPO3 v10.0, will be removed in TYPO3 v11.0, use PHP's native idn_to_ascii($domain, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46) function directly.

Definition at line 863 of file GeneralUtility.php.

References TYPO3\CMS\Core\Utility\HttpUtility\idn_to_ascii().

Referenced by TYPO3\CMS\Core\Tests\UnitDeprecated\Utility\GeneralUtilityTest\idnaEncodeConvertsUnicodeCharsToASCIIString().

◆ implodeArrayForUrl()

static string TYPO3\CMS\Core\Utility\GeneralUtility::implodeArrayForUrl	(		$name,
		array	$theArray,
			$str = `''`,
			$skipBlank = `false`,
			$rawurlencodeParamName = `false`
	)

static

Implodes a multidim-array into GET-parameters (eg. &param[key][key2]=value2&param[key][key3]=value3)

Parameters

string	$name	‪Name prefix for entries. Set to blank if you wish none.
array	$theArray	‪The (multidimensional) array to implode
string	$str	‪(keep blank)
bool	$skipBlank	‪If set, parameters which were blank strings would be removed.
bool	$rawurlencodeParamName	‪If set, the param name itself (for example "param[key][key2]") would be rawurlencoded as well.

Returns: ‪string Imploded result, fx. &param[key][key2]=value2&param[key][key3]=value3

See also: ‪explodeUrl2Array()

Definition at line 1097 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\implodeArrayForUrlBuildsValidParameterString(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\implodeArrayForUrlCanSkipEmptyParameters(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\implodeArrayForUrlCanUrlEncodeKeyNames().

◆ intExplode()

static int [] TYPO3\CMS\Core\Utility\GeneralUtility::intExplode	(	$delimiter,
		$string,
		$removeEmptyValues = `false`,
		$limit = `0`
	)

static

Explodes a $string delimited by $delimiter and casts each item in the array to (int). Corresponds to \TYPO3\CMS\Core\Utility\GeneralUtility::trimExplode(), but with conversion to integers for all values.

Parameters

string	$delimiter	‪Delimiter string to explode with
string	$string	‪The string to explode
bool	$removeEmptyValues	‪If set, all empty values (='') will NOT be set in output
int	$limit	‪If positive, the result will contain a maximum of limit elements,

Returns: ‪int[] Exploded values, all converted to integers

Definition at line 988 of file GeneralUtility.php.

◆ isValid()

static array<int, splitCalc($string, $operators) { $res = []; $sign = '+'; while ($string) { $valueLen = strcspn($string, $operators); $value = substr($string, 0, $valueLen); $res[] = [$sign, trim($value)]; $sign = substr($string, $valueLen, 1); $string = substr($string, $valueLen + 1); } reset($res); return $res; } public static bool function validEmail($email) { if (!is_string($email)) { return false; } if (trim($email) !== $email) { return false; } if (strpos($email, '@') === false) { return false; } $validator = new EmailValidator(); return $validator-> TYPO3\CMS\Core\Utility\GeneralUtility::isValid	(		$email,
		new	RFCValidation()
	)

static

This splits a string by the chars in $operators (typical /+-*) and returns an array with them in

Parameters

string $string ‪Input string, eg "123 + 456 / 789 - 4 @param string $operators Operators to split by, typically "/+-*

Returns: ‪array<int, array<int, string>> Array with operators and operands separated.

See also: ‪\TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer::calc(); ‪\TYPO3\CMS\Frontend\Imaging\GifBuilder::calcOffset()

◆ isValidUrl()

static bool TYPO3\CMS\Core\Utility\GeneralUtility::isValidUrl ( $url )

static

Checks if a given string is a Uniform Resource Locator (URL).

On seriously malformed URLs, parse_url may return FALSE and emit an E_WARNING.

filter_var() requires a scheme to be present.

http://www.faqs.org/rfcs/rfc2396.html Scheme names consist of a sequence of characters beginning with a lower case letter and followed by any combination of lower case letters, digits, plus ("+"), period ("."), or hyphen ("-"). For resiliency, programs interpreting URI should treat upper case letters as equivalent to lower case in scheme names (e.g., allow "HTTP" as well as "http"). scheme = alpha *( alpha | digit | "+" | "-" | "." )

Convert the domain part to punicode if it does not look like a regular domain name. Only the domain part because RFC3986 specifies the the rest of the url may not contain special characters: https://tools.ietf.org/html/rfc3986#appendix-A

Parameters

string $url ‪The URL to be validated

Returns: ‪bool Whether the given URL is valid

Definition at line 944 of file GeneralUtility.php.

References TYPO3\CMS\Core\Utility\HttpUtility\buildUrl(), and TYPO3\CMS\Core\Utility\HttpUtility\idn_to_ascii().

Referenced by TYPO3\CMS\Core\Html\DefaultSanitizerBuilder\__construct(), TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile(), TYPO3\CMS\Backend\Command\ResetPasswordCommand\execute(), TYPO3\CMS\Core\Resource\ResourceStorage\getPublicUrl(), TYPO3\CMS\Core\Tests\Unit\Resource\Driver\LocalDriverTest\getPublicUrlReturnsValidUrlContainingSpecialCharacters(), TYPO3\CMS\Backend\Backend\Avatar\Image\getUrl(), TYPO3\CMS\FrontendLogin\Validation\RedirectUrlValidator\isInLocalDomain(), TYPO3\CMS\Extbase\Validation\Validator\UrlValidator\isValid(), TYPO3\CMS\Extensionmanager\Domain\Model\Repository\setMirrorListUrl(), TYPO3\CMS\Extensionmanager\Domain\Model\Repository\setWsdlUrl(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\validURLReturnsFalseForInvalidResource(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\validURLReturnsTrueForValidResource().

◆ minifyJavaScript()

static string TYPO3\CMS\Core\Utility\GeneralUtility::minifyJavaScript	(		$script,
		&	$error = `''`
	)

static

Minifies JavaScript

Parameters

string	$script	‪Script to minify
string	$error	‪Error message (if any)

Returns: ‪string Minified script or source string if error happened

Definition at line 1713 of file GeneralUtility.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\Page\PageRenderer\doCompressJavaScript(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\minifyJavaScriptReturnsInputStringIfNoHookIsRegistered(), and TYPO3\CMS\Frontend\Http\RequestHandler\processHtmlBasedRenderingSettings().

◆ mkdir()

static bool TYPO3\CMS\Core\Utility\GeneralUtility::mkdir ( $newFolder )

static

Wrapper function for mkdir. Sets folder permissions according to $GLOBALS['TYPO3_CONF_VARS']['SYS']['folderCreateMask'] and group ownership according to $GLOBALS['TYPO3_CONF_VARS']['SYS']['createGroup']

Parameters

string $newFolder ‪Absolute path to folder, see PHP mkdir() function. Removes trailing slash internally.

Returns: ‪bool TRUE if operation was successful

Definition at line 2005 of file GeneralUtility.php.

References $GLOBALS.

◆ mkdir_deep()

static TYPO3\CMS\Core\Utility\GeneralUtility::mkdir_deep ( $directory )

static

Creates a directory - including parent directories if necessary and sets permissions on newly created directories.

Parameters

string $directory ‪Target directory to create. Must a have trailing slash

Exceptions

Definition at line 2022 of file GeneralUtility.php.

◆ revExplode()

static string [] TYPO3\CMS\Core\Utility\GeneralUtility::revExplode	(	$delimiter,
		$string,
		$count = `0`
	)

static

Reverse explode which explodes the string counting from behind.

Note: The delimiter has to given in the reverse order as it is occurring within the string.

GeneralUtility::revExplode('[]', '[my][words][here]', 2) ==> array('[my][words', 'here]')

Parameters

string	$delimiter	‪Delimiter string to explode with
string	$string	‪The string to explode
int	$count	‪Number of array entries

Returns: ‪string[] Exploded values

Definition at line 1025 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Backend\Tree\View\FolderTreeView\evaluateExpandCollapseParameter(), TYPO3\CMS\Core\Resource\Filter\FileExtensionFilter\filterInlineChildren(), TYPO3\CMS\IndexedSearch\Domain\Repository\IndexSearchRepository\freeIndexUidWhere(), TYPO3\CMS\Core\Localization\Parser\AbstractXmlParser\getLocalizedFileName(), TYPO3\CMS\Core\Core\SystemEnvironmentBuilder\getRootPathFromScriptPath(), TYPO3\CMS\Backend\Controller\Wizard\EditController\processRequest(), TYPO3\CMS\Backend\Form\Element\InputSlugElement\render(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\revExplodeCorrectlyExplodesStringForGivenPartsCount(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\revExplodeRespectsLimitThreeWhenExploding().

◆ rmdir()

static bool TYPO3\CMS\Core\Utility\GeneralUtility::rmdir	(	$path,
		$removeNonEmpty = `false`
	)

static

Wrapper function for rmdir, allowing recursive deletion of folders and files

Parameters

string	$path	‪Absolute path to folder, see PHP rmdir() function. Removes trailing slash internally.
bool	$removeNonEmpty	‪Allow deletion of non-empty directories

Returns: ‪bool TRUE if operation was successful

Definition at line 2075 of file GeneralUtility.php.

◆ trimExplode()

static string [] TYPO3\CMS\Core\Utility\GeneralUtility::trimExplode	(	$delim,
		$string,
		$removeEmptyValues = `false`,
		$limit = `0`
	)

static

Explodes a string and removes whitespace-only values.

If $removeEmptyValues is set, then all values that contain only whitespace are removed.

Each item will have leading and trailing whitespace removed. However, if the tail items are returned as a single array item, their internal whitespace will not be modified.

Parameters

string	$delim	‪Delimiter string to explode with
string	$string	‪The string to explode
bool	$removeEmptyValues	‪If set, all empty values will be removed in output
int	$limit	‪If limit is set and positive, the returned array will contain a maximum of limit elements with the last element containing the rest of string. If the limit parameter is negative, all components except the last -limit are returned.

Returns: ‪string[] Exploded values

Definition at line 1059 of file GeneralUtility.php.

◆ underscoredToLowerCamelCase()

static string TYPO3\CMS\Core\Utility\GeneralUtility::underscoredToLowerCamelCase ( $string )

static

Returns a given string with underscores as lowerCamelCase. Example: Converts minimal_value to minimalValue

Parameters

string $string ‪String to be converted to camel case

Returns: ‪string lowerCamelCasedWord

Definition at line 902 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapFactory\buildDataMapInternal(), TYPO3\CMS\Backend\Controller\BackendController\renderToolbar(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\underscoredToLowerCamelCase().

◆ underscoredToUpperCamelCase()

static string TYPO3\CMS\Core\Utility\GeneralUtility::underscoredToUpperCamelCase ( $string )

static

Returns a given string with underscores as UpperCamelCase. Example: Converts blog_example to BlogExample

Parameters

string $string ‪String to be converted to camel case

Returns: ‪string UpperCamelCasedWord

Definition at line 890 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Page\PageRenderer\computeRequireJsConfig(), TYPO3\CMS\Extbase\Utility\ExtensionUtility\registerModule(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\underscoredToUpperCamelCase().

◆ writeFile()

static bool TYPO3\CMS\Core\Utility\GeneralUtility::writeFile	(	$file,
		$content,
		$changePermissions = `false`
	)

static

Writes $content to the file $file

Parameters

string	$file	‪Filepath to write to
string	$content	‪Content to write
bool	$changePermissions	‪If TRUE, permissions are forced to be set

Returns: ‪bool TRUE if the file was successfully opened and written to.

Definition at line 1836 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Resource\ResourceCompressor\__construct(), TYPO3\CMS\Core\Log\Writer\FileWriter\createHtaccessFile(), TYPO3\CMS\Core\Log\Writer\FileWriter\createLogFile(), TYPO3\CMS\Core\Resource\ResourceCompressor\createMergedFile(), TYPO3\CMS\Core\Core\ClassLoadingInformation\dumpClassLoadingInformation(), TYPO3\CMS\Install\Service\Session\FileSessionHandler\ensureSessionSavePathExists(), TYPO3\CMS\Backend\Command\LockBackendCommand\execute(), TYPO3\CMS\Impexp\Controller\ExportController\exportData(), TYPO3\CMS\Impexp\Import\import_addFileNameToBeCopied(), TYPO3\CMS\IndexedSearch\Indexer\indexExternalUrl(), TYPO3\CMS\Impexp\Import\processSoftReferences_saveFile_createRelFile(), TYPO3\CMS\Core\Tests\Unit\Configuration\SiteConfigurationTest\resolveAllExistingSitesReadsConfiguration(), TYPO3\CMS\Core\Resource\ResourceCompressor\retrieveExternalFile(), TYPO3\CMS\Frontend\Tests\Functional\Rendering\TitleTagRenderingTest\setUpFrontendSite(), TYPO3\CMS\Core\Tests\Functional\DataHandling\AbstractDataHandlerActionTestCase\setUpFrontendSite(), TYPO3\CMS\Core\Configuration\SiteConfiguration\write(), TYPO3\CMS\Extensionmanager\Utility\FileHandlingUtility\writeEmConfToFile(), TYPO3\CMS\Extensionmanager\Utility\FileHandlingUtility\writeExtensionFiles(), TYPO3\CMS\Core\Resource\ResourceCompressor\writeFileAndCompressed(), TYPO3\CMS\Impexp\Import\writeFileVerify(), and TYPO3\CMS\Impexp\Import\writeTemporaryFileFromData().

◆ writeFileToTypo3tempDir()

static string TYPO3\CMS\Core\Utility\GeneralUtility::writeFileToTypo3tempDir	(	$filepath,
		$content
	)

static

Writes $content to a filename in the typo3temp/ folder (and possibly one or two subfolders...) Accepts an additional subdirectory in the file path!

Parameters

string	$filepath	‪Absolute file path to write within the typo3temp/ or Environment::getVarPath() folder - the file path must be prefixed with this path
string	$content	‪Content string to write

Returns: ‪string Returns NULL on success, otherwise an error string telling about the problem.

Reimplemented in TYPO3\CMS\Core\Tests\Unit\Utility\Fixtures\GeneralUtilityFilesystemFixture.

Definition at line 1928 of file GeneralUtility.php.

References TYPO3\CMS\Core\Core\Environment\getProjectPath(), TYPO3\CMS\Core\Core\Environment\getPublicPath(), and TYPO3\CMS\Core\Core\Environment\getVarPath().

Referenced by TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\copyDirectoryCopiesFilesAndDirectoriesWithAbsolutePaths(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\copyDirectoryCopiesFilesAndDirectoriesWithRelativePaths(), TYPO3\CMS\Core\Resource\OnlineMedia\Helpers\AbstractOnlineMediaHelper\createNewFile(), TYPO3\CMS\Extensionmanager\Utility\UpdateScriptUtility\determineUpdateClassName(), TYPO3\CMS\Extensionmanager\Utility\Repository\Helper\fetchFile(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\fixPermissionsSetsPermissionsWithRelativeFileReference(), TYPO3\CMS\Core\Tests\UnitDeprecated\Localization\LocalizationFactoryTest\getParsedDataHandlesLocallangXMLOverride(), TYPO3\CMS\Core\Charset\CharsetConverter\initCharset(), TYPO3\CMS\Core\Charset\CharsetConverter\initToASCII(), TYPO3\CMS\Core\Charset\CharsetConverter\initUnicodeData(), TYPO3\CMS\Install\Service\LanguagePackService\languagePackDownload(), TYPO3\CMS\Core\Tests\Unit\Resource\ResourceFactoryTest\retrieveFileOrFolderObjectReturnsFileIfPathIsGiven(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\writeFileToTypo3tempDirFailsWithInvalidPath(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\writeFileToTypo3tempDirWorksWithValidPath().

◆ xml2array()

static mixed TYPO3\CMS\Core\Utility\GeneralUtility::xml2array	(	$string,
		$NSprefix = `''`,
		$reportDocTag = `false`
	)

static

Converts an XML string to a PHP array. This is the reverse function of array2xml() This is a wrapper for xml2arrayProcess that adds a two-level cache

Parameters

string	$string	‪XML content to convert into an array
string	$NSprefix	‪The tag-prefix resolve, eg. a namespace like "T3:"
bool	$reportDocTag	‪If set, the document tag will be set in the key "_DOCUMENT_TAG" of the output array

Returns: ‪mixed If the parsing had errors, a string with the error message is returned. Otherwise an array with the content.

See also: ‪array2xml(); ‪xml2arrayProcess()

Definition at line 1531 of file GeneralUtility.php.

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

Referenced by TYPO3\CMS\Core\DataHandling\DataHandler\checkValueForFlex(), TYPO3\CMS\Core\Service\FlexFormService\convertFlexFormContentToArray(), TYPO3\CMS\Core\DataHandling\DataHandler\copyRecord_procBasedOnFieldType(), TYPO3\CMS\Form\Hooks\FormFileExtensionUpdate\enrichFormDefinitionsInformationWithDataFromReferences(), TYPO3\CMS\Backend\Controller\Wizard\TableController\getConfiguration(), TYPO3\CMS\Form\Hooks\DataStructureIdentifierHook\getDataStructureIdentifierPostProcess(), TYPO3\CMS\Core\Database\ReferenceIndex\getRelations(), TYPO3\CMS\Backend\Form\FormDataProvider\TcaFlexPrepare\initializeDataValues(), TYPO3\CMS\Impexp\Import\loadFile(), TYPO3\CMS\Form\Controller\FormFrontendController\overrideByFlexFormSettings(), TYPO3\CMS\Core\Configuration\FlexForm\FlexFormTools\parseDataStructureByIdentifier(), TYPO3\CMS\Frontend\Plugin\AbstractPlugin\pi_initPIflexForm(), TYPO3\CMS\Impexp\Import\processSoftReferences(), TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer\readFlexformIntoConf(), TYPO3\CMS\Core\DataHandling\DataHandler\remapListedDBRecords(), TYPO3\CMS\Form\Tests\Functional\Hooks\FormFileExtensionUpdateTest\retrieveAllFlexForms(), TYPO3\CMS\Impexp\Import\setFlexFormRelations(), TYPO3\CMS\Core\Configuration\FlexForm\FlexFormTools\traverseFlexFormXMLData(), TYPO3\CMS\Core\DataHandling\DataHandler\updateFlexFormData(), TYPO3\CMS\Core\DataHandling\DataHandler\version_remapMMForVersionSwap(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2ArrayFailsWithXmlContentBiggerThanTenMegabytes(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2arrayUsesCache().

◆ xml2arrayProcess()

static mixed TYPO3\CMS\Core\Utility\GeneralUtility::xml2arrayProcess	(	$string,
		$NSprefix = `''`,
		$reportDocTag = `false`
	)

static

Converts an XML string to a PHP array. This is the reverse function of array2xml()

Parameters

string	$string	‪XML content to convert into an array
string	$NSprefix	‪The tag-prefix resolve, eg. a namespace like "T3:"
bool	$reportDocTag	‪If set, the document tag will be set in the key "_DOCUMENT_TAG" of the output array

Returns: ‪mixed If the parsing had errors, a string with the error message is returned. Otherwise an array with the content.

See also: ‪array2xml()

Definition at line 1554 of file GeneralUtility.php.

References $parser, and TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger().

Referenced by TYPO3\CMS\Core\Utility\GeneralUtility\xml2array(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2ArrayProcessHandlesAttributeTypes(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2ArrayProcessHandlesBigXmlContent(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2arrayProcessHandlesDocumentTag(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2arrayProcessHandlesTagNamespaces(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\xml2arrayProcessHandlesWhitespaces().

◆ xmlRecompileFromStructValArray()

static string TYPO3\CMS\Core\Utility\GeneralUtility::xmlRecompileFromStructValArray ( array $vals )

static

This implodes an array of XML parts (made with xml_parse_into_struct()) into XML again.

Parameters

array<int,array<string,mixed>> ‪$vals An array of XML parts, see xml2tree

Returns: ‪string Re-compiled XML data.

Definition at line 1668 of file GeneralUtility.php.

Member Data Documentation

◆ $allowHostHeaderValue

bool TYPO3\CMS\Core\Utility\GeneralUtility::$allowHostHeaderValue = false

staticprotected

State of host header value security check in order to avoid unnecessary multiple checks during one request

Definition at line 55 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Tests\Unit\Utility\Fixtures\GeneralUtilityFixture\setAllowHostHeaderValue().

◆ $container

ContainerInterface null TYPO3\CMS\Core\Utility\GeneralUtility::$container

staticprotected

Definition at line 59 of file GeneralUtility.php.

◆ $labelArr

if ( $base !==1000 &&$base !==1024) TYPO3\CMS\Core\Utility\GeneralUtility::$labelArr = explode('|', str_replace('"', '', $labels))

Definition at line 795 of file GeneralUtility.php.

◆ $localeInfo

TYPO3\CMS\Core\Utility\GeneralUtility::$localeInfo = localeconv()

Definition at line 798 of file GeneralUtility.php.

◆ $multiplier [1/2]

TYPO3\CMS\Core\Utility\GeneralUtility::$multiplier = floor(($sizeInBytes ? log($sizeInBytes) : 0) / log($base))

Definition at line 800 of file GeneralUtility.php.

◆ $multiplier [2/2]

if ( $sizeInUnits >( $base *.9)) TYPO3\CMS\Core\Utility\GeneralUtility::$multiplier = min($multiplier, count($labelArr) - 1)

Definition at line 805 of file GeneralUtility.php.

◆ $nl

TYPO3\CMS\Core\Utility\GeneralUtility::$nl = $spaceInd >= 0 ? LF : ''

Definition at line 1420 of file GeneralUtility.php.

◆ $output [1/2]

TYPO3\CMS\Core\Utility\GeneralUtility::$output = ''

Definition at line 1422 of file GeneralUtility.php.

◆ $output [2/2]

foreach ( $array as $k=> $v) if (! $level) return TYPO3\CMS\Core\Utility\GeneralUtility::$output

Definition at line 1516 of file GeneralUtility.php.

◆ $sizeInBytes

TYPO3\CMS\Core\Utility\GeneralUtility::$sizeInBytes = max($sizeInBytes, 0)

Definition at line 799 of file GeneralUtility.php.

◆ $sizeInUnits

TYPO3\CMS\Core\Utility\GeneralUtility::$sizeInUnits = $sizeInBytes / $base ** $multiplier

Definition at line 801 of file GeneralUtility.php.

◆ $spaceInd

array<string, function explodeUrl2Array($string) { $output = []; $p = explode('&', $string); foreach ($p as $v) { if ($v !== '') { [$pK, $pV] = explode('=', $v, 2); $output[rawurldecode($pK)] = rawurldecode($pV); } } return $output; } public static array function compileSelectedGetVarsFromArray($varList, array $getArray, $GPvarAlt = true) { $keys = self::trimExplode(',', $varList, true); $outArr = []; foreach ($keys as $v) { if (isset($getArray[$v])) { $outArr[$v] = $getArray[$v]; } elseif ($GPvarAlt) { $outArr[$v] = self::_GP($v); } } return $outArr; } public static array function removeDotsFromTS(array $ts) { $out = []; foreach ($ts as $key => $value) { if (is_array($value)) { $key = rtrim($key, '.'); $out[$key] = self::removeDotsFromTS($value); } else { $out[$key] = $value; } } return $out; } public static array<string, function get_tag_attributes($tag, bool $decodeEntities = false) { $components = self::split_tag_attributes($tag); $name = ''; $valuemode = false; $attributes = []; foreach ($components as $key => $val) { if ($val !== '=') { if ($valuemode) { if ($name) { $attributes[$name] = $decodeEntities ? htmlspecialchars_decode($val) : $val; $name = ''; } } else { if ($key = strtolower(preg_replace('/[^[:alnum:]_\\:\\-]/', '', $val) ?? '')) { $attributes[$key] = ''; $name = $key; } } $valuemode = false; } else { $valuemode = true; } } return $attributes; } public static string[] function split_tag_attributes($tag) { $tag_tmp = trim(preg_replace('/^<[^[:space:]]*/', '', trim($tag)) ?? ''); $tag_tmp = trim(rtrim($tag_tmp, '>')); $value = []; while ($tag_tmp !== '') { $firstChar = $tag_tmp[0]; if ($firstChar === '"' || $firstChar === '\'') { $reg = explode($firstChar, $tag_tmp, 3); $value[] = $reg[1]; $tag_tmp = trim($reg[2]); } elseif ($firstChar === '=') { $value[] = '='; $tag_tmp = trim(substr($tag_tmp, 1)); } else { $reg = preg_split('/[[:space:]=]/', $tag_tmp, 2); $value[] = trim($reg[0]); $tag_tmp = trim(substr($tag_tmp, strlen($reg[0]), 1) . ($reg[1] ?? '')); } } reset($value); return $value; } public static string function implodeAttributes(array $arr, $xhtmlSafe = false, $dontOmitBlankAttribs = false) { if ($xhtmlSafe) { $newArr = []; foreach ($arr as $p => $v) { if (!isset($newArr[strtolower($p)])) { $newArr[strtolower($p)] = htmlspecialchars($v); } } $arr = $newArr; } $list = []; foreach ($arr as $p => $v) { if ((string)$v !== '' || $dontOmitBlankAttribs) { $list[] = $p . '="' . $v . '"'; } } return implode(' ', $list); } public static string function wrapJS($string) { if (trim($string)) { $string = ltrim($string, LF); $match = []; if (preg_match('/^(\\t+)/', $string, $match)) { $string = str_replace($match[1], "\t", $string); } return '<script>' . $string . '</script>'; } return ''; } public static mixed function xml2tree($string, $depth = 999, $parserOptions = []) { $previousValueOfEntityLoader = null; if (PHP_MAJOR_VERSION < 8) { $previousValueOfEntityLoader = libxml_disable_entity_loader(true); } $parser = xml_parser_create(); $vals = []; $index = []; xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0); xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 0); foreach ($parserOptions as $option => $value) { xml_parser_set_option($parser, $option, $value); } xml_parse_into_struct($parser, $string, $vals, $index); if (PHP_MAJOR_VERSION < 8) { libxml_disable_entity_loader($previousValueOfEntityLoader); } if (xml_get_error_code($parser)) { return 'Line ' . xml_get_current_line_number($parser) . ': ' . xml_error_string(xml_get_error_code($parser)); } xml_parser_free($parser); $stack = [[]]; $stacktop = 0; $startPoint = 0; $tagi = []; foreach ($vals as $key => $val) { $type = $val['type']; if ($type === 'open' || $type === 'complete') { $stack[$stacktop++] = $tagi; if ($depth == $stacktop) { $startPoint = $key; } $tagi = ['tag' => $val['tag']]; if (isset($val['attributes'])) { $tagi['attrs'] = $val['attributes']; } if (isset($val['value'])) { $tagi['values'][] = $val['value']; } } if ($type === 'complete' || $type === 'close') { $oldtagi = $tagi; $tagi = $stack[--$stacktop]; $oldtag = $oldtagi['tag']; unset($oldtagi['tag']); if ($depth == $stacktop + 1) { if ($key - $startPoint > 0) { $partArray = array_slice($vals, $startPoint + 1, $key - $startPoint - 1); $oldtagi['XMLvalue'] = self::xmlRecompileFromStructValArray($partArray); } else { $oldtagi['XMLvalue'] = $oldtagi['values'][0]; } } $tagi['ch'][$oldtag][] = $oldtagi; unset($oldtagi); } if ($type === 'cdata') { $tagi['values'][] = $val['value']; } } return $tagi['ch']; } public static string function array2xml(array $array, $NSprefix = '', $level = 0, $docTag = 'phparray', $spaceInd = 0, array $options = [], array $stackData = []) { $binaryChars = "\0" . chr(1) . chr(2) . chr(3) . chr(4) . chr(5) . chr(6) . chr(7) . chr(8) . chr(11) . chr(12) . chr(14) . chr(15) . chr(16) . chr(17) . chr(18) . chr(19) . chr(20) . chr(21) . chr(22) . chr(23) . chr(24) . chr(25) . chr(26) . chr(27) . chr(28) . chr(29) . chr(30) . chr(31); $indentChar = $spaceInd ? ' ' : "\t"; $indentN = $spaceInd > TYPO3\CMS\Core\Utility\GeneralUtility::$spaceInd

static

Explodes a string with GETvars (eg. "&id=1&type=2&ext[mykey]=3") into an array.

Note! If you want to use a multi-dimensional string, consider this plain simple PHP code instead:

$result = []; parse_str($queryParametersAsString, $result);

However, if you do magic with a flat structure (e.g. keeping "ext[mykey]" as flat key in a one-dimensional array) then this method is for you.

Parameters

string $string ‪GETvars string

Returns: ‪array<string, string> Array of values. All values AND keys are rawurldecoded() as they properly should be. But this means that any implosion of the array again must rawurlencode it!

See also: ‪implodeArrayForUrl()

Definition at line 1419 of file GeneralUtility.php.

◆ else

if (empty( $labels)) if (isset( $defaultFormats[ $labels])) TYPO3\CMS\Core\Utility\GeneralUtility::else

Initial value:

{

$base = (int)$base

Definition at line 790 of file GeneralUtility.php.

◆ ENV_TRUSTED_HOSTS_PATTERN_ALLOW_ALL

const TYPO3\CMS\Core\Utility\GeneralUtility::ENV_TRUSTED_HOSTS_PATTERN_ALLOW_ALL = '.*'

Definition at line 47 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Install\SystemEnvironment\SetupCheck\checkTrustedHostPattern(), TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\getIndpEnvForHostAllowsAllHostnameValuesIfHostPatternIsSetToAllowAll(), TYPO3\CMS\Reports\Report\Status\SecurityStatus\getTrustedHostsPatternStatus(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\setUp().

◆ ENV_TRUSTED_HOSTS_PATTERN_SERVER_NAME

const TYPO3\CMS\Core\Utility\GeneralUtility::ENV_TRUSTED_HOSTS_PATTERN_SERVER_NAME = 'SERVER_NAME'

Definition at line 48 of file GeneralUtility.php.

Referenced by TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\isAllowedHostHeaderValueWorksCorrectlyWithWithServerNamePattern(), and TYPO3\CMS\Core\Tests\Unit\Utility\GeneralUtilityTest\isAllowedHostHeaderValueWorksCorrectlyWithWithServerNamePatternAndSslProxy().

Static Public Member Functions

Public Attributes

Static Public Attributes

Static Protected Member Functions

Static Protected Attributes

Detailed Description

Member Function Documentation

◆ camelCaseToLowerCaseUnderscored()

◆ createDirectoryPath()

◆ fixPermissions()

◆ flushDirectory()

◆ get_dirs()

◆ getUrl()

◆ idnaEncode()

◆ implodeArrayForUrl()

◆ intExplode()

◆ isValid()

◆ isValidUrl()

◆ minifyJavaScript()

◆ mkdir()

◆ mkdir_deep()

◆ revExplode()

◆ rmdir()

◆ trimExplode()

◆ underscoredToLowerCamelCase()

◆ underscoredToUpperCamelCase()

◆ writeFile()

◆ writeFileToTypo3tempDir()

◆ xml2array()

◆ xml2arrayProcess()

◆ xmlRecompileFromStructValArray()

Member Data Documentation

◆ $allowHostHeaderValue

◆ $container

◆ $labelArr

◆ $localeInfo

◆ $multiplier [1/2]

◆ $multiplier [2/2]

◆ $nl

◆ $output [1/2]

◆ $output [2/2]

◆ $sizeInBytes

◆ $sizeInUnits

◆ $spaceInd

◆ else

◆ ENV_TRUSTED_HOSTS_PATTERN_ALLOW_ALL

◆ ENV_TRUSTED_HOSTS_PATTERN_SERVER_NAME