Environment¶
\nn\t3::Environment()¶
Alles, was man über die Umgebung der Anwendung wissen muss. Von Sprach-ID des Users, der baseUrl bis zu der Frage, welche Extensions am Start sind.
Overview of Methods¶
\nn\t3::Environment()->extLoaded($extName = '');¶
Prüfen, ob Extension geladen ist.
\nn\t3::Environment()->extLoaded('news');
\nn\t3::Environment()->extPath($extName = '');¶
absoluten Pfad zu einer Extension holen
z.B. /var/www/website/ext/nnsite/
\nn\t3::Environment()->extPath('extname');
@return string\nn\t3::Environment()->extRelPath($extName = '');¶
relativen Pfad (vom aktuellen Script aus) zu einer Extension holen
z.B. ../typo3conf/ext/nnsite/
\nn\t3::Environment()->extRelPath('extname');
@return string\nn\t3::Environment()->getBaseURL();¶
Gibt die baseUrl (config.baseURL) zurück, inkl. http(s) Protokoll z.B. https://www.webseite.de/
\nn\t3::Environment()->getBaseURL();
@return string\nn\t3::Environment()->getCookieDomain($loginType = 'FE');¶
Die Cookie-Domain holen z.B. www.webseite.de
\nn\t3::Environment()->getCookieDomain()
@return string\nn\t3::Environment()->getCountries($lang = 'de', $key = 'cn_iso_2');¶
Alle im System verfügbaren Ländern holen
\nn\t3::Environment()->getCountries();
@return array\nn\t3::Environment()->getCountryByIsocode($cn_iso_2 = NULL, $field = 'cn_iso_2');¶
Ein Land aus der Tabelle static_countries
anhand seines Ländercodes (z.B. DE) holen
\nn\t3::Environment()->getCountryByIsocode( 'DE' );
\nn\t3::Environment()->getCountryByIsocode( 'DEU', 'cn_iso_3' );
@return array\nn\t3::Environment()->getDomain();¶
Die Domain holen z.B. www.webseite.de
\nn\t3::Environment()->getDomain();
@return string\nn\t3::Environment()->getExtConf($ext = 'nnhelpers', $param = '');¶
Configuration aus ext_conf_template.txt holen (Backend, Extension Configuration)
\nn\t3::Environment()->getExtConf('nnhelpers', 'varname');
Existiert auch als ViewHelper:
{nnt3:ts.extConf(path:'nnhelper')}
{nnt3:ts.extConf(path:'nnhelper.varname')}
{nnt3:ts.extConf(path:'nnhelper', key:'varname')}
@return mixed\nn\t3::Environment()->getLanguage();¶
Die aktuelle Sprache (als Zahl) des Frontends holen.
\nn\t3::Environment()->getLanguage();
@return int\nn\t3::Environment()->getLanguageKey();¶
Die aktuelle Sprache (als Kürzel wie “de”) im Frontend holen
\nn\t3::Environment()->getLanguageKey();
@return string\nn\t3::Environment()->getLocalConf($path = '');¶
Konfiguration aus der LocalConfiguration.php holen
\nn\t3::Environment()->getLocalConf('FE.cookieName');
@return string\nn\t3::Environment()->getPathSite();¶
Absoluten Pfad zum Typo3-Root-Verzeichnis holen. z.B. /var/www/website/
\nn\t3::Environment()->getPathSite()
früher: PATH_site
\nn\t3::Environment()->getPostMaxSize();¶
Maximale Upload-Größe für Dateien aus dem Frontend zurückgeben. Diese Angabe ist der Wert, der in der php.ini festgelegt wurde und ggf. über die .htaccess überschrieben wurde.
\nn\t3::Environment()->getPostMaxSize(); // z.B. '1048576' bei 1MB
@return integer\nn\t3::Environment()->getRelPathSite();¶
Relativen Pfad zum Typo3-Root-Verzeichnis holen. z.B. ../
\nn\t3::Environment()->getRelPathSite()
@return string\nn\t3::Environment()->getSite($request = NULL);¶
Das aktuelle Site Object holen.
Über dieses Object kann z.B. ab TYPO3 9 auf die Konfiguration aus der site YAML-Datei zugegriffen werden.
Im Kontext einer MiddleWare ist evtl. die site noch nicht geparsed / geladen.
In diesem Fall kann der $request aus der MiddleWare übergeben werden, um die Site zu ermitteln.
Siehe auch \nn\t3::Settings()->getSiteConfig(), um die site-Konfiguration auszulesen.
\nn\t3::Environment()->getSite();
\nn\t3::Environment()->getSite( $request );
\nn\t3::Environment()->getSite()->getConfiguration();
\nn\t3::Environment()->getSite()->getIdentifier();
@return \TYPO3\CMS\Core\Site\Entity\Site\nn\t3::Environment()->getVarPath();¶
Absoluten Pfad zu dem /var-Verzeichnis von Typo3 holen.
Dieses Verzeichnis speichert temporäre Cache-Dateien. Je nach Version von Typo3 und Installationstyp (Composer oder Non-Composer mode) ist dieses Verzeichnis an unterschiedlichen Orten zu finden.
// /full/path/to/typo3temp/var/
$path = \nn\t3::Environment()->getVarPath();
\nn\t3::Environment()->isBackend();¶
Prüfen, ob wir uns im Backend-Context befinden
\nn\t3::Environment()->isBackend();
@return bool\nn\t3::Environment()->isFrontend();¶
Prüfen, ob wir uns im Frontend-Context befinden
\nn\t3::Environment()->isFrontend();
@return bool\nn\t3::Environment()->isLocalhost();¶
Prüft, ob Installation auf lokalem Server läuft
\nn\t3::Environment()->isLocalhost()
@return boolean\nn\t3::Environment()->t3Version();¶
Die Version von Typo3 holen, als Ganzzahl, z.b “8”
Alias zu \nn\t3::t3Version()
\nn\t3::Environment()->t3Version();
if (\nn\t3::t3Version() >= 8) {
// nur für >= Typo3 8 LTS
}
@return int