/** * Set the pre-fetch limits for this connection. * * @recoil-coroutine * * The pre-fetch count is the maximum number of unacknowledged messages that * are delivered to this connection. * * The pre-fetch limit is the maximum total size of unacknowledge messages * (in bytes) that is delivered to this connection. * * This feature is incompatible with the "per_consumer_qos" broker * capability. * * RabbitMQ does not support per-connection limits (current as of v3.5.6). * * @param int|null $count The pre-fetch count limit (null = unlimited). * @param int|null $size The pre-fetch size limit (null = unlimited). * @param Channel|null $channel The application-managed channel to use (null = auto-managed). * * @throws NotSupportedException The broker does not support this feature. * @throws ConnectionException The connection is closed. */ public function setQosLimits(int $count = null, int $size = null, Channel $channel = null) : Generator { assert($size === null || $size > 0); assert($count === null || $count > 0); if ($this->connectionManager === null) { throw SingleConnectionException::notOpen($this->options); } elseif ($this->features->perConsumerQos) { throw NotSupportedException::incompatibleCapability('per-connection QoS limits', 'per_consumer_qos'); } elseif ($size !== null && !$this->features->qosSizeLimits) { throw NotSupportedException::unsupportedFeature('pre-fetch size limits'); } $channelManager = (yield $this->connectionManager->acquireChannel($channel)); try { (yield $channelManager->call(BasicQosFrame::create($size ?: 0, $count ?: 0, true), BasicQosOkFrame::METHOD_ID)); } finally { if ($channel === null) { $channelManager->release(); } } }
/** * Set the pre-fetch limits for consumers on this channel. * * @recoil-coroutine * * Only consumers created after setting the limits are affected. * * The pre-fetch count is the maximum number of unacknowledged messages that * are delivered to each consumer on this channel. * * The pre-fetch limit is the maximum total size of unacknowledge messages * (in bytes) that is delivered to this channel. * * This feature requires the "per_consumer_qos" broker capability. * * RabbitMQ does not support pre-fetch size limits (current as of v3.5.6). * * @param int|null $count The pre-fetch count limit (null = unlimited). * @param int|null $size The pre-fetch size limit (null = unlimited). * * @throws NotSupportedException The broker does not support this feature. * @throws ConnectionException The connection is closed. * @throws ChannelException The channel is closed. */ public function setConsumerQosLimits(int $count = null, int $size = null) : Generator { assert($size === null || $size > 0); assert($count === null || $count > 0); if ($this->channelManager === null) { throw ChannelException::notOpen($this->channelId); } elseif (!$this->features->perConsumerQos) { throw NotSupportedException::missingCapability('per-consumer QoS limits', 'per_consumer_qos'); } elseif ($size !== null && !$this->features->qosSizeLimits) { throw NotSupportedException::unsupportedFeature('pre-fetch size limits'); } $this->channelManager->setDirty(); (yield $this->channelManager->call(BasicQosFrame::create($size ?: 0, $count ?: 0, false), BasicQosOkFrame::METHOD_ID)); }
/** * Set the pre-fetch limits for this consumer's auto-managed channel. * * @recoil-coroutine * * This feature can not be used if the consumer is using a channel managed * by the application. * * The consumer must be closed and reopened for the changes to take affect. * * The pre-fetch count is the maximum number of unacknowledged messages that * are delivered to this channel. * * The pre-fetch limit is the maximum total size of unacknowledged messages * (in bytes) that is delivered to this channel. * * RabbitMQ does not support pre-fetch size limits (current as of v3.5.6). * * @param int|null $count The pre-fetch count limit (null = unlimited). * @param int|null $size The pre-fetch size limit (null = unlimited). */ public function setQosLimits(int $count = null, int $size = null) : Generator { assert($size === null || $size > 0); assert($count === null || $count > 0); assert($this->channel === null, 'can not set QOS limits when using an application-managed channel'); if ($size !== null && !$this->features->qosSizeLimits) { throw NotSupportedException::unsupportedFeature('pre-fetch size limits'); } $this->preFetchCount = $count ?: 0; $this->preFetchSize = $size ?: 0; return; yield; // @codeCoverageIgnore }