PHP Класс Contao\Environment

The class returns the environment variables (which are stored in the PHP $_SERVER array) independent of the operating system. Usage: echo Environment::get('scriptName'); echo Environment::get('requestUri');
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$arrCache array Cache
$objInstance Environment Object instance (Singleton)
$strSapi string The SAPI name

Открытые методы

Метод Описание
__clone ( ) Prevent cloning of the object (Singleton)
__get ( string $strKey ) : string Return an environment variable
__set ( string $strKey, mixed $varValue ) Set an environment variable
get ( string $strKey ) : mixed Return an environment variable
getInstance ( ) : Environment Return the object instance (Singleton)
reset ( ) Reset the internal cache
set ( string $strKey, mixed $varValue ) Set an environment variable

Защищенные методы

Метод Описание
__construct ( ) Prevent direct instantiation (Singleton)
agent ( ) : object Return the operating system and the browser name and version
base ( ) : string Return the URL and path that can be used in a tag
documentRoot ( ) : string Return the document root (e.g. /home/www/user/)
encodeRequestString ( string $strRequest ) : string Encode a request string preserving certain reserved characters
host ( ) : string Return the host name
httpAcceptEncoding ( ) : array Return accepted encoding types as array
httpAcceptLanguage ( ) : array Return the first eight accepted languages as array
httpHost ( ) : string Return the HTTP Host
httpUserAgent ( ) : string Return the user agent as string
httpXForwardedHost ( ) : string Return the HTTP X-Forwarded-Host
indexFreeRequest ( ) : string Return the request string without the index.php fragment
ip ( ) : string Return the real REMOTE_ADDR even if a proxy server is used
isAjaxRequest ( ) : boolean Return true on Ajax requests
path ( ) : string Return the relative path to the base directory (e.g. /path)
phpSelf ( ) : string Alias for scriptName()
queryString ( ) : string Return the query string (e.g. id=2)
relativeRequest ( ) : string Return the request string without the script name (e.g. en/news.html)
request ( ) : string Return the relativ path to the script and include the request (e.g. index.php?id=2)
requestUri ( ) : string Return the request URI [path]?[query] (e.g. /contao/index.php?id=2)
script ( ) : string Return the relativ path to the script (e.g. index.php)
scriptFilename ( ) : string Return the absolute path to the script (e.g. /home/www/html/website/index.php)
scriptName ( ) : string Return the relative path to the script (e.g. /website/index.php)
server ( ) : string Return the SERVER_ADDR
ssl ( ) : boolean Return true if the current page was requested via an SSL connection
uri ( ) : string Return the current URL with path or query string
url ( ) : string Return the current URL without path or query string

Описание методов

__clone() закрытый публичный Метод

Prevent cloning of the object (Singleton)
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0. The Environment class is now static.
final public __clone ( )

__construct() защищенный Метод

Prevent direct instantiation (Singleton)
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0. The Environment class is now static.
protected __construct ( )

__get() публичный Метод

Return an environment variable
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0. Use Environment::get() instead.
public __get ( string $strKey ) : string
$strKey string The variable name
Результат string The variable value

__set() публичный Метод

Set an environment variable
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0. Use Environment::set() instead.
public __set ( string $strKey, mixed $varValue )
$strKey string The variable name
$varValue mixed The variable value

agent() защищенный статический Метод

Return the operating system and the browser name and version
protected static agent ( ) : object
Результат object The agent information

base() защищенный статический Метод

Return the URL and path that can be used in a tag
protected static base ( ) : string
Результат string The base URL

documentRoot() защищенный статический Метод

Calculated as SCRIPT_FILENAME minus SCRIPT_NAME as some CGI versions and mod-rewrite rules might return an incorrect DOCUMENT_ROOT.
protected static documentRoot ( ) : string
Результат string The document root

encodeRequestString() защищенный статический Метод

Encode a request string preserving certain reserved characters
protected static encodeRequestString ( string $strRequest ) : string
$strRequest string The request string
Результат string The encoded request string

get() публичный статический Метод

Return an environment variable
public static get ( string $strKey ) : mixed
$strKey string The variable name
Результат mixed The variable value

getInstance() публичный статический Метод

Return the object instance (Singleton)
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0. The Environment class is now static.
public static getInstance ( ) : Environment
Результат Environment The object instance

host() защищенный статический Метод

Return the host name
protected static host ( ) : string
Результат string The host name

httpAcceptEncoding() защищенный статический Метод

Return accepted encoding types as array
protected static httpAcceptEncoding ( ) : array
Результат array The encoding types array

httpAcceptLanguage() защищенный статический Метод

Return the first eight accepted languages as array
protected static httpAcceptLanguage ( ) : array
Результат array The languages array

httpHost() защищенный статический Метод

Return the HTTP Host
protected static httpHost ( ) : string
Результат string The host name

httpUserAgent() защищенный статический Метод

Return the user agent as string
protected static httpUserAgent ( ) : string
Результат string The user agent string

httpXForwardedHost() защищенный статический Метод

Return the HTTP X-Forwarded-Host
protected static httpXForwardedHost ( ) : string
Результат string The name of the X-Forwarded-Host

indexFreeRequest() защищенный статический Метод

Return the request string without the index.php fragment
protected static indexFreeRequest ( ) : string
Результат string The request string without the index.php fragment

ip() защищенный статический Метод

Return the real REMOTE_ADDR even if a proxy server is used
protected static ip ( ) : string
Результат string The IP address of the client

isAjaxRequest() защищенный статический Метод

Return true on Ajax requests
protected static isAjaxRequest ( ) : boolean
Результат boolean True if it is an Ajax request

path() защищенный статический Метод

Return the relative path to the base directory (e.g. /path)
protected static path ( ) : string
Результат string The relative path to the installation

phpSelf() защищенный статический Метод

Alias for scriptName()
protected static phpSelf ( ) : string
Результат string The script name

queryString() защищенный статический Метод

Return the query string (e.g. id=2)
protected static queryString ( ) : string
Результат string The query string

relativeRequest() защищенный статический Метод

Return the request string without the script name (e.g. en/news.html)
protected static relativeRequest ( ) : string
Результат string The base URL

request() защищенный статический Метод

Return the relativ path to the script and include the request (e.g. index.php?id=2)
protected static request ( ) : string
Результат string The relative path to the script including the request string

requestUri() защищенный статический Метод

Return the request URI [path]?[query] (e.g. /contao/index.php?id=2)
protected static requestUri ( ) : string
Результат string The request URI

reset() публичный статический Метод

Reset the internal cache
public static reset ( )

script() защищенный статический Метод

Return the relativ path to the script (e.g. index.php)
protected static script ( ) : string
Результат string The relative path to the script

scriptFilename() защищенный статический Метод

Return the absolute path to the script (e.g. /home/www/html/website/index.php)
protected static scriptFilename ( ) : string
Результат string The absolute path to the script

scriptName() защищенный статический Метод

Return the relative path to the script (e.g. /website/index.php)
protected static scriptName ( ) : string
Результат string The relative path to the script

server() защищенный статический Метод

Return the SERVER_ADDR
protected static server ( ) : string
Результат string The IP address of the server

set() публичный статический Метод

Set an environment variable
public static set ( string $strKey, mixed $varValue )
$strKey string The variable name
$varValue mixed The variable value

ssl() защищенный статический Метод

Return true if the current page was requested via an SSL connection
protected static ssl ( ) : boolean
Результат boolean True if SSL is enabled

uri() защищенный статический Метод

Return the current URL with path or query string
protected static uri ( ) : string
Результат string The URL

url() защищенный статический Метод

Return the current URL without path or query string
protected static url ( ) : string
Результат string The URL

Описание свойств

$arrCache защищенное статическое свойство

Cache
protected static array $arrCache
Результат array

$objInstance защищенное статическое свойство

Object instance (Singleton)
protected static Environment,contao $objInstance
Результат Environment

$strSapi защищенное статическое свойство

The SAPI name
protected static string $strSapi
Результат string