GeneralUtility
Die GeneralUtility Klasse bringt diverse statische Methoden mit, um z.B. temporäre Dateien zuschreiben, um $_GET Parameter auszulesen, XML Strukturen in ein Array umzuwandeln, Pfade auf Gültigkeit zu prüfen, EXT: aufzulösen und vieles mehr.
_GP()
TYPO3 3.6 TYPO3 12.3 TYPO3 13.0
Liest den angeforderten Parameter aus dem globalen Array $_GET aus. Falls der geforderte Parameter auch in dem globalen Array $_POST vorhanden ist, so wird der Parameter von $_POST zurückgeliefert.
Vorzugsweise sollte die Methode nur für einfache Parameter wie &id=3 verwendet werden. Nicht jedoch für Arrays wie tx_ext[prod]=5. Ja, es geht auch mit Arrays, aber dafür sollte GPmerged() verwendet werden.
URL: example.com/produkte/waschgel.html?size=XXL
Veraltet. Bitte verwendet den TYPO3 Request:
<?php
declare(strict_types=1);
namespace StefanFroemken\Sfproducts\UserFunc;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Core\Http\HtmlResponse;
use TYPO3\CMS\Core\Utility\ArrayUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
class TestGeneralUtility
{
public function test(ServerRequestInterface $request): ResponseInterface
{
$value = $request->getParsedBody()['tx_scheduler'] ?? $request->getQueryParams()['tx_scheduler'] ?? null;
return new HtmlResponse($value);
}
}Ausgabe: XXL
Wenn ihr schon wisst in welchem Array sich Eure Variable befindet, dann verwendet bitte bevorzugt direkt die Methoden _GET() oder _POST() aus GeneralUtility.
_GPmerged()
TYPO3 3.6 TYPO3 12.2 TYPO3 13.0
Liest den angeforderten Parameter aus dem globalen Array $_GET aus. Falls der geforderte Parameter auch in dem globalen Array $_POST vorhanden ist, so wird der Parameter von $_POST zurückgeliefert. Bitte beachtet, dass es sich bei dem angeforderten Parameter um ein Array handeln muss.
URL: example.com/produkte/waschgel.html?tx_sfproducts_show[product]=16
Veraltet. Bitte verwendet den TYPO3 Request:
<?php
declare(strict_types=1);
namespace StefanFroemken\Sfproducts\UserFunc;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Core\Http\JsonResponse;
use TYPO3\CMS\Core\Utility\ArrayUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
class TestGeneralUtility
{
public function test(ServerRequestInterface $request): ResponseInterface
{
$getMergedWithPost = $request->getQueryParams()['tx_sfproducts_show'];
ArrayUtility::mergeRecursiveWithOverrule($getMergedWithPost, $request->getParsedBody()['tx_sfproducts_show']);
return new JsonResponse($getMergedWithPost);
}
}Ausgabe:
{"product":13}_GET()
TYPO3 3.6 TYPO3 12.4 TYPO3 13.0
Ohne mitgelieferten Argument liefert _GET() alle Parameter von dem globalen Array $_GET zurück. Mit übergebenen Argument wird nur der gewünschte Parameter aus dem $_GET Array zurückgegeben. Parameter, die kein Array sind, werden sicherheitshalber in Strings konvertiert. In früheren TYPO3 Versionen beinhaltete _GET() noch Logik für Magic Quotes, welche mit PHP 5.5 obsolet wurden.
Veraltet. Bitte verwendet den TYPO3 Request:
<?php
declare(strict_types=1);
namespace StefanFroemken\Sfproducts\UserFunc;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Core\Http\HtmlResponse;
use TYPO3\CMS\Core\Utility\ArrayUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
class TestGeneralUtility
{
public function test(ServerRequestInterface $request): ResponseInterface
{
$value = $request->getQueryParams()['tx_scheduler']) ?? null;
return new HtmlResponse($value);
}
}_POST()
TYPO3 3.6 TYPO3 12.2 TYPO3 13.0
Ohne mitgelieferten Argument liefert _POST() alle Parameter von dem globalen Array $_POST zurück. Mit übergebenen Argument wird nur der gewünschte Parameter aus dem $_POST Array zurückgegeben. Parameter, die kein Array sind, werden sicherheitshalber in Strings konvertiert.
Veraltet. Bitte verwendet den TYPO3 Request:
<?php
declare(strict_types=1);
namespace StefanFroemken\Sfproducts\UserFunc;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Core\Http\HtmlResponse;
use TYPO3\CMS\Core\Utility\ArrayUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
class TestGeneralUtility
{
public function test(ServerRequestInterface $request): ResponseInterface
{
$value = $request->getParsedBody()['tx_scheduler']);
return new HtmlResponse($value);
}
}_GETset()
TYPO3 3.6 TYPO3 9.5 TYPO3 10.0
Veraltet, bitte erstellt eine Middleware, um dem TYPO3 Request mittels $request = $request->withQueryParams([...]); weitere Parameter hinzuzufügen.
Mit dieser Methode konntet ihr das globals Array $_GET modifizieren. Als erstes Argument habt ihr einen String oder ein Array angegeben. Wenn das zweite Argument leer blieb, dann hat das Array aus dem ersten Argument das komplette globale Array überschrieben. Wenn das zweite Argument jedoch ein String war, wurde nur der Teil von $_GET überschrieben, der dem 2ten Argument entsprach. Um tief verschachtelte Elemente zu überschreiben, konnte man die Pipe | als Separator verwenden:
GeneralUtility::_GETset('Schokolade', 'produkte|kaltspeisen|eis');Ergebnis:
[
"produkte" => [
"kaltspeisen" => [
"eis" => "Schokolade",
],
],
]GPvar()
TYPO3 3.6 TYPO3 4.6
Veraltet. Verwendet bitte _GP().
GParrayMerged()
TYPO3 3.6 TYPO3 4.6
Veraltet. Verwendet bitte _GPmerged().
removeXSS()
TYPO3 4.2 TYPO3 8.2 TYPO3 9.0
Hierbei ging es um eine Möglichkeit XXS (Cross Site Scripting) aus Texten zu entfernen. Leider war die Methode nicht zu 100 % sicher, weshalb diese entfernt wurde. Verwendet als Alternative bitte htmlspecialchars() im Kontext von HTML oder GeneralUtility::quoteJSvalue() im Kontext von JavaScript.
gif_compress()
TYPO3 3.6 TYPO3 7.1 TYPO3 8.0
Hier konntet ihr den Pfad zu einer *.gif Datei angeben und unter Einbehaltung des gleichen Namens wurde diese gif Datei je nach Konfiguration in GFX mittels PHP gd-lib oder IM (ImageMagick) komprimiert. Die verwendete Komprimierung lieferte diese Methode als Rückgabewert.
png_to_gif_by_imagemagick()
TYPO3 3.6 TYPO3 7.1 TYPO3 8.0
Übergebt den Pfad zu einer *.png Datei und diese wurde in eine gif Datei konvertiert, sofern unter GFX die Eigenschaft png_to_gif aktiv war.
read_png_gif()
TYPO3 3.6 TYPO3 7.1 TYPO3 8.0
Wenn die Eingabedatei ein gif und das zweite Argument eine 0 ist oder die Eingabedatei ein png und das zweite Argument 1 ist, dann wird die Eingabedatei 1 zu 1 zurückgegeben. In allen anderen Fällen findet je nach zweitem Argument eine Konvertierung von png zu gif oder gif zu png statt. Bei einer stattfindenden Konvertierung liegt die Datei dann in typo3temp/ mit dem Prefix readPG_.
fixed_lgd()
TYPO3 3.6 TYPO3 3.7 TYPO3 4.6
Veraltet. Bitte verwende fixed_lgd_cs() mit einer positiven Anzahl Zeichen.
fixed_lgd_pre()
TYPO3 3.6 TYPO3 3.7 TYPO3 4.6
Veraltet. Bitte verwende fixed_lgd_cs() mit einer negativen Anzahl Zeichen.
fixed_lgd_cs()
TYPO3 3.7Wenn der übergebene Text länger ist als die angegebene Anzahl Zeichen, dann werden die ersten X Zeichen des Textes übernommen und der Rest des Textes wird standardmäßig mit ... ersetzt. Wenn die Anzahl Zeichen negativ ist, dann übernimmt diese Methode X Zeichen vom Ende des übergebenen Textes. Beim Abzählen der Zeichen werden Multi-Byte Zeichen unterstützt.
<?php
// Ergebnis: Hallo ...
echo \TYPO3\CMS\Core\Utility\GeneralUtility::fixed_lgd_cs('Hallo zusammen', 6);
// Ergebnis: "...sammen"
echo \TYPO3\CMS\Core\Utility\GeneralUtility::fixed_lgd_cs('Hallo zusammen', -6);
// Ergebnis: Hallo zu###
echo \TYPO3\CMS\Core\Utility\GeneralUtility::fixed_lgd_cs('Hallo zusammen', -8, '###');breakTextForEmail()
TYPO3 3.6 TYPO3 4.0 TYPO3 8.0
Kürzt jede Zeile eines Textes für den Mailversand standardmäßig auf 76 Zeichen und bewegt den Rest der Zeile in die nächste Zeile. Das war damals für einige Mailclients vonnöten.
Veraltet: Bitte verwendet wordwrap() oder lasst dies die modernen Mail-Libraries wie Symfony Mailer erledigen.
breakLinesForEmail()
TYPO3 3.6 TYPO3 4.6 TYPO3 6.0
Veraltet. Siehe breakTextForEmail(). War dafür zuständig je eine Zeile des Mailtextes ab 76 Zeichen umzubrechen.
cmpIP()
TYPO3 3.6Prüft eine angegebene IPv4 als auch IPv6 Adresse, ob diese den angegebenen Strukturen aus dem zweiten Argument entspricht. Ruft schlussendlich, je nach IPv4 oder IPv6, eine der beiden Methoden cmpIPv4() oder cmpIPv6() auf.
<?php
// Ergebnis: false
echo GeneralUtility::cmpIP('43.65.72.43', '192.168.100.0/24'));
// Ergebnis: true
echo GeneralUtility::cmpIP(cmpIP('87.12.54.67', '87.12.0.0/16'));
// Ergebnis: true
echo GeneralUtility::cmpIP(cmpIP('32.54.78.21', '32.54.*.*'));
// Ergebnis: false
echo GeneralUtility::cmpIP(cmpIP('54.83.24.78', '192.168.*.*, 32.45.65/24, 32.56.125.*'));
// Ergebnis: true
echo GeneralUtility::cmpIP(cmpIP('54.83.24.78', '192.168.*.*, 54.0.0.0/8, 32.56.125.*'));cmpIPv4()
TYPO3 4.0Prüft eine angegebene IPv4-Adresse, ob diese den angegebenen Strukturen aus dem zweiten Argument entspricht. Mehrere Strukturen müssen mit Komma , getrennt werden. Mit / kann die Abfrage auf eine Subnet-Mask erfolgen und mit * setzt ihr Platzhalter, um alle Werte einer Oktette zu erlauben.
Siehe cmpIP() für Beispiele
cmpIPv6()
TYPO3 4.0Prüft eine angegebene IPv6-Adresse, ob diese den angegebenen Strukturen aus dem zweiten Argument entspricht. Mehrere Strukturen müssen mit Komma , getrennt werden. Mit / kann die Abfrage auf die Subnet-Mask /48 oder /64 erfolgen. Andere Subnet-Masken resultieren in false. Ohne Angabe einer Subnet-Maske wird immer die vollständige IPv6 Adresse geprüft.
IPv6Hex2Bin()
TYPO3 4.0 TYPO3 10.4 TYPO3 11.0
Veraltet. Bitte verwendet: PHP:inet_pton($hex)
normalizeIPv6()
TYPO3 4.0Konvertiert eine verkürzte IPv6 Adresse wieder in ihre normale Länge.
<?php
// Ergebnis: 2041:0000:140F:0000:0000:0000:875B:131B
echo GeneralUtility::normalizeIPv6('2041:0000:140F::875B:131B');compressIPv6()
TYPO3 4.6 TYPO3 10.4 TYPO3 11.0
Konvertiert eine vollständige IPv6 Adresse in eine verkürzte Fassung.
Veraltet. Bitte verwendet: PHP:inet_ntop(inet_pton($address))
<?php
// Ergebnis: 2041:0:140f::875b:131b
echo inet_ntop(inet_pton('2041:0000:140F:0000:0000:0000:875B:131B');validIP()
TYPO3 4.2Prüft, ob die angegebene IPv4 oder IPv6 Adresse gültig ist.
Ruft eine der beiden Methoden validIPv4 oder validIPv6 auf.
validIPv4()
TYPO3 4.2Prüft, ob die angegebene IPv4-Adresse gültig ist.
validIPv6()
TYPO3 4.0Prüft, ob die angegebene IPv6-Adresse gültig ist.
cmpFQDN()
TYPO3 3.6Löst eine angegebene IP-Adresse zurück auf ihren Domainnamen auf und prüft das Ergebnis gegen einen oder mehrere kommaseparierte Domainnamen. Für vollständige Teile des Hostnamen kann * als Platzhalter verwendet werden. * kann nicht als Teil des Hostname verwendet werden: pf.*seiten.cc.
<?php
// Ergebnis: true
echo GeneralUtility::cmpFQDN('8.8.8.8', '*.google');inList()
TYPO3 3.6Prüft, ob der Wert aus dem zweiten Argument in der kommaseparierten Liste des ersten Arguments gefunden wurde.
rmFromList()
TYPO3 3.6 TYPO3 11.3 TYPO3 12.0
Entfernt den Eintrag vom ersten Argument aus der kommaseparierten Liste des zweiten Argumentes.
Wird TYPO3 intern seit TYPO3 10 nicht mehr verwendet. Der Extension Scanner zeigt Euch an, wo diese Methoden noch aufgerufen wird. Es gibt keinen Ersatz für diese Methode. Bitte versucht mit Arrays zu arbeiten oder kopiert Euch die Methode in Euren Quellcode.
intInRange()
TYPO3 3.6 TYPO3 4.6 TYPO3 6.0
“Quetscht” eine angegebene Zahl in einen vorgegebenen Zahlenbereich.
Ab TYPO3 4.6 ist diese Methode veraltet und wurde in das t3lib_utility_Math Objekt überführt, welches dann wiederrum mit TYPO3 6.0 in das MathUtility überführt wurde.
Veraltet. Bitte verwendet: MathUtility::forceIntegerInRange().
intval_positive()
TYPO3 3.6 TYPO3 4.6 TYPO3 6.0
Konvertiert negative Zahlenwerte ins Positive. Auf -6 wird 6.
Ab TYPO3 4.6 ist diese Methode veraltet und wurde in das t3lib_utility_Math Objekt überführt, welches dann wiederrum mit TYPO3 6.0 in das MathUtility überführt wurde.
Veraltet. Bitte verwendet: MathUtility::convertToPositiveInteger().
int_from_ver()
TYPO3 3.6 TYPO3 4.6 TYPO3 7.0
Konvertiert eine Versionsnummer mit 3 Teilen in eine Zahl. Aus 4.12.3 wird 4012003.
Ab TYPO3 4.6 ist diese Methode veraltet und wurde in das t3lib_utility_VersionNumber Objekt überführt, welches dann wiederrum mit TYPO3 6.0 in das VersionNumberUtility überführt wurde.
Veraltet. Bitte verwendet: VersionNumberUtility::convertVersionNumberToInteger().