Книга: Справочник по PHP

Информационные функции

Информационные функции

phpinfo

Выводит текущее состояние всех параметров PHP.

Синтаксис:

int phpinfo([int what])

Для сокращения объема выводимой информации можно указать один из следующих разделов what (если он не указывается, то подразумевается INFO_ALL):

Эта функция,которая в общем-то не должна появляться в законченной программе, выводит в броузер большое количество различной информации, касающейся настроек PHP и параметров вызова сценария. Именно, в стандартный выходной поток (то есть в браузер пользователя) печатается:

Функция phpinfo() в основном применяется при первоначальной установке PHP для проверки его работоспособности (уж больно много она выдает информации).

phpversion

Возвращает текущую версию PHP.

Синтаксис:

string phpversion();

Возвращает строку, содержащую название версии интерпретатора PHP.

echo phpversion();

phpcredits

HTML-распечатка разработчиков PHP.

Синтаксис:

void phpcredits(inf flag);

Выводит информацию о создателях и их вкладе в разработку пакета PHP.

phpcredits(CREDITS_GENERAL);

Флаги можно комбинировать следующим образом:

phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);

Далее приведу список доступных флагов:

php_sapi_name

Получение типа интерфейса между Web-сервером и PHP.

Синтаксис:

string php_sapi_name();

Возвращает строку, содержащую строчными буквами тип интерфейса. Для CGI PHP, это будет строка "cgi", для mod_php под Apache - "apache" и т.п.

$sapi_type = php_sapi_name();
if($sapi_type == "cgi")
echo "Это CGI PHPn";
else
echo "Это не CGI PHP а $sapi_type";

php_uname

Определение операционной системы.

Синтаксис:

string php_uname();

Возвращает строку, содержащую название операционной системы, например "Windows NT MYCOMP 5.1 build 2600".

if(substr(php_uname(),0,7) != "Windows") {
die("Этот сценарий должен выполняться в Windows.");
}

ini_set

Изменение параметра конфигурации.

Синтаксис:

string ini_set(string varname, string newvalue);

Устанавливает для указанного параметра varname значение newvalue. При успехе возвращает прежнее значение, при ошибке - false.

ini_alter

Тоже, что и ini_set().

Синтаксис:

string ini_alter(string varname, string newvalue);

ini_get

Эта функция получает значения параметров конфигурации.

Синтаксис:

string ini_get(string varname);

Возвращает текущее значение параметра конфигурации, заданное в переменной varname.

Данная функция позволяет получить все доступные в PHP параметры.

В случае ошибки возвращает false.

ini_restore

Производит восстановление параметра конфигурации.

Синтаксис:

string ini_restore(string varname);

Устанавливает значение параметра конфигурации varname в первоначальное.

echo ini_set("precision",20).ini_get("precision").
ini_restore("precision").ini_get("precision");
// Выведет 14 20 14

get_cfg_var

Получает значения параметра непосредственно из файла php.ini.

Синтаксис:

string get_cfg_var(string varname);

Надо отметить, что в отличии от функции ini_get(), которая возвращает текущее значение параметра, функция get_cfg_var() возвращает значение параметра, которое установлено в файле конфигурации php.ini. Также эта функция не возвращает другие параметры (например, из конфигурации самого сервера).

getenv

Функция возвращает значение переменной окружения.

Синтаксис:

string getenv(string varname);

$ip = getenv("REMOTE_ADDR");
echo "Ваш IP-адрес: $ip";

Список переменных окружения можно посмотреть в Приложения-Переменные окружения, или при помощи функции phpinfo().

Эта функция не работает в модуле PHP ISAPI.

putenv

Устанавливает переменную окружения.

Синтаксис:

void putenv(string setting);

putenv("UNIQID=$uniquid");

get_magic_quotes_gpc

Получает текущее значение параметра magic_quotes_gpc.

Синтаксис:

long get_magic_quotes_gpc();

Эта функция возвратит 0 для Off и 1 для On.

get_magic_quotes_runtime

Предназначена для получения текущего значения параметра magic_quotes_runtime.

Синтаксис:

long get_magic_quotes_runtime();

Эта функция возвратит 0 для Off и 1 для On.

set_magic_quotes_runtime

Предназначена для установки текущего значения параметра magic_quotes_runtime.

Синтаксис:

long set_magic_quotes_runtime(int new_setting);

Для установки magic_quotes_runtime в Off задайте параметр new_setting равным 0, а для установки в On равным 1.

php_logo_guid

Функция получения GUID логотипа PHP.

Синтаксис:

string php_logo_guid();

Строка

echo php_logo_guid();

возвратит

PHPE9568F34-D428-11d2-A769-00AA001ACF42

zend_logo_guid

Функция получения GUID логотипа Zend.

Синтаксис:

string zend_logo_guid();

Строка

echo zend_logo_guid();

возвратит

PHPE9568F35-D428-11d2-A769-00AA001ACF42

Оглавление книги