rabbit以及php amqp擴展使用

一定要注意php安裝AMQP的版本，版本不同使用的方法不一樣。在官方網站就有2個版本的AMQP
第一版本：xxx，詳細的url找不到了
第二版本：http://docs.php.net/manual/da/book.amqp.php
千萬不要出現這種情況，找到一個官方的版本，然後按照example，怎麼調試都不通….按照PHP安裝 AMQP擴展安裝的AMQP擴展是最新的，現在和PHP官方給出的第二版本，也有一些區別。主要體現在exchange和queue中有個declare的方法，分別更改成declarExchange()和declarQueue().

一、AMQPConnection

::__construct ([ array $credentials = array() ] )

這方法比較簡單，credentials的英文含義是“憑證”，但我喜歡把它理解爲config。這些配置包括如下：
host、vhost、port、login、password、read_timeout、write_timeout、connect_timeout，如果config省略，php會使用默認的這5個值，初始化，強烈建議帶上config初始化，其中read_timeout、write_timeout、connect_timeout這三個值是最新版本纔有的，PHP官方現在還沒有，單位都是(秒)

::connect ( void ) 、 ::pconnect ( void )
::disconnect ( void ) 、::pdisconnect ( void )
::reconnect ( void ) 、::preconnect ( void ) #注意和__construct 的區別，該方法不帶參數。
::isConnected ( void )
::isPersistent ( void ) #是否持久鏈接，爲什麼不是isPconnected ？-_-

如果使用持久鏈接，在類方法__destruct中釋放(斷開鏈接)

::setHost ( string $host )
::setPort ( int $port )
::setVhost ( string $vhost )
::setLogin ( string $login )
::setPassword ( string $password )
::getHost ( void )
::getPort ( void )
::getVhost ( void )
::getLogin ( void )
::getPassword ( void )
還有類似的::setTimeout ( int $timeout ) 、::getTime ( void )、::getReadTimeout ( void )、::setReadTimeout ( int $timeout )、::getWriteTimeout (void ) 、setWriteTimeout ( int $timeout)

上面的這些方法，就不細說了，還有2個不常見的方法

::getUsedChannels ( void ) #在鏈接會話期間最後一次使用的channel id
::getMaxChannels ( void ) #單次鏈接能創建最大channel數量

二、AMQPChannel

爲了一個AMQP的鏈接，創建一個channel instance（通道實例），這裏需要了解一下幾個概念，以及她們之間的關係，本人做了一個羅列，水平有限，不對的地方請指正。

client ：客戶端Broker：英文含義是代理，這裏指代理服務器，也是通常說的server，也可以指Rabbit cluster的節點，
也就是在AMQPConnection的配置文件中的host、portvirtual_host：虛擬host，這個可以理解爲在Broker中，虛擬出來的消息處理模塊。一個Broker中
可以創建多個virtual_host.exchange：邏輯上屬於virtual_host的子模塊，負責消息轉發到queue中。queue：邏輯上屬於virtual_host的子模塊。channel：通道。鏈接virtual_host的通道。
routingkey：virtual_host和channel的設置都是爲了增加併發性能，降低資源消耗的。
參考文章：RabbitMQ中的AMQP協議規範

::__construct ( AMQPConnection $amqp_connection ) ＃創建channel
::isConnected ( void ) ＃這裏和AMQPConnection::isConnected一樣.

::getConnection ( void )
＃返回的結果是AMQPConnection，從概念上個人理解，channel是建立在connection之上的，是個獨立的鏈接。connection是指物理的連接，一個client與一個server之間有一個連接；一個連接上可以建立多個channel，可以理解爲邏輯上的連接。一般應用的情況下，有一個channel就夠用了，不需要創建更多的channel

::getChannelId ( void )
＃返回channel id，在PHP中循環創建通道，發現通道ID始終只有1和2，不知是否和服務器的設置有關？

::setPrefetchSize ( int $size )、::getPrefetchSize ( void )
這個地方有個坑，設置prefetchSize不等於0，會提示not_implemented: “prefetch_size!=0 (65535)”，也就是說目前prefetchSize只能設置爲0，還未實現不等於0的情況。

::setPrefetchCount ( int $count )、::getPrefetchCount ( void )
這個參數設置，接收消息端，接收的最大消息數量（包括使用get、consume）,一旦到達這個數量，客戶端不在接收消息。0爲不限制。默認值爲3.

::qos ( int $size , int $count )
同時設置prefetchSize、prefetchCount，但prefetchSize目前只能設置爲0

::basicRecover ( boolen )
默認爲true，沒有確認的消息會被再次投遞，這個地方和消息確認機制有關，後面再來說這個問題。

三、 AMQPExchange

::__construct ( AMQPChannel $amqp_channel )

::setName ( string $exchange_name )、::getName ( void )
這個命令的最好使用數字、字母、- _ . 組合(區分大小寫，但最好使用小寫)
也不要使用amq帶頭（內置的exchange都是使用amq.開頭）
如果申明一個已存在的exchange name，如果type不一致會拋出異常.

::setType ( string $exchange_type )、::getType ( void )
這個是rabbitmq的核心，exchange的類型，決定了rabbit實現何種業務模型。
這個地方尤其要注意，AMQ本身沒有默認的exchangeType，所以在申明exchange必需要設置type，否則會拋出異常 Could not declare exchange. Exchanges must have a type，
目前exchange支持4種類型 AMQP_EX_TYPE_DIRECT、 AMQP_EX_TYPE_FANOUT、AMQP_EX_TYPE_HEADERS 、 AMQP_EX_TYPE_TOPIC
可參考：RabbitMQ AMQP 消息模型攻略
記憶方法：amqp_exchange_type_direct、fanout、topic、headers

::setFlags ( int $flags )、::getFlags ( void )
默認AMQP_NOPARAM；可選AMQP_DURABLE, AMQP_PASSIVE、AMQP_AUTODELETE

passive：聲明一個已存在的交換器的，如果不存在將拋出異常，這個一般用在consume端。因爲一般produce端創建,在consume端建議設置成AMQP_PASSIVE,防止consume創建exchange
durable：持久exchange，該交換器將在broker重啓後生效，一般常使用該選項.
auto_delete：該交換器將在沒有消息隊列綁定時自動刪除。一個從未綁定任何隊列的交換器不會自動刪除。解釋有點繞。說明下吧，當有隊列bind到auto_delete的交換器上之後，刪除該隊列。此時交換器也會刪除。一般創建爲臨時交換器。

::setArgument ( string $key , mixed $value )
::setArguments ( array $arguments )
::getArgument ( string $key )
::getArguments ( void )

::declareExchange( void ) //和PHP的官方有差別

::delete ($exchangeName = null, $flags = AMQP_NOPARAM) //和PHP的官方有差別
未指定$exchangeName，刪除當前鏈接的exchange，但無法刪除system中內置的exchange.

::bind($exchange_name, $routing_key = ”, array $arguments = array()) //和PHP的官方有差別
::unbind($exchange_name, $routing_key = ”, array $arguments = array()) //和PHP的官方有差別
可以將消息同時發送到多個exchange，稍後補充實際的用法。

::publish ( string $message , string $routing_key [, int $flags = AMQP_NOPARAM [, array $attributes = array() ]] ) //發送消息方法 $attributes參考：RabbitMQ的PHP教程之RPC (六)

參數：$routint_key，在fanout下忽略。在direct類型下，如果該值爲空，則bind到exchange都能收到消息，這個有點像fanout的廣播模式。

參數：$flags可選值 AMQP_MANDATORY、AMQP_IMMEDIATE,默認：AMQP_NOPARAM，此處一般都設置爲false，本人還未測出這2個flag的區別，這裏有一篇文章關於這2個flag的介紹：
http://blog.csdn.net/jiao_fuyou/article/details/21594947

::getChannel()、getConnection() //不再介紹，見上面

四、AMQPQueue

::__construct(AMQPChannel $amqp_channel) //有PHP官方有區別

::setName ( string $queue_name )、::getName ( void ) //隊列名稱

::setFlags ( int $flags )、::getFlags ( void ) //重點
可選參數：AMQP_DURABLE, AMQP_PASSIVE,AMQP_EXCLUSIVE, AMQP_AUTODELETE
默認：auto_delete

auto_delete：當隊列中有消費者，則隊列存在，當沒有消費者鏈接，則隊列刪除

durable：持久化，隊列不刪除，注意僅僅是隊列持久，消息不持久（消息的持久在publish時的增加屬性delivery_mode）。消費的消息，從隊列裏刪除，未消費的消息保存在隊列中，不需要關注是否有消費者。最實用

passive：聲明一個1個已存在的隊列。意義不大，如果隊列不存在會拋出異常。

exclusive：排他隊列，如果一個隊列被聲明爲排他隊列，該隊列僅對首次聲明它的連接可見，並在連接斷開時自動刪除。這裏需要注意三點：

排他隊列是基於連接可見的，同一連接的不同信道是可以同時訪問同一個連接創建的排他隊列的。

"首次"，如果一個連接已經聲明瞭一個排他隊列，其他連接是不允許建立同名的排他隊列的，這個與普通隊列不同。

即使該隊列是持久化的，一旦連接關閉或者客戶端退出，該排他隊列都會被自動刪除的。這種隊列適用於只限於一個客戶端發送讀取消息的應用場景。

::setArgument ( string $key , mixed $value )
::setArguments ( array $arguments )
::getArgument ( string $key )
::getArguments ( void )

::declareQueue ( void )
::bind ( string $exchange_name , string $routing_key )
::unbind ( string $exchange_name , string $routing_key )

::get ([ int $flags ] )
//非阻塞，從隊列中檢索下一個可用的消息，flags爲空默認爲amqp.auto_ack（在php.ini中可用設置默認值）,可選參數：AMQP_AUTOACK

::consume ( callable $callback [, int $flags = AMQP_NOPARAM ] )
//阻塞，$callback支持數組的寫法，flags爲空默認爲amqp.auto_ack（在php.ini中可用設置默認值）,可選參數：AMQP_AUTOACK

::ack ( int $delivery_tag [, int $flags = AMQP_NOPARAM ] ) //複雜的業務邏輯，最好採用手動應答，防止消費處理業務邏輯複雜時，消息丟失。指定務必指定爲AMQP_NOPARAM，本人測試使用參數 AMQP_MULTIPLE，達不到預期的效果。此處有待高人解決。

更人性化的應答，在使用get、consume時，指定AMQP_NOPARAM時（未指定參數，則會調用PHP.ini的默認的設置），此時未對消費的消息做應答。在處理完複雜的業務邏輯後，使用ack做應答。此時隊列中，會刪除該條消息，如未應答，則會一直存在隊列中。

::nack($delivery_tag, $flags = AMQP_NOPARAM)、reject($delivery_tag, $flags = AMQP_NOPARAM)
用法ack相反，表示not ack.

::purge ( void )
清空隊列中的消息。

::delete ( void )
刪除隊列

::getChannel()、getConnection() //不再介紹，見上面

::cancel ([ string $consumer_tag = “” ] ) //暫時不知該如何使用

五、AMQPEnvelope

該類沒有set的方法，各種get

::getBody ( void )
::getRoutingKey ( void )
::getDeliveryTag ( void )
::getDeliveryMode ( void )
::getExchangeName ( void )
::isRedelivery ( void )
::getContentType ( void )
::getContentEncoding ( void )
::getType ( void )
::getTimeStamp ( void )
::getPriority ( void )
::getExpiration ( void )
::getUserId ( void )
::getAppId ( void )
::getMessageId ( void )
::getReplyTo ( void )
::getCorrelationId ( void )
::getHeaders ( void )
::getHeader($header_key).

六、代碼示例:

生產者示例:

<?php

header('Content-Type:text/html;charset=utf8;');

$params = array(
    'exchangeName' => 'myexchange',
    'queueName' => 'myqueue',
    'routeKey' => 'myroute',
);

$connectConfig = array(
    'host' => 'localhost',
    'port' => 5672,
    'login' => 'rabbitmq',
    'password' => 'rabbitmq',
    'vhost' => '/'
);

//var_dump(extension_loaded('amqp')); 判斷是否加載amqp擴展

//exit();
try {
    $conn = new AMQPConnection($connectConfig);
    $conn->connect();
    if (!$conn->isConnected()) {
        //die('Conexiune esuata');
        //TODO 記錄日誌
        echo 'rabbit-mq 連接錯誤:', json_encode($connectConfig);
        exit();
    }
    $channel = new AMQPChannel($conn);
    if (!$channel->isConnected()) {
        // die('Connection through channel failed');
        //TODO 記錄日誌
        echo 'rabbit-mq Connection through channel failed:', json_encode($connectConfig);
        exit();
    }
    $exchange = new AMQPExchange($channel);
    $exchange->setFlags(AMQP_DURABLE);//持久化
    $exchange->setName($params['exchangeName']?:'');
    $exchange->setType(AMQP_EX_TYPE_DIRECT); //direct類型
    $exchange->declareExchange();

    //$channel->startTransaction();

    $queue = new AMQPQueue($channel);
    $queue->setName($params['queueName']?:'');
    $queue->setFlags(AMQP_DURABLE);
    $queue->declareQueue();

    //綁定
    $queue->bind($params['exchangeName'], $params['routeKey']);
} catch(Exception $e) {

}


$num = mt_rand(100, 500);

//生成消息
for($i = $num; $i <= $num+5; $i++)
{
    $exchange->publish("this is {$i} message..", $params['routeKey'], AMQP_MANDATORY, array('delivery_mode'=>2));
}

消費者示例:

<?php

header('Content-Type:text/html;charset=utf8;');

$params = array(
    'exchangeName' => 'myexchange',
    'queueName' => 'myqueue',
    'routeKey' => 'myroute',
);

$connectConfig = array(
    'host' => 'localhost',
    'port' => 5672,
    'login' => 'rabbitmq',
    'password' => 'rabbitmq',
    'vhost' => '/'
);

//var_dump(extension_loaded('amqp'));

//exit();

try {
    $conn = new AMQPConnection($connectConfig);
    $conn->connect();
    if (!$conn->isConnected()) {
        //die('Conexiune esuata');
        //TODO 記錄日誌
        echo 'rabbit-mq 連接錯誤:', json_encode($connectConfig);
        exit();
    }
    $channel = new AMQPChannel($conn);
    if (!$channel->isConnected()) {
        // die('Connection through channel failed');
        //TODO 記錄日誌
        echo 'rabbit-mq Connection through channel failed:', json_encode($connectConfig);
        exit();
    }
    $exchange = new AMQPExchange($channel);
    $exchange->setFlags(AMQP_PASSIVE);//聲明一個已存在的交換器的，如果不存在將拋出異常，這個一般用在consume端
    $exchange->setName($params['exchangeName']?:'');
    $exchange->setType(AMQP_EX_TYPE_DIRECT); //direct類型
    $exchange->declareExchange();

    //$channel->startTransaction();

    $queue = new AMQPQueue($channel);
    $queue->setName($params['queueName']?:'');
    $queue->setFlags(AMQP_DURABLE);
    $queue->declareQueue();

    //綁定
    $queue->bind($params['exchangeName'], $params['routeKey']);
} catch(Exception $e) {
    echo $e->getMessage();
    exit();
}

function callback(AMQPEnvelope $message) {
    global $queue;
    if ($message) {
        $body = $message->getBody();
        echo $body . PHP_EOL;
        $queue->ack($message->getDeliveryTag());
    } else {
        echo 'no message' . PHP_EOL;
    }
}

//$queue->consume('callback');  第一種消費方式,但是會阻塞,程序一直會卡在此處

//第二種消費方式,非阻塞
$message = $queue->get();
if(!empty($message))
{
    echo $message->getBody();
    $queue->ack($message->getDeliveryTag());    //應答，代表該消息已經消費
}

rabbit以及php amqp擴展使用

一、AMQPConnection

二、AMQPChannel

三、 AMQPExchange

四、AMQPQueue

::ack ( int $delivery_tag [, int $flags = AMQP_NOPARAM ] ) //複雜的業務邏輯，最好採用手動應答，防止消費處理業務邏輯複雜時，消息丟失。指定務必指定爲AMQP_NOPARAM，本人測試使用參數 AMQP_MULTIPLE，達不到預期的效果。此處有待高人解決。

五、AMQPEnvelope

六、代碼示例:

Python 潮流週刊#50：我最喜歡的 Python 3.13 新特性！

symfony源碼分析之容器的生成與使用

php的mcrypt擴展已廢棄問題解決

Innodb中的事務隔離級別和鎖的關係

MyISAM和InnoDB索引實現對比

十個經典的C開源項目代碼

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結