Приглашаем посетить
Пастернак (pasternak.niv.ru)

Учебник по 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();
    
    Вот что примерно должно получиться:
    4.3.6
    

    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 а cgi-fcgi
    

    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";
    
    Вот что получиться в результате работы:
    Ваш IP-адрес: 127.0.0.1
    
    Список переменных окружения можно посмотреть в Приложения->Переменные окружения, или при помощи функции 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
    

    Назад Содержание Вперед