(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
msg_send — Eviar un mensaje a una cola de mensajes
$queue
,$msgtype
,$message
,$serialize
= true,$blocking
= true,&$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.