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

Описание

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

Описание

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

Описание

string getenv(string varname);

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

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

get_cfg_var

Описание

string get_cfg_var(string varname);

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

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

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

get_current_user

Описание

string get_current_user(void);

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

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

get_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

Описание

long get_magic_quotes_runtime(void);

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

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

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

Описание

int getmyinode(void);

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

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

getmypid

Описание

int getmypid(void);

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

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

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

getmyuid

Описание

int getmyuid(void);

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

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

phpinfo

Описание

int phpinfo(void);

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

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

phpversion

Описание

string phpversion(void);

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

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

// Печатает что-то вроде этого 'Текущая версия PHP: 3.0rel-dev'
echo "Текущая версия PHP: ".phpversion();

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

putenv

Описание

void putenv(string setting);

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

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

putenv("UNIQID=$uniqid");

set_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

Описание

void set_time_limit(int seconds);

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

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