[edit] Last updated: Fri, 25 May 2012

msg_send

(PHP 4 >= 4.3.0, PHP 5)

msg_send — メッセージキューにメッセージを送信する

説明

bool msg_send ( resource $queue , int $msgtype , mixed $message [, bool $serialize = true [, bool $blocking = true [, int &$errorcode ]]] )

msg_send() は、queue で指定したメッセージキューに対して msgtype で指定した型 (0 より大きい数値である必要があります) のメッセージ message を送信します。

パラメータ

queue
msgtype
message
serialize: オプションのパラメータ serialize は、 message を送信する方法を制御します。 serialize のデフォルト値は TRUE で、この場合 message が送信される前にセッションモジュールと同じ方法でシリアライズされます。これにより、配列やオブジェクトのような複雑な形式のデータを他の PHP スクリプトに送信することが可能となります。また、もし WDDX シリアライザを使用しているなら、あらゆる WDDX 互換クライアントに対して同じことが可能となります。
blocking: メッセージがキューに収まらないほど大きい場合は、他のプロセスが現在キューにあるメッセージを読み込んでキューの空き容量が確保されるまでスクリプトの実行を待ち続けます。これをブロックモードといいます。オプションのパラメータ blocking を FALSE に設定することでブロックモードではなくすることが可能で、この場合、もしキューの空き容量よりも大きなメッセージを送信すると msg_send() はすぐに FALSE を返します。また、オプションのパラメータ errorcode を MSG_EAGAIN に設定すると、少し時間をおいてメッセージを再度送信しなければならないことが戻り値からわかります。
errorcode

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

処理が正常に完了すると、メッセージキューデータ構造体は以下のように更新されます。 msg_lspid には呼び出し元のプロセス ID が設定され、msg_qnum が 1 増加し、 msg_stime が現在の時刻に設定されます。

参考

msg_remove_queue() - メッセージキューを破棄する
msg_receive() - メッセージキューからメッセージを受信する
msg_stat_queue() - メッセージキューデータ構造体の情報を返す
msg_set_queue() - メッセージキューデータ構造体の情報を設定する

msg_set_queue

msg_remove_queue

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes msg_send

michael dot NO dot SP dot AM dot cordover+php at gmail dot com 16-Oct-2009 01:10


After about an hour of debugging I've discovered the meaning of the undocumented "PHP Warning: msg_send(): msgsnd failed: Invalid argument" ($errorcode = 13).



This occurred when the size of $message was larger than msg_qbytes (see msg_stat_queue() for how to determine and change msg_qbytes).

shepik at yandex dot ru 02-Jul-2009 04:04


$msgtype used in msg_send function can be any positive integer.

bryan-boone at msn dot com 15-May-2008 12:39


I think it is kinda lame why I cannot find out (easily) explicitly which types of messages are allowed and which ones are not.  Maybe we can start our own little list.  I know that strings work, and arrays do not.

webmaster at toolshed51 dot com 10-Apr-2003 12:51


Sample sending webpage, see msg_receive for matching service



<?php

    $MSGKEY = 519051;



    $msg_id = msg_get_queue ($MSGKEY, 0600);



    if (!msg_send ($msg_id, 1, 'Hi', true, true, $msg_err))

        echo "Msg not sent because $msg_err\n";

?>

add a note