(PHP 4 >= 4.3.0, PHP 5)
msg_send — Eviar un mensaje a una cola de mensajes
$queue
, int $msgtype
, mixed $message
[, bool $serialize = true
[, bool $blocking = true
[, int &$errorcode
]]] )
msg_send() envía un message del tipo
msgtype (DEBE ser mayor que 0) a
la cola de mensajes especificada por queue.
queue
msgtype
message
serialize
El parámetro opcional serialize controla el modo de
enviar el mensaje dado por message. serialize
es por defecto TRUE lo que significa que message es
serializado usando el mismo mecanismo que el módulo de sesión antes de ser
enviado a la cola. Esto permite matrices y objetos complejos para ser enviados a
otros scripts de PHP, o si se está usando el serializador WDDX, para cualquier
cliente compatible con WDDX.
blocking
Si el mensaje es demasiado largo para caber en la cola el script esperará
hasta que otro proceso lea los mensajes de la cola y libere sufieciente
espacio para el mensaje que se va a enviar.
Esto se llama bloqueo; se puede prevenir el bloqueo estableciendo el
parámetro blocking a FALSE, en cuyo
caso msg_send() devolverá inmediatamente FALSE si el
mensaje es demasiado grande para la cola, y establecerá el parámetro opcional
errorcode a MSG_EAGAIN,
indicando que se debería intentar enviar el mensaje de nuevo un poco
más tarde.
errorcode
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Al finalizar con éxito, la estructura de datos de la cola de mensajes se actualiza como
sigue: msg_lspid se establece al ID del proceso de
llamada, msg_qnum se incrementa en 1 y
msg_stime se establece al momento actual.