Руководство по PHP 3. PHP 3 Manual. Руководство по PHP 3.

Руководство по РНР 3.0 - PHP опции и информация

Содержание
error_log
error_reporting
getenv
get_cfg_var
get_current_user
get_magic_quotes_gpc
get_magic_quotes_runtime
getlastmod
getmyinode
getmypid
getmyuid
phpinfo
phpversion
putenv
set_magic_quotes_runtime
set_time_limit

error_log

error_log -- отослать сообщение об ошибке

Описание

int error_log(string message, int message_type, string [ destination ], string [ extra_headers ]);

Посылает сообщение об ошибке в web сервер лог, TCP порт или в файл. Первый параметр, message, определяет сообщение об ошибке, которое должно быть отослано. Второй параметр, message_type, определяет способ передачи сообщения:

Таблица 1. error_log() лог типы

0	`message` посылается в системный лог PHP, используя механизм системного логирования Операционной Системы или в файл, в зависимости от того, как определена конфигурация error_log директивы.
1	`message` посылается по электронной почте, адрес определен в `destination` параметре. Только для этого типа сообщений используется параметр `extra_headers`. Этот тип использует ту же внутреннюю функцию, что и Mail().
2	`message` отсылается через соединение PHP отладки. Эта опция доступна только тогда, когда установлена remote debugging has been enabled. В этом случае параметр `destination` определяет имя машины или IP адрес и опционально, номер порта, сокета получающего отладочную информацию.
3	`message` добавляется к файлу, определенному в `destination`.

Пример 1. примеры error_log()

// Послать сообщение в системный лог, если не получено соединение с базой данных

if (!Ora_Logon($username, $password)) {

    error_log("Oracle database not available!", 0);

}

// Информировать администратора по почте об ошибке выделения FOO

if (!($foo = allocate_new_foo()) {

    error_log("Big trouble, we're all out of FOOs!", 1,

              "operator@mydomain.com");

}

// другие способы вызова error_log():

error_log("You messed up!", 2, "127.0.0.1:7000");

error_log("You messed up!", 2, "loghost");

error_log("You messed up!", 3, "/var/tmp/my-errors.log");

error_reporting

error_reporting -- устанавливает уровень сообщений об ошибках PHP

Описание

int error_reporting(int [ level ]);

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

Таблица 1. error_reporting() битовые значения

значение	внутреннее имя
1	E_ERROR
2	E_WARNING
4	E_PARSE
8	E_NOTICE
16	E_CORE_ERROR
32	E_CORE_WARNING

getenv

getenv -- Получить значение переменной среды окружения.

Описание

string getenv(string varname);

Возвращает значение переменной среды окружения varname, или false(ложь) в случае ошибки.

$ip = getenv("REMOTE_ADDR"); // получить ip номер пользователя

get_cfg_var

get_cfg_var -- Получить значение опции конфигурации PHP.

Описание

string get_cfg_var(string varname);

Возвращает текущее значение опции конфигурации PHP, заданной в varname, или false(ложь), если произошла ошибка.

Не возвращает информацию конфигурации, установленную при компиляции PHP, или прочитанную из файла конфигурации Apache (использование php3_configuration_option директив).

Что бы проверить, использует ли система php3.ini файл, попробуйте получить значение cfg_file_path. Если оно установлено, то php3.ini файл используется.

get_current_user

get_current_user -- Получить имя владельца текущего PHP скрипта.

Описание

string get_current_user(void);

Возвращает имя владельца текущего PHP скрипта.

См. также getmyuid(), getmypid(), getmyinode(), и getlastmod().

get_magic_quotes_gpc

get_magic_quotes_gpc -- Получить текущие активные установки magic_quotes_gpc.

Описание

long get_magic_quotes_gpc(void);

Возвращает текущие активные установки magic_quotes_gpc. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_runtime(), set_magic_quotes_runtime().

get_magic_quotes_runtime

get_magic_quotes_runtime -- Получить текущие активные установки magic_quotes_runtime.

Описание

long get_magic_quotes_runtime(void);

Возвращает текущие активные установки magic_quotes_runtime. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_gpc(), set_magic_quotes_runtime().

getlastmod

getlastmod -- Получить время последней модификации страницы.

Описание

int getlastmod(void);

Возвращает время последней модификации текущей страницы. Возвращаемое значение - Unix timestamp, подходящее для использование в функции date(). Возвращает false(ложь) при ошибке.

Пример 1. getlastmod() пример

// выводит что-то вроде этого 'Последнее изменение: March 04 1998 20:43:59.'

echo "Последнее изменение: ".date( "F d Y H:i:s.", getlastmod() );

См. также date(), getmyuid(), get_current_user(), getmyinode(), и getmypid().

getmyinode

getmyinode -- Получить inode текущего скрипта.

Описание

int getmyinode(void);

Возвращает inode текущего скрипта, или false(ложь) при ошибке.

См. также getmyuid(), get_current_user(), getmypid(), и getlastmod().

getmypid

getmypid -- Получить ID процесса PHP.

Описание

int getmypid(void);

Возвращает текущий ID процесса PHP, или false(ложь) при ошибке.

Обратите внимание, что при работе PHP как модуля сервера, вы не получите точный IP процесса.

См. также getmyuid(), get_current_user(), getmyinode(), и getlastmod().

getmyuid

getmyuid -- Получить UID владельца скрипта PHP.

Описание

int getmyuid(void);

Возвращает UID текущего скрипта, или false(ложь) при ошибке.

См. также getmypid(), get_current_user(), getmyinode(), и getlastmod().

phpinfo

phpinfo -- Вывод большого количества информации о PHP.

Описание

int phpinfo(void);

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

См. также phpversion().

phpversion

phpversion -- Получить текущую версию PHP.

Описание

string phpversion(void);

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

Пример 1. phpversion() пример

// Печатает что-то вроде этого 'Текущая версия PHP: 3.0rel-dev'

echo "Текущая версия PHP: ".phpversion();

См. также phpinfo().

putenv

putenv -- Устанавливает значение переменной среды окружения.

Описание

void putenv(string setting);

Добавляет setting в среду окружения.

Пример 1. Устанавливает значение переменной среды окружения

putenv("UNIQID=$uniqid");

set_magic_quotes_runtime

set_magic_quotes_runtime -- Устанавливает в текущих активных установках конфигурации установки для magic_quotes_runtime.

Описание

long get_magic_quotes_runtime(int new_setting);

Устанавливает в текущих активных установках конфигурации установки для magic_quotes_runtime. (0 для выключенных(off), 1 для включенных(on))

См. также get_magic_quotes_gpc(), get_magic_quotes_runtime().

set_time_limit

set_time_limit -- Установка лимита на максимальное время работы скрипта

Описание

void set_time_limit(int seconds);

Устанавливает длительность в секундах, во время которого скрипт должен быть выполнен. Если период превышен, то скрипт возвращает фатальную ошибку. По умолчанию лимит составляет 30 секунд или, если этот параметр установлен, значение max_execution_time в php3.ini. Если значение установлено в ноль(0), то лимит выключен.

При вызове, set_time_limit() перезапускает счетчик времени исполнения с нуля. Другими словами, если установлен лимит по умолчанию 30 секунд, и прошло 25 секунд со времени запуска, то после вызова set_time_limit( 20 ) общее время будет составлять 45 секунд после с начала запуска скрипта.

Назад, к содержанию