Учебник PHP

         

mcal_event_set_recur_yearly

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_recur_yearly - устанавливает повторение структуры глобальных событий потока.

Описание

int mcal_event_set_recur_yearly (int stream, int year, int month, int day, int interval)

mcal_event_set_recur_yearly() устанавливает повторение структуры глобальных событий потока в данное значение для повторения ежегодно с окончанием на заданной дате.

mcal_event_set_start

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_start - устанавливает стартовые дату и время структуры глобальных событий потока.

Описание

int mcal_event_set_start (int stream, int year, int month [, int day [, int hour [, int min [, int sec]]]])

mcal_event_set_start() устанавливает стартовые дату и время структуры глобальных событий потока в данные значения.

Возвращает TRUE.

mcal_event_set_title

(PHP 3>= 3.0.13, PHP 4)

mcal_event_set_title - устанавливает заголовок структуры глобальных событий потока.

Описание

int mcal_event_set_title (int stream, string title)

mcal_event_set_title() устанавливает заголовок структуры глобальных событий потока в данную строку.

Возвращает TRUE.

mcal_expunge

(unknown)

mcal_expunge - удаляет все события помеченные для зачистки.

Описание

int mcal_expunge (int stream)

mcal_expunge() удаляет все события, помеченные ранее для удаления.

mcal_fetch_current_stream_event

(PHP 3>= 3.0.13, PHP 4)

mcal_fetch_current_stream_event - возвращает объект, содержащий структуру глобальных событий текущего потока.



Описание

object mcal_fetch_current_stream_event (int stream)

mcal_fetch_current_stream_event() возвращает структуру глобальных событий текущего потока как объект, содержащий:

int id - ID данного события.

int public - TRUE, если событие public, FALSE - если private.

string category - строку категории/Category события.

string title - строку заголовка/Title события.

string description - строку описания/Description события.

int alarm - количество минут до события для отправки напоминания/alarm.

object start - объект/Object, содержащий вхождение datetime.

object end - объект/Object, содержащий вхождение datetime.

int recur_type - тип повторения.

int recur_interval - интервал повторения.

datetime recur_enddate - дата окончания повторений.

int recur_data - дата повторения.

Все вхождения datetime состоят из объекта, который содержит:

int year - год

int month - месяц

int mday - число/день месяца

int hour - час

int min - минуты

int sec - секунды

int alarm - минут до события для отправки напоминания/alarm

mcal_fetch_event

(PHP 3>= 3.0.13, PHP 4)

mcal_fetch_event - извлекает событие из потока календаря.

Описание

object mcal_fetch_event (int mcal_stream, int event_id [, int options])

mcal_fetch_event() извлекает событие из потока календаря id.

Возвращает объект события, состоящий из:

int id - ID идентификатора события.

int public - TRUE, если событие public, FALSE - если private.

string category - строки Category события.

string title - строки Title события.

string description - Строки Description события.

int alarm - количества минут до события для отправки напоминания/alarm.

object start - объекта/Object, содержащего вхождение datetime.

object end - объект/Object, содержащего вхождение datetime.

int recur_type - типа повторения.

int recur_interval - интервала повторения.

datetime recur_enddate - даты окончания повторений.

int recur_data - даты повторения.

Все вхождения datetime состоят из объекта, который содержит:

int year - год

int month - месяц

int mday - число/день месяца

int hour - час

int min - минуты

int sec - секунды

int alarm - минут до события для отправки напоминания/alarm

Возможные значения recur_type:

0 - событие не возникает

1 - возникает ежедневно

2 - еженедельно

3 - ежемесячно (например, 10 числа месяца)

4 - ежемесячно в определённый день и неделю (например, в 3-ю субботу)

5 - ежегодно

mcal_is_leap_year

(PHP 3>= 3.0.13, PHP 4)

mcal_is_leap_year - возвращает, является ли год високосным.

Описание

int mcal_is_leap_year (int year)

mcal_is_leap_year() возвращает 1, если данный год является високосным, 0 - если нет.

mcal_list_alarms

(PHP 3>= 3.0.13, PHP 4)

mcal_list_alarms - возвращает список событий, имеющих напоминание, включённое на данную datetime.

Описание

array mcal_list_alarms (int mcal_stream [, int begin_year [, int begin_month [, int begin_day [, int end_year [, int end_month [, int end_day]]]]]])

Возвращает массив ID'ов событий, имеющих напоминание/alarm в период между начальной и конечной датами, или, если задан просто поток, использует начальную и конечную даты в структуре глобальных событий.

mcal_list_events() принимает необязательную начальную дату и конечную дату для потока календаря. Возвращается массив id'ов событий между данными датами или даты внутренних событий.

mcal_list_events

(PHP 3>= 3.0.13, PHP 4)

mcal_list_events - возвращает список IDs для даты или диапазона дат.

Описание

array mcal_list_events (int mcal_stream, object begin_date [, object end_date])

Возвращает массив ID'ов в диапазоне начальной и конечной дат или, если задан просто поток, использует начальную и конечную даты структуры глобальных событий.

mcal_list_events() принимает необязательную начальную дату и конечную дату для потока календаря. Возвращается массив id'ов событий между данными датами или даты внутренних событий.

mcal_next_recurrence

(PHP 3>= 3.0.13, PHP 4)

mcal_next_recurrence - возвращает следующее повторение события.

Описание

int mcal_next_recurrence (int stream, int weekstart, array next)

mcal_next_recurrence() возвращает объект, заполненный следующей датой возникновения события. Возвращает пустое поле даты, если событие не возникает или что-то неправильно. Использует weekstart для определения, какой день считать началом недели.

mcal_open

(PHP 3>= 3.0.13, PHP 4)

mcal_open - открывает MCAL-соединение.

Описание

int mcal_open (string calendar, string username, string password [, int options])

Возвращает MCAL-поток при успехе, FALSE при ошибке.

mcal_open() открывает MCAL-соединение со специфицированным calendar. Если специфицирован необязательный параметр options, передаёт также options в этот mailbox. Структура внутренних событий потока также инициализируется после установления соединения.

mcal_popen

(PHP 3>= 3.0.13, PHP 4)

mcal_popen - открывает постоянное MCAL-соединение.

Описание

int mcal_popen (string calendar, string username, string password [, int options])

Возвращает MCAL-поток при успехе, FALSE - при ошибке.

mcal_popen() открывает MCAL-соединение со специфицированным calendar. Если специфицирован необязательный параметр options, передаёт также options в этот mailbox. Структура внутренних событий потока также инициализируется после установления соединения.

mcal_rename_calendar

(PHP 3>= 3.0.13, PHP 4)

mcal_rename_calendar - переименовывает MCAL-календарь.

Описание

string mcal_rename_calendar (int stream, string old_name, string new_name)

Переименовывает календарь old_name в new_name.

mcal_reopen

(PHP 3>= 3.0.13, PHP 4)

mcal_reopen - повторно открывает MCAL-соединение.

Описание

int mcal_reopen (string calendar [, int options])

Повторно открывает MCAL-поток к новому календарю.

mcal_reopen() повторно открывает MCAL-соединение со специфицированным calendar. Если специфицирован options, также передаёт options в этот mailbox.

mcal_snooze

(PHP 3>= 3.0.13, PHP 4)

mcal_snooze - отключает напоминание для события.

Описание

int mcal_snooze (int id)

mcal_snooze() отключает напоминание/alarm для календарного события id.

Возвращает TRUE.

mcal_store_event

(PHP 3>= 3.0.13, PHP 4)

mcal_store_event - модифицирует существующее событие в MCAL-календаре.

Описание

int mcal_store_event (int mcal_stream)

mcal_store_event() сохраняет модификацию текущего глобального события данного потока.

Возвращает id модифицированного события при успехе, FALSE при ошибке.

mcal_time_valid

(PHP 3>= 3.0.13, PHP 4)

mcal_time_valid - возвращает TRUE, если данные часы, минуты и секунды являются правильным временем.

Описание

int mcal_time_valid (int hour, int minutes, int seconds)

mcal_time_valid() возвращает TRUE, если данные часы, минуты и секунды являются правильным временем, FALSE - если нет.

mcal_week_of_year

(PHP 4)

mcal_week_of_year - возвращает номер недели для данной даты.

Описание

int mcal_week_of_year (int day, int month, int year)

mcrypt_cbc

(PHP 3>= 3.0.8, PHP 4)

mcrypt_cbc - шифрует/дешифрует данные в CBC-режиме.

Описание

string mcrypt_cbc (int cipher, string key, string data, int mode [, string iv])

string mcrypt_cbc (string cipher, string key, string data, int mode [, string iv])

Первый прототип работает при связке с libmcrypt 2.2.x, второй - при связке с libmcrypt 2.4.x или выше.

Эта функция больше не должна использоваться, см. замены: mcrypt_generic() и mdecrypt_generic().

mcrypt_cfb

(PHP 3>= 3.0.8, PHP 4)

mcrypt_cfb - шифрует/дешифрует данные в CFB-режиме.

Описание

string mcrypt_cfb (int cipher, string key, string data, int mode, string iv)

string mcrypt_cfb (string cipher, string key, string data, int mode [, string iv])

Первый прототип работает при связке с libmcrypt 2.2.x, второй - при связке с libmcrypt 2.4.x или выше.

Эта функция больше не должна использоваться, см. замены: mcrypt_generic() и mdecrypt_generic().

mcrypt_create_iv

(PHP 3>= 3.0.8, PHP 4)

mcrypt_create_iv - создаёт вектор инициализации/initialization vector (IV) из произвольного источника.

Описание

string mcrypt_create_iv (int size, int source)

mcrypt_create_iv() используется для создания IV.

mcrypt_create_iv() принимает два аргумента: size определяет размер IV, source специфицирует источник IV.

Источником может быть MCRYPT_RAND (системный генератор случайных чисел),MCRYPT_DEV_RANDOM (читает данные из /dev/random) и MCRYPT_DEV_URANDOM (читает данные из /dev/urandom). Если вы используете MCRYPT_RAND, не забудьте вызывать srand() до инициализации генератора случайных чисел.

mcrypt_decrypt

(PHP 4 >= 4.0.2)

mcrypt_decrypt - дешифрует зашифрованный текст с данными параметрами.

Описание

string mcrypt_decrypt (string cipher, string key, string data, string mode [, string iv])

mcrypt_decrypt() дешифрует данные и возвращает расшифрованные данные.

Cipher эта одна из констант MCRYPT_ciphername имени алгоритма как строки.

Key это ключ, с которым шифрованы данные. Если он меньше требуемого размера ключа, он заполняется '\0'.

Data это данные, которые будут дешифрованы с данным шифром и режимом. Если размер данных не n * blocksize, данные заполняются '\0'.

Mode эта одна из констант MCRYPT_MODE_modename одного из: "ecb", "cbc", "cfb", "ofb", "nofb" или "stream".

Параметр IV используется для инициализации в режимах CBC, CFB, OFB и в некоторых алгоритмах в режиме STREAM. Если вы не предоставляете IV, когда он необходим для алгоритма, функция выдаёт предупреждение и использует IV со всеми байтами, установленными в '\0'.

mcrypt_ecb

(PHP 3>= 3.0.8, PHP 4 )

mcrypt_ecb - шифрует/дешифрует данные в режиме ECB.

Описание

string mcrypt_ecb (int cipher, string key, string data, int mode)

string mcrypt_ecb (string cipher, string key, string data, int mode [, string iv])

Первый прототип - при связке с 2.2.x, второй - при связке с libmcrypt 2.4.x или выше.

Эта функция не должна больше использоваться, см. альтернативы: mcrypt_generic() и mdecrypt_generic().

mcrypt_enc_get_algorithms_name

(PHP 4 >= 4.0.2)

mcrypt_enc_get_algorithms_name - возвращает имя открытого алгоритма.

Описание

string mcrypt_enc_get_algorithms_name (resource td)

Эта функция возвращает имя алгоритма.

mcrypt_enc_get_block_size

(PHP 4 >= 4.0.2)

mcrypt_enc_get_block_size - возвращает размер блока/blocksize открытого алгоритма.

Описание

int mcrypt_enc_get_block_size (resource td)

Эта функция возвращает размер в байтах блока алгоритма, специфицированного дескриптором шифрования td.

mcrypt_enc_get_iv_size

(PHP 4 >= 4.0.2)

mcrypt_enc_get_iv_size - возвращает размер IV открытого алгоритма.

Описание

int mcrypt_enc_get_iv_size (resource td)

Эта функция возвращает размер в байтах iv алгоритма, специфицированного дескриптором шифрования. Если возвращает '0', IV игнорируется в этом алгоритме. IV используется в режимах cbc, cfb и ofb и в некоторых алгоритмах режима stream.

mcrypt_enc_get_key_size

(PHP 4 >= 4.0.2)

mcrypt_enc_get_key_size - возвращает максимальный поддерживаемый размер ключа/keysize открытого режима.

Описание

int mcrypt_enc_get_key_size (resource td)

Эта функция возвращает максимальный поддерживаемый размер в байтах ключа алгоритма td.

mcrypt_enc_get_modes_name

(PHP 4 >= 4.0.2)

mcrypt_enc_get_modes_name - возвращает имя открытого режима.

Описание

string mcrypt_enc_get_modes_name (resource td)

Эта функция возвращает имя режима.

mcrypt_enc_get_supported_key_sizes

(PHP 4 >= 4.0.2)

mcrypt_enc_get_supported_key_sizes - возвращает массив с поддерживаемыми размерами ключа открытого алгоритма.

Описание

array mcrypt_enc_get_supported_key_sizes (resource td)

Возвращает массив с размерами ключа, поддерживаемыми алгоритмом, специфицированным дескриптором шифрования. Если возвращает пустой массив, то алгоритмом поддерживаются все размеры ключа в диапазоне от 1 до mcrypt_enc_get_key_size().

mcrypt_enc_is_block_algorithm

(PHP 4 >= 4.0.2)

mcrypt_enc_is_block_algorithm - проверяет, является ли алгоритм открытого режима блок-алгоритмом.

Описание

bool mcrypt_enc_is_block_algorithm (resource td)

Эта функция возвращает TRUE, если это a block-алгоритм, FALSE - если это алгоритм потока.

mcrypt_enc_is_block_algorithm_mode

(PHP 4 >= 4.0.2)

mcrypt_enc_is_block_algorithm_mode - проверяет, работает ли шифрование открытого режима с блоками.

Описание

bool mcrypt_enc_is_block_algorithm_mode (resource td)

Эта функция возвращает TRUE, если режим предназначен для использования с алгоритмами блока, иначе возвращает FALSE. (Например, FALSE для потока/stream и TRUE для cbc, cfb, ofb).

mcrypt_enc_is_block_mode

(PHP 4 >= 4.0.2)

mcrypt_enc_is_block_mode - проверяет, выводит ли открытый режим блоки.

Описание

bool mcrypt_enc_is_block_mode (resource td)

Эта функция возвращает TRUE, если режим выводит блоки байтов, или FALSE - если выводит байты. (Например, TRUE для cbc и ecb и FALSE - для cfb и потока/stream).

mcrypt_enc_self_test

(PHP 4 >= 4.0.2)

mcrypt_enc_self_test - эта функция запускает самопроверку в открытом модуле.

Описание

bool mcrypt_enc_self_test (resource td)

Эта функция запускает тест самопроверки по алгоритму, специфицированному дескриптором td. Если тест проходит успешно, возвращает FALSE. В случае ошибки возвращает TRUE.

mcrypt_encrypt

(PHP 4 >= 4.0.2)

mcrypt_encrypt - шифрует обычный текст с данными параметрами.

Описание

string mcrypt_encrypt (string cipher, string key, string data, string mode [, string iv])

mcrypt_encrypt() шифрует данные и возвращает шифрованные данные.

Cipher эта одна из констант MCRYPT_ciphername имени алгоритма как строки.

Key это ключ, с которым данные зашифрованы. Если он меньше необходимого размера ключа, он заполняется '\0'. Лучше не использовать ASCII-строки в качестве ключей. Рекомендуется использовать mhash-функции для создания ключа из строки.

Data это данные, шифрованные с заданным шифром и режимом.
Если размер данных не равен n * blocksize, данные будут заполнены '\0'. Возвращаемый зашифрованный текст может быть больше размера данных data.

Mode эта одна из констант MCRYPT_MODE_modename из "ecb", "cbc", "cfb", "ofb", "nofb" или "stream".

Параметр IV используется для инициализации в режимах CBC, CFB, OFB и некоторых алгоритмах режима STREAM. Если вы не предоставляете IV, когда он необходим для алгоритма, функция выдаёт предупреждение и использует IV со всеми байтами, установленными в '\0'.

mcrypt_generic

(PHP 4 >= 4.0.2)

mcrypt_generic - эта функция шифрует данные.

Описание

string mcrypt_generic (resource td, string data)

Эта функция шифрует данные. Данные заполняются "\0", чтобы гарантировать длину данных в n * blocksize. Эта функция возвращает шифрованные данные. Обратите внимание, что длина возвращаемой строки может оказаться больше ввода из-за заполнения.

Дескриптор шифровки должен всегда инициализироваться функцией mcrypt_generic_init() с ключом и IV до вызова данной функции. После выполнения шифрования вы должны освободить буферы шифрования путём вызова mcrypt_generic_deinit(). См. в mcrypt_module_open() пример.

См. также mdecrypt_generic(), mcrypt_generic_init() и mcrypt_generic_deinit().

mcrypt_generic_deinit

(PHP 4 >= 4.1.1)

mcrypt_generic_deinit - деинициализирует модуль шифрования.

Описание

bool mcrypt_generic_deinit (resource td)

Эта функция прерывает шифрование, специфицированное дескриптором шифрования (td). Она очищает все буферы, но не закрывает модуль. Вы самостоятельно должны вызвать mcrypt_module_close(). (Но PHP делает это для вас в конце скрипта.) Возвращает FALSE при ошибке, TRUE при успехе.

См. пример в mcrypt_module_open() и статью о mcrypt_generic_init().

mcrypt_generic_end

(PHP 4 >= 4.0.2)

mcrypt_generic_end - заканчивает шифрование.

Описание

bool mcrypt_generic_end (resource td)

Эта функция не рекомендуется, используйте вместо неё mcrypt_generic_deinit(). Она может вызвать завалы при использовании с mcrypt_module_close() из-за множественных освобождений буферов.

Эта функция заканчивает шифрование, специфицированное дескриптором шифрования (td). Фактически она очищает все буферы и закрывает все используемые модули. Возвращает FALSE при ошибке, TRUE при успехе.

mcrypt_generic_init

(PHP 4 >= 4.0.2)

mcrypt_generic_init - инициализирует все буферы для шифрования.

Описание

int mcrypt_generic_init (resource td, string key, string iv)

Максимальный размер ключа должен быть получен вызовом функции mcrypt_enc_get_key_size(), и каждое значение меньше полученного будет правильным. IV должен нормально иметь размер блока алгоритма, но вы обязаны получить этот размер вызовом mcrypt_enc_get_iv_size(). IV игнорируется в ECB. IV ОБЯЗАН существовать в режимах CFB, CBC, STREAM, nOFB и OFB. Он должен быть случайным и уникальным (но не секретным). Этот же самый IV обязан использоваться для шифрования/дешифрования. Если вы не хотите использовать его, вы должны установить его в нули, но это не рекомендуется. Функция возвращает отрицательное значение при ошибке.

Вам необходимо вызывать эту функцию перед каждым вызовом mcrypt_generic() или mdecrypt_generic().

См. для примера mcrypt_module_open() и вхождение в mcrypt_generic_deinit().

mcrypt_get_block_size

(PHP 3>= 3.0.8, PHP 4)

mcrypt_get_block_size - получает размер блока специфицированного шифра.

Описание

int mcrypt_get_block_size (int cipher)

int mcrypt_get_block_size (string cipher, string module)

Первый прототип - когда связка относительно libmcrypt 2.2.x, второй - когда связка относительно libmcrypt 2.4.x или 2.5.x.

mcrypt_get_block_size() используется для получения размера блока специфицированного шифра cipher (в комбинации с режимом шифрования).

В примере показано, как использовать эту функцию при связывании относительно 2.4.x и 2.5.x.

mcrypt_get_cipher_name

(PHP 3>= 3.0.8, PHP 4)

mcrypt_get_cipher_name - получает имя специфицированного шифра.

Описание

string mcrypt_get_cipher_name (int cipher)

string mcrypt_get_cipher_name (string cipher)

mcrypt_get_cipher_name() используется для получения имени специфицированного шифра.

mcrypt_get_cipher_name() принимает номер шифра в качестве аргумента (libmcrypt 2.2.x) или имя шифра (libmcrypt 2.4.x или новее) и возвращает имя шифра или FALSE, если шифр не существует.

mcrypt_get_iv_size

(PHP 4 >= 4.0.2)

mcrypt_get_iv_size - возвращает размер IV, принадлежащего специфической комбинации шифр/режим.

Описание

int mcrypt_get_iv_size (resource td)

int mcrypt_get_iv_size (string cipher, string mode)

Первый прототип используется при связке с libmcrypt 2.2.x, второй - при связке с libmcrypt 2.4.x или новее.

mcrypt_get_iv_size() возвращает размер Вектора Инициализации/Initialisation Vector (IV) в байтах. При ошибке возвращает FALSE. Если IV игнорируется в специфицированной комбинации шифр/режим, возвращается нуль.

cipher это одна из констант MCRYPT_ciphername имени алгоритма как строка.

mode это одна из констант MCRYPT_MODE_modename одного из режимов: "ecb", "cbc", "cfb", "ofb", "nofb" или "stream".

td это ресурс, возвращаемый функцией mcrypt_module_open().

mcrypt_get_key_size

(PHP 3>= 3.0.8, PHP 4)

mcrypt_get_key_size - получает размер ключа специфицированного шифра.

Описание

int mcrypt_get_key_size (int cipher)

int mcrypt_get_key_size (string cipher, string module)

Первый прототип - при связке с libmcrypt 2.2.x, второй - при связке с libmcrypt 2.4.x или 2.5.x.

mcrypt_get_key_size() используется для получения размера ключа специфицированного шифра cipher (в комбинации с режимом шифрования).

В примере показано, как использовать эту функцию при связке относительно libmcrypt 2.4.x и 2.5.x.

mcrypt_list_algorithms

(PHP 4 >= 4.0.2)

mcrypt_list_algorithms - получает массив всех поддерживаемых шифров.

Описание

array mcrypt_list_algorithms ([string lib_dir])

mcrypt_list_algorithms() используется для получения массива всех поддерживаемых алгоритмов в параметре lib_dir.

mcrypt_list_algorithms() принимает необязательный параметр lib_dir, который специфицирует директорию размещения всех алгоритмов. Если не специфицирован, используется значение php.ini-директивы mcrypt.algorithms_dir.

mcrypt_list_modes

(PHP 4 >= 4.0.2)

mcrypt_list_modes - получает массив всех поддерживаемых режимов.

Описание

array mcrypt_list_modes ([string lib_dir])

mcrypt_list_modes() используется для получения массива из всех поддерживаемых режимов в lib_dir.

mcrypt_list_modes() принимает в качестве необязательного параметра директорию lib_dir, где находятся все режимы. Если не он не специфицирован, используется значение php.ini-директивы mcrypt.modes_dir php.ini.

mcrypt_module_close

(PHP 4 >= 4.0.2)

mcrypt_module_close - закрывает mcrypt-модуль.

Описание

bool mcrypt_module_close (resource td)

Эта функция закрывает специфицированный дескриптор шифровки.

См. пример в mcrypt_module_open().

mcrypt_module_get_algo_block_size

(PHP 4 >= 4.0.2)

mcrypt_module_get_algo_block_size - возвращает blocksize специфицированного алгоритма.

Описание

int mcrypt_module_get_algo_block_size (string algorithm [, string lib_dir])

Эта функция возвращает размер блока, в байтах, специфицированного алгоритма. Необязательный параметр lib_dir может содержать местонахождение модуля режимов в системе.

mcrypt_module_get_algo_key_size

(PHP 4 >= 4.0.2)

mcrypt_module_get_algo_key_size - возвращает максимальный поддерживаемый размер ключа/keysize открытого режима.

Описание

int mcrypt_module_get_algo_key_size (string algorithm [, string lib_dir])

Эта функция возвращает в байтах размер ключа специфицированного алгоритма. Необязательный параметр lib_dir может содержать местонахождение модуля режимов в системе.

mcrypt_module_get_supported_key_sizes

(PHP 4 >= 4.0.2)

mcrypt_module_get_supported_key_sizes - возвращает массив с поддерживаемыми keysize открытого алгоритма.

Описание

array mcrypt_module_get_supported_key_sizes (string algorithm [, string lib_dir])

Возвращает массив с размерами ключа, поддерживаемыми специфицированным алгоритмом. Если возвращает пустой массив, то все размеры ключей в диапазоне от 1 до mcrypt_module_get_algo_key_size() поддерживаются этим алгоритмом. Необязательный параметр lib_dir может содержать местонахождение модуля режимов в системе.

См. также mcrypt_enc_get_supported_key_sizes(), которая используется при открытых модулях шифровки.

mcrypt_module_is_block_algorithm

(PHP 4 >= 4.0.2)

mcrypt_module_is_block_algorithm - эта функция проверяет, является ли специфицированный алгоритм алгоритмом блока.

Описание

bool mcrypt_module_is_block_algorithm (string algorithm [, string lib_dir])

Эта функция возвращает TRUE, если специфицированный алгоритм является block-алгоритмом, либо FALSE - если это алгоритм потока. Необязательный параметр lib_dir может содержать местоположение модуля алгоритмов в системе.

mcrypt_module_is_block_algorithm_mode

(PHP 4 >= 4.0.2)

mcrypt_module_is_block_algorithm_mode - эта функция сообщает, является специфицированный режим block-алгоритмом, или нет.

Описание

bool mcrypt_module_is_block_algorithm_mode (string mode [, string lib_dir])

Эта функция возвращает TRUE, если режим предназначен для использования с block-алгоритмами, иначе возвращает FALSE. (Например, FALSE для потока/stream, TRUE для cbc, cfb, ofb). Необязательный параметр lib_dir может содержать местоположение модуля режимов в системе.

mcrypt_module_is_block_mode

(PHP 4 >= 4.0.2)

mcrypt_module_is_block_mode - эта функция возвращает, выводит ли специфицированный режим блоки, или нет.

Описание

bool mcrypt_module_is_block_mode (string mode [, string lib_dir])

Эта функция возвращает TRUE, если режим выводит блоки байтов, либо FALSE, если выводит просто байты. (Например, TRUE для cbc и ecb, FALSE для cfb и stream). Необязательный параметр lib_dir может содержать местоположение модуля режимов в системе.

mcrypt_module_open

(PHP 4 >= 4.0.2)

mcrypt_module_open - эта функция открывает модуль алгоритма и используемый режим.

Описание

resource mcrypt_module_open (string algorithm, string algorithm_directory, string mode, string mode_directory)

Эта функция открывает модуль алгоритма и используемый режим. Имя алгоритма специфицируется в параметре algorithm, например, "twofish", или является одной из констант MCRYPT_ciphername. Модуль закрывается вызовом функции mcrypt_module_close(). Нормально возвращается дескриптор шифрования, FALSE - при ошибке.

algorithm_directory и mode_directory используются для локализации модулей шифрования. Если вы предоставили имя директории, используется оно. Если вы установите в один из этих параметров пустую строку (""), используется значение ini-директивы mcrypt.algorithms_dir или mcrypt.modes_dir. Если они не установлены, используются директории по умолчанию, которые были скомпилированы для libmcrypt (обычно это /usr/local/lib/libmcrypt).

mcrypt_module_self_test

(PHP 4 >= 4.0.2)

mcrypt_module_self_test - эта функция запускается как самопроверка в специфицированном модуле.

Описание

bool mcrypt_module_self_test (string algorithm [, string lib_dir])

Запускается как самопроверка при специфицированном алгоритме. Необязательный параметр lib_dir может содержать местонахождение модуля алгоритмов в системе.

Функция возвращает TRUE, если самопроверка прошла успешно, иначе FALSE.

mcrypt_ofb

(PHP 3>= 3.0.8, PHP 4 )

mcrypt_ofb - шифрует/дешифрует данные в режиме OFB.

Описание

string mcrypt_ofb (int cipher, string key, string data, int mode, string iv)

string mcrypt_ofb (string cipher, string key, string data, int mode [, string iv])

Первый прототип - при связке с libmcrypt 2.2.x, второй - при связке с libmcrypt 2.4.x или новее.

Эта функция не должна использоваться, см. замещения в mcrypt_generic() и mdecrypt_generic().

md5

(PHP 3, PHP 4)

md5 - высчитывает md5-хэш строки.

Описание

string md5 (string str)

Высчитывает MD5-хэш для str, используя RSA Data Security, Inc. MD5 Message-Digest Algorithm и возвращает этот хэш. Хэш это 32-символьное 16-ричное число.

См. также crc32() и md5_file().

md5_file

(PHP 4 >= 4.2.0)

md5_file - высчитывает md5-хэш данного файла.

Описание

string md5_file (string filename)

Высчитывает MD5-хэш специфицированного filename с использованием RSA Data Security, Inc. MD5 Message-Digest Algorithm и возвращает этот хэш.

Эта функция имеет то же назначение, что и утилита командной строки md5sum.

См. также md5() и crc32().

mdecrypt_generic

(PHP 4 >= 4.0.2)

mdecrypt_generic - эта функция дешифрует данные.

Описание

string mdecrypt_generic (resource td, string data)

Эта функция дешифрует данные. Обратите внимание, что длина возвращаемой строки может оказаться больше, чем длина нешифрованной, из-за заполнения данными.

Пример 1. mdecrypt_generic()

metaphone

(PHP 4)

metaphone - высчитывает metaphone-ключ строки.

Описание

string metaphone (string str)

Высчитывает metaphone-ключ для str.

Как и soundex(), metaphone создаёт тот же ключ с похожими звучащими словами. Она точнее, чем soundex(), поскольку знает базовые правила английского произношения. Ключи, генерируемые функцией metaphone, имеют длину переменной.

Метафон разработал Lawrence Philips <lphilips@verity.com>. Это описано в ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].

method_exists

(PHP 4)

method_exists - проверяет существование метода класса.

Описание

bool method_exists (object object, string method_name)

Эта функция возвращает TRUE, если метод, заданный в method_name, был определён для данного object, иначе FALSE.

mhash

(PHP 3>= 3.0.9, PHP 4)

mhash - вычисляет хэш.

Описание

string mhash (int hash, string data [, string key])

mhash() применяет хэш-функцию hash к данным data и возвращает результирующий хэш (называемый также digest/дайджест). Если key специфицирован, возвращается результирующий HMAC. HMAC это хэширование с ключам для аутентификации сообщения, либо просто дайджест сообщения, который зависит от специфицированного ключа. Не все алгоритмы, поддерживаемые в mhash, могут использоваться в режиме HMAC. При ошибке возвращает FALSE.

mhash_count

(PHP 3>= 3.0.9, PHP 4)

mhash_count - получает наивысший доступный hash id.

Описание

int mhash_count (void)

mhash_count() возвращает наивысший доступный id хэша. Хэши нумеруются от 0 до этого hash id.

mhash_get_block_size

(PHP 3>= 3.0.9, PHP 4)

mhash_get_block_size - получает размер блока специфицированного хэша.

Описание

int mhash_get_block_size (int hash)

mhash_get_block_size() используется для получения размера блока специфицированного хэша hash.

mhash_get_block_size() принимает один аргумент, hash, и возвращает размер блока в байтах или FALSE, если hash не существует.

mhash_get_hash_name

(PHP 3>= 3.0.9, PHP 4)

mhash_get_hash_name - получает имя специфицированного хэша.

Описание

string mhash_get_hash_name (int hash)

mhash_get_hash_name() используется для получения имени специфицированного хэша.

mhash_get_hash_name() принимает id хэша в качестве аргумента и возвращает имя хэша или FALSE, если хэш не существует.

mhash_keygen_s2k

(PHP 4 >= 4.0.4)

mhash_keygen_s2k - генерирует ключ/key.

Описание

string mhash_keygen_s2k (int hash, string password, string salt, int bytes)

mhash_keygen_s2k() генерирует ключ длиной bytes из заданного пользователем пароля. Это алгоритм Salted S2K, как специфицировано в документе OpenPGP (RFC 2440). Этот алгоритм будет использовать алгоритм специфицированного hash для создания ключа.
Параметр salt обязан отличаться и быть достаточно произвольным для каждого ключа, генерируемого вами, чтобы создавать разные ключи. Этот salt обязан быть известен, когда вы проверяете ключи; таким образом, неплохо будет присоединять ключ к нему. Salt имеет фиксированный размер в 8 байтов и будет заполняться нулями, если вы предоставите меньшее количество байтов.

Помните, что предоставляемые пользовательские пароли реально не подходят для использования в качестве ключей в алгоритмах криптографии, поскольку пользователи выбирают ключи, которые они могут ввести с клавиатуры. Эти пароли используют только от 6 до 7 бит на символ (или менее). Настоятельно рекомендуем использовать какую-нибудь трансформацию (вроде этой функции) предоставляемого пользователем ключа.

microtime

(PHP 3, PHP 4)

microtime - возвращает текущий UNIX timestamp с микросекундами.

Описание

string microtime (void)

Возвращает строку "msec sec", где sec это текущее время, измеренное в секундах Unix Epoch (начиная с 0:00:00 January 1, 1970 GMT), а msec это микросекунды. Эта функция доступна только в ОС, поддерживающих системный вызов gettimeofday().

Обе части этой строки возвращаются в единицах секунд.

mime_content_type

(только PHP 4 CVS)

mime_content_type - определяет MIME Content-type файла.

Описание

string mime_content_type (string filename)

Возвращает MIME content type/тип содержимого файла, как определено через использование информации из файла magic.mime. Типы содержимого возвращаются в формате MIME, например, text/plain или application/octet-stream.

min

(PHP 3, PHP 4)

min - находит наименьшее значение.

Описание

number min (number arg1, number arg2 [, ...])

number min (array numbers)

min() возвращает наименьшее из численных значений параметра.

В первом варианте вам нужно как минимум два параметра, а min() возвращает наименьшее из этих значений. Вы можете сравнивать неограниченное количество значений. Если одна из переменных undefined/не определена, min() терпит неудачу.

Во втором варианте min() возвращает наименьшее значение из массива numbers.

Если одно или более значений float, все значения рассматриваются как floats/числа с плавающей точкой, и возвращается также float. Если ни одно из значений не float, все они рассматриваются как integer, и возвращается также integer. При неудаче min() возвращает NULL, и генерируется сообщение об ошибке уровня E_WARNING.

ming_setcubicthreshold

(PHP 4 >= 4.0.5)

ming_setcubicthreshold - устанавливает cubic threshold (?).

Описание

void ming_setcubicthreshold (int threshold)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ming_setscale

(PHP 4 >= 4.0.5)

ming_setscale - устанавливает шкалу/масштаб (?).

Описание

void ming_setscale (int scale)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ming_useswfversion

(PHP 4 >= 4.2.0)

ming_useswfversion - использует SWF-версию (?).

Описание

void ming_useswfversion (int version)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

mkdir

(PHP 3, PHP 4)

mkdir - создаёт директорию.

Описание

int mkdir (string pathname, int mode)

Пытается создать директорию, специфицированную параметром pathname.

Заметьте, что вам, скорее всего, понадобится специфицировать режим/mode как 8-ричное число, т.е. оно должно иметь ведущий нуль. Этот mode также модифицируется текущей umask, которую можно изменить с помощью функции umask().

mkdir ("/path/to/my/dir", 0700);

Возвращает TRUE при успехе, FALSE при неудаче.

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

mktime

(PHP 3, PHP 4)

mktime - получает UNIX timestamp даты.

Описание

int mktime (int hour, int minute, int second, int month, int day, int year [, int is_dst])

Предупреждение!: Обратите внимание на необычный порядок аргументов, который отличается от порядка аргументов в обычном вызове UNIX mktime() и который не выстраивает параметры справа налево (см. далее). Обычной ошибкой является смешивание этих значений в скрипте.

Возвращает Unix timestamp, соответствующий заданным аргументам. Этот timestamp является длинным целым/long integer, содержащим количество секунд между началом Unix Epoch (January 1 1970) и специфицированным временем.

Аргументы могут быть пропущены в порядке справа налево; любой пропущенный аргумент получит текущее значение в соответствии с локальной датой и временем.

is_dst может быть установлен в 1, если это период с поправкой на летнее время, в 0 - если нет, или -1 (по умолчанию), если не известно, находится данное время в периоде с поправкой на летнее время или нет. Если это не известно, PHP пытается определить это сам. Это может привести к неожиданным (но не некорректным) результатам.

Примечание: is_dst был введён в версии 3.0.10.

mktime() используется для перевода даты в арифметическое значение и проверки, поскольку автоматически будет вычисляться корректное значение для ввода вне диапазона значений. Например, каждая из следующих строк произведёт строку "Jan-01-1998".

Пример 1. mktime()
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));

Year может быть двух- или 4-значным значением со значениями 0-69, отображающимися как 2000-2069, и 70-99 - как 1970-1999 (в системах, где time_t это 32-битное знаковое целое, как в большинстве современных систем, правильным диапазоном year будет примерно 1902-2037).

Последний день данного месяца может быть выражен как "0" следующего месяца, а не как -1. Оба следующих примера дадут строку "The last day in Feb 2000 is: 29".

Пример 2. Последний день следующего месяца
$lastday = mktime (0,0,0,3,0,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
$lastday = mktime (0,0,0,4,-31,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);

Дата с year, month и day, равными нулю, рассматривается как недопустимая.

См. также date() и time().

move_uploaded_file

(PHP 4 >= 4.0.3)

move_uploaded_file - перемещает загруженный файл в новое место.

Описание

bool move_uploaded_file (string filename, string destination)

Эта функция проверяет, является ли файл filename правильно загруженным файлом (что он был загружен через PHP-механизм HTTP POST). Если файл является правильным, он будет переименован в файл destination.

Если filename не является правильно загруженным файлом, акции не будет, а move_uploaded_file() возвратит FALSE.

Если filename является правильно загруженным файлом, но не может быть перемещён по каким-то причинам, акции не будет, а move_uploaded_file() возвратит FALSE. Кроме того, будет выдано предупреждение.

Этот вид проверки особенно важен, если имеется вероятность того, что какие-нибудь действия с загруженными файлами могут сделать его содержимое доступным пользователю или даже другим пользователям в той же системе.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(ы)/директории, с которыми вы собираетесь работать, тот же UID, что и выполняемый скрипт.

Примечание: на move_uploaded_file() не действуют нормальные safe-mode UID-ограничения. Это не небезопасно, поскольку move_uploaded_file() работает только с файлами, загруженными через PHP.

Предупреждение!Если файл назначения уже существует, он будет перезаписан.

См. также в is_uploaded_file() и в разделе Обработка загрузки файлов пример простого использования.

msession_connect

(PHP 4 >= 4.2.0)

msession_connect - соединяет с msession-сервером.

Описание

bool msession_connect (string host, string port)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_count

(PHP 4 >= 4.2.0)

msession_count - получает счёт сессии.

Описание

int msession_count (void)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_create

(PHP 4 >= 4.2.0)

msession_create - создаёт сессию.

Описание

bool msession_create (string session)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_destroy

(PHP 4 >= 4.2.0)

msession_destroy - разрушает сессию.

Описание

bool msession_destroy (string name)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_disconnect

(PHP 4 >= 4.2.0)

msession_disconnect - закрывает соединение с msession-сервером.

Описание

void msession_disconnect (void)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_find

(PHP 4 >= 4.2.0)

msession_find - находит значение.

Описание

array msession_find (string name, string value)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_get

(PHP 4 >= 4.2.0)

msession_get - получает значение из сессии.

Описание

string msession_get (string session, string name, string value)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_get_array

(PHP 4 >= 4.2.0)

msession_get_array - получает массив ... ?

Описание

array msession_get_array (string session)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_getdata

(unknown)

msession_getdata - получает данные ... ?

Описание

string msession_getdata (string session)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_inc

(PHP 4 >= 4.2.0)

msession_inc - выполняет инкремент значения в сессии.

Описание

string msession_inc (string session, string name)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_list

(PHP 4 >= 4.2.0)

msession_list - список ... ?

Описание

array msession_list (void)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_listvar

(PHP 4 >= 4.2.0)

msession_listvar - список сессий с переменной.

Описание

array msession_listvar (string name)

Возвращает ассоциативный массив значения, сессии для всех сессий с переменной name.

Используется для поиска сессий с общими атрибутами.

msession_lock

(PHP 4 >= 4.2.0)

msession_lock - блокирует сессию.

Описание

int msession_lock (string name)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_plugin

(PHP 4 >= 4.2.0)

msession_plugin - вызывает escape-функцию внутри компонента msession personality.

Описание

string msession_plugin (string session, string val [, string param])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_randstr

(PHP 4 >= 4.2.0)

msession_randstr - получает произвольную строку.

Описание

string msession_randstr (int param)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_set

(PHP 4 >= 4.2.0)

msession_set - устанавливает значение в сессии.

Описание

bool msession_set (string session, string name, string value)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_set_array

(PHP 4 >= 4.2.0)

msession_set_array - устанавливает массив из ...

Описание

bool msession_set_array (string session, array tuples)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_setdata

(unknown)

msession_setdata - устанавливает данные ... ?

Описание

bool msession_setdata (string session, string value)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_timeout

(PHP 4 >= 4.2.0)

msession_timeout - устанавливает/получает таймаут сессии.

Описание

int msession_timeout (string session [, int param])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_uniq

(PHP 4 >= 4.2.0)

msession_uniq - получает uniq id.

Описание

string msession_uniq (int param)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msession_unlock

(PHP 4 >= 4.2.0)

msession_unlock - разблокирует сессию.

Описание

int msession_unlock (string session, int key)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

msg_get_queue

(только PHP 4 CVS)

msg_get_queue - создаёт или присоединяет к очереди сообщений.

Описание

int msg_get_queue (int key [, int perms])

msg_get_queue() возвращает id, который может использоваться для доступа к очереди сообщений System V с данным ключом key. Первый вызов создаёт очередь сообщений с необязательным perms (по умолчанию: 0666). Второй вызов msg_get_queue() с тем же key возвратит другой идентификатор очереди сообщений, но оба идентификатора дают доступ к одной и той же очереди сообщений. Если очередь уже существует, perms будет проигнорирован.

См. также msg_remove_queue(), msg_receive(), msg_send(), msg_stat_queue() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.

msg_receive

(только PHP 4 CVS)

msg_receive - получает сообщение из очереди сообщений.

Описание

bool msg_receive (int queue, int desiredmsgtype, int msgtype, int maxsize, mixed message [, bool unserialize [, int flags [, int errorcode]]])

msg_receive() получает первое сообщение из специфицированной очереди queue типа desiredmsgtype. Тип полученного сообщения будет храниться в msgtype. Максимальный размер принимаемого сообщения специфицируется параметром maxsize; если сообщение в очереди больше, чем этот размер, функция потерпит неудачу (если вы не установили flags, как описано ниже). Получаемое сообщение будет сохранено в message, если не было ошибок при получении сообщения - тогда в необязательный errorcode будет установлено значение системной переменной errno, что поможет вам идентифицировать причину.

Если desiredmsgtype равен 0, возвращается сообщение из начала очереди. Если desiredmsgtype больше 0, возвращается первое сообщение данного типа. Если desiredmsgtype меньше 0, будет прочитано первое сообщение в очереди с наименьшим типом, меньше и равным абсолютному значению desiredmsgtype. Если нет сообщений, соответствующих этому критерию, ваш скрипт будет ожидать, пока подходящее сообщение не дождётся своей очереди. Вы можете предотвратить блокировку скрипта, специфицировав MSG_IPC_NOWAIT в параметре flags.

unserialize имеет по умолчанию TRUE; если установлен TRUE, сообщение рассматривается как если бы оно было сериализовано с использованием того же механизма, что и в модуле сессии. Сообщение будет десериализовано и возвращено вашему скрипту. Это даёт возможность легко получать массивы или сложные структуры объектов их других PHP-скриптов или, если вы используете WDDX-сериализатор, из любого WDDX-совместимого источника. Если unserialize равен FALSE, сообщение будет возвращено как binary-safe строка.

Необязательный параметр flags даёт вам возможность передавать флаги низкоуровневому системному вызову msgrcv. По умолчанию равен 0, но вы можете специфицировать одно или более из следующих значений (складывая или OR'ируя их вместе).

Таблица 1. Значения флагов для msg_receive
MSG_IPC_NOWAITЕсли нет сообщений типа desiredmsgtype, возвращает немедленно и не ожидает. Функция терпит неудачу и возвращает integer-значение, соответствующее ENOMSG.MSG_EXCEPTИспользование этого флага в сочетании с desiredmsgtype больше 0 заставляет функцию получать первое сообщение, которое не равно desiredmsgtype.MSG_NOERRORЕсли сообщение длиннее maxsize, установка этого флага усекает сообщение до maxsize и не сигнализирует об ошибке.

При успешном выполнении структура данных очереди обновляется так:
msg_lrpid получает process-ID вызывающего процесса,
msg_qnum декрементирует на 1,
а в msg_rtime устанавливается текущее время.

msg_receive() возвращает TRUE при успехе, FALSE при неудаче. Если функция терпит неудачу, необязательный errorcode получит значение системной переменной errno.

См. также msg_remove_queue(), msg_send(), msg_stat_queue() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.

msg_remove_queue

(только PHP 4 CVS)

msg_remove_queue - разрушает очередь сообщений.

Описание

bool msg_remove_queue (int queue)

msg_remove_queue() разрушает очередь сообщений queue. Используйте эту функцию, только когда все процессы закончили работу с этой очередью сообщений и вам нужно освободить системные ресурсы, удерживаемые ею.

См. также msg_receive(), msg_stat_queue() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.

msg_send

(только PHP 4 CVS)

msg_send - отправляет сообщение в очередь сообщений.

Описание

bool msg_send (int queue, int msgtype, mixed message [, bool serialize [, bool blocking [, int errorcode]]])

msg_send() отправляет сообщение message типа msgtype (который ОБЯЗАН быть больше 0) в очередь сообщений queue.

Если сообщение слишком большое, чтобы вместиться в очередь, ваш скрипт будет ожидать, пока другой процесс не прочтёт сообщения из очереди и не освободит достаточно пространства для пересылки вашего сообщения. Это называется блокировкой; вы можете предотвратить блокировку, установив необязательный параметр blocking в FALSE; в этом случае msg_send() немедленно возвратит FALSE, если сообщение слишком велико для очереди, и установит необязательный errorcode в EAGAIN, указывая на то, что вы должны попытаться отправить сообщение снова немного позднее.

Необязательный параметр serialize контролирует то, как сообщение message отправляется. serialize по умолчанию имеет значение TRUE, т.е. message сериализуется с использованием того же механизма, что и в модуле сессии, перед отправкой в очередь. Это позволяет отправлять сложные массивы и объекты другим PHP-скриптам или, если вы используете WDDX-сериализатор, - любому WDDX-совместимому клиенту.

При успешном выполнении структура очереди сообщений обновляется так: в msg_lspid устанавливается process-ID вызывающего  процесса, msg_qnum увеличивается на 1, а в msg_stime устанавливается текущее время.

См. также msg_remove_queue(), msg_receive(), msg_stat_queue() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.

msg_set_queue

(только PHP 4 CVS)

msg_set_queue - устанавливает информацию в структуре данных очереди сообщений.

Описание

bool msg_set_queue (int queue, array data)

msg_set_queue() позволяет изменять значения полей msg_perm.uid, msg_perm.gid, msg_perm.mode и msg_qbytes структуры данных очереди сообщений. Вы специфицируете нужные значения путём установки нужных значений ключей в массиве data.

Изменение структуры данных потребует запуска PHP под тем же пользователем, который создал очередь, владеет очередью (как определено существующими полями msg_perm.xxx), или с запуска привилегиями root.
Привилегии root необходимы для увеличения значений msg_qbytes выше системных ограничений.

См. также msg_remove_queue(), msg_receive(), msg_stat_queue().

Эта функция была введена в PHP 4.3.0 (ещё не выпущен).

msg_stat_queue

(только PHP 4 CVS)

msg_stat_queue - возвращает информациб из структуры данных очереди сообщений.

Описание

array msg_stat_queue (int queue)

msg_stat_queue() возвращает метаданные очереди сообщений queue. Это используется, например, для определения того, который процесс отправил только что полученное сообщение.

return-значением является массив, ключи и значения которого таковы:

Таблица 1. Структура массива для msg_stat_queue
msg_perm.uiduid владельца очереди.msg_perm.gid gid владельца очереди.msg_perm.modeрежим доступа к файлу в очереди. msg_stimeвремя отправки последнего сообщения в очередь.msg_rtime время получения последнего сообщения из очереди.msg_ctimeвремя последнего изменения очереди. msg_qnumколичество сообщений в очереди, ожидающих прочтения. msg_qbytesколичество байт, пространства, доступного в очереди в данный момент для хранения отправленных сообщений, пока они не будут получены.msg_lspid pid процесса, отправившего последнее сообщение в очередь.msg_lrpid pid процесса, отправившего последнее сообщение из очереди.

См. также msg_remove_queue(), msg_receive() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.