<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.memcached.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'it',
  ),
  'this' => 
  array (
    0 => 'memcached.getmultibykey.php',
    1 => 'Memcached::getMultiByKey',
    2 => 'Retrieve multiple items from a specific server',
  ),
  'up' => 
  array (
    0 => 'class.memcached.php',
    1 => 'Memcached',
  ),
  'prev' => 
  array (
    0 => 'memcached.getmulti.php',
    1 => 'Memcached::getMulti',
  ),
  'next' => 
  array (
    0 => 'memcached.getoption.php',
    1 => 'Memcached::getOption',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/memcached/memcached/getmultibykey.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="memcached.getmultibykey" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Memcached::getMultiByKey</h1>
  <p class="verinfo">(PECL memcached &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">Memcached::getMultiByKey</span> &mdash; <span class="dc-title">Retrieve multiple items from a specific server</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-memcached.getmultibykey-description">
  <h3 class="title">Descrizione</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Memcached::getMultiByKey</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$server_key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$keys</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$get_flags</code><span class="initializer"> = 0</span></span>): <span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>Memcached::getMultiByKey()</strong></span> is functionally equivalent to
   <span class="methodname"><a href="memcached.getmulti.php" class="methodname">Memcached::getMulti()</a></span>, except that the free-form
   <code class="parameter">server_key</code> can be used to map the
   <code class="parameter">keys</code> to a specific server.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-memcached.getmultibykey-parameters">
  <h3 class="title">Elenco dei parametri</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">server_key</code></dt>
     <dd>
      <p class="para">
       La chiave che identifica il server su cui salvare il valore. Invece di effettuare li&#039;hashing sulla chiave dell&#039;elemento, si effettua l&#039;hashing della chiave del server al momento di decidere con quale server memcached comunicare. Questo permette di raggruppare gli elementi correlati ad un singolo server ottenendo maggiore efficienza nelle operazioni multiple.
      </p>
     </dd>
    
    
     <dt><code class="parameter">keys</code></dt>
     <dd>
      <p class="para">
       Array of keys to retrieve.
      </p>
     </dd>
    
    
     <dt><code class="parameter">get_flags</code></dt>
     <dd>
      <p class="para">
       The flags for the get operation.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-memcached.getmultibykey-returnvalues">
  <h3 class="title">Valori restituiti</h3>
  <p class="para">
   Returns the array of found items o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> in caso di fallimento.
   Utilizzare <span class="methodname"><strong>Memcached:getResultCode()</strong></span> se necessario.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-memcached.getmultibykey-changelog">
  <h3 class="title">Log delle modifiche</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versione</th>
      <th>Descrizione</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>PECL memcached 3.0.0</td>
      <td>
       The <code class="parameter reference">&cas_tokens</code> parameter was removed.
       The <strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong> was added and when passed as a flag it ensures the CAS tokens to be fetched.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-memcached.getmultibykey-seealso">
  <h3 class="title">Vedere anche:</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="memcached.getmulti.php" class="methodname" rel="rdfs-seeAlso">Memcached::getMulti()</a> - Retrieve multiple items</span></li>
    <li><span class="methodname"><a href="memcached.get.php" class="methodname" rel="rdfs-seeAlso">Memcached::get()</a> - Retrieve an item</span></li>
    <li><span class="methodname"><a href="memcached.getdelayed.php" class="methodname" rel="rdfs-seeAlso">Memcached::getDelayed()</a> - Request multiple items</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>