Справочник по PHP : Управляющие функции : Информационные функции
смотрим также
Материал из Справочник Web-языков
Содержание |
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
<[f>
zend_logo_guid
Функция получения GUID логотипа Zend.
Синтаксис:
string zend_logo_guid();
Строка
echo zend_logo_guid();
возвратит
PHPE9568F35-D428-11d2-A769-00AA001ACF42