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

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

Синтаксис:
int phpinfo([int what])

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

· INFO_GENERAL

· INFO_CREDITS

· INFO_CONFIGURATION

· INFO_MODULES

· INFO_ENVIRONMENT

· INFO_VARIABLES

· INFO_LICENSE

· INFO_ALL

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

· версия PHP;

· опции, которые были установлены при компиляции PHP;

· информация о дополнительных модулях;

· переменные окружения, в том числе и установленные сервером при получении запроса от пользователя на вызов сценария;

· версия операционной системы;

· состояние основных и локальных настроек интерпретатора;

· HTTP-заголовки;

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

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

Синтаксис:
string phpversion();

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

echo phpversion();

Вот что примерно должно получиться:

4.3.3

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

Синтаксис:
void phpcredits(inf flag);

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

phpcredits(CREDITS_GENERAL);

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

phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);

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

· CREDITS_ALL - Полный HTML-листинг.

· CREDITS_DOCS - Список разработчиков документации.

· CREDITS_FULLPAGE - Обычно используется в комбинации с другими флагами. Выбирает вариант, подготовленный к распечатке.

· CREDITS_GENERAL - Общая разработка языка PHP 4.0 и SAPI

· CREDITS_GROUP - Список разработчиков ядра.

· CREDITS_MODULES - Список модулей расширения и их авторов.

· CREDITS_SAPI - Список разработчиков PHP модуля API сервера.

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 PHP\n";else echo "Это не CGI PHP а $sapi_type";

Вот что получиться для нашего случая:

Это не CGI PHP а apache

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

Синтаксис:
string php_uname();

Возвращает строку, содержащую название операционной системы, например "FreeBSD lauryn.e-neverland.net 4.9-RELEASE-p1 FreeBSD 4.9-RELEASE-p1 #2: Sun i386".

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";

Вот что получиться в результате работы:

Ваш IP-адрес: 83.151.11.175

Список переменных окружения можно посмотреть в Приложения->Переменные окружения, или при помощи функции 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.