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> ::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> ::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).
六、代码示例:
生产者示例:
页:
[1]