Справочник по PHP : Управляющие функции : Информационные функции

Материал из Справочник Web-языков.

Перейти к: навигация, поиск
Главная  ::. PHP  ::. Управляющие функции  ::. Информационные функции

Содержание

[править] 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();

[править] 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 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
Личные инструменты
1.26255297661