<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Runtime Configuration</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="amqp.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="amqp.resources.html">Resource Types</a></div>
<div class="up"><a href="amqp.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="amqp.configuration" class="section">
<h2 class="title">Runtime Configuration</h2>
<p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
<p class="para">
<table class="doctable table">
<caption><strong>AMQP Configure Options</strong></caption>
<thead>
<tr>
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><a href="amqp.configuration.html#ini.amqp.host" class="link">amqp.host</a></td>
<td>localhost</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.vhost" class="link">amqp.vhost</a></td>
<td>/</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.port" class="link">amqp.port</a></td>
<td>5672</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.login" class="link">amqp.login</a></td>
<td>guest</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.password" class="link">amqp.password</a></td>
<td>guest</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.auto-ack" class="link">amqp.auto_ack</a></td>
<td>0</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.min-messages" class="link">amqp.min_messages</a></td>
<td>0</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.max-messages" class="link">amqp.max_messages</a></td>
<td>1</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
<tr>
<td><a href="amqp.configuration.html#ini.amqp.prefetch-count" class="link">amqp.prefetch_count</a></td>
<td>3</td>
<td>PHP_INI_ALL</td>
<td></td>
</tr>
</tbody>
</table>
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
<dl>
<dt id="ini.amqp.host">
<span class="term">
<em><code class="parameter">amqp.host</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The host to which to connect.
</p>
</dd>
</dt>
<dt id="ini.amqp.vhost">
<span class="term">
<em><code class="parameter">amqp.vhost</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The virtual host on the broker to which to connect.
</p>
</dd>
</dt>
<dt id="ini.amqp.port">
<span class="term">
<em><code class="parameter">amqp.port</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
The port on which to connect.
</p>
</dd>
</dt>
<dt id="ini.amqp.login">
<span class="term">
<em><code class="parameter">amqp.login</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The login to use while connecting to the broker.
</p>
</dd>
</dt>
<dt id="ini.amqp.password">
<span class="term">
<em><code class="parameter">amqp.password</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The password to use while connecting to the broker.
</p>
</dd>
</dt>
<dt id="ini.amqp.auto-ack">
<span class="term">
<em><code class="parameter">amqp.auto_ack</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
Whether calls to <span class="methodname"><a href="amqpqueue.get.html" class="methodname">AMQPQueue::get()</a></span> and <span class="methodname"><a href="amqpqueue.consume.html" class="methodname">AMQPQueue::consume()</a></span> should require that the client explicitly acknowledge messages. Setting this value to 1 will pass in the <strong><code>AMQP_AUTOACK</code></strong> flag to the above method calls if the <em>flags</em> field is omitted.
</p>
</dd>
</dt>
<dt id="ini.amqp.min-messages">
<span class="term">
<em><code class="parameter">amqp.min_messages</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
The minimum number of messages to require during a call to <span class="methodname"><a href="amqpqueue.consume.html" class="methodname">AMQPQueue::consume()</a></span>.
</p>
</dd>
</dt>
<dt id="ini.amqp.max-messages">
<span class="term">
<em><code class="parameter">amqp.max_messages</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
The maximum number of messages to require during a call to <span class="methodname"><a href="amqpqueue.consume.html" class="methodname">AMQPQueue::consume()</a></span>.
</p>
</dd>
</dt>
<dt id="ini.amqp.prefetch-count">
<span class="term">
<em><code class="parameter">amqp.prefetch_count</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
The number of messages to prefect from the server during a call to <span class="methodname"><a href="amqpqueue.get.html" class="methodname">AMQPQueue::get()</a></span> or <span class="methodname"><a href="amqpqueue.consume.html" class="methodname">AMQPQueue::consume()</a></span> during which the <strong><code>AMQP_AUTOACK</code></strong> flag is not set.
</p>
</dd>
</dt>
</dl>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="amqp.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="amqp.resources.html">Resource Types</a></div>
<div class="up"><a href="amqp.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
