<?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.getbykey.php',
    1 => 'Memcached::getByKey',
    2 => 'Retrieve an item from a specific server',
  ),
  'up' => 
  array (
    0 => 'class.memcached.php',
    1 => 'Memcached',
  ),
  'prev' => 
  array (
    0 => 'memcached.getallkeys.php',
    1 => 'Memcached::getAllKeys',
  ),
  'next' => 
  array (
    0 => 'memcached.getdelayed.php',
    1 => 'Memcached::getDelayed',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/memcached/memcached/getbykey.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

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

 </div>

 <div class="refsect1 description" id="refsect1-memcached.getbykey-description">
  <h3 class="title">Descrizione</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Memcached::getByKey</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<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>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$key</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span></span> <code class="parameter">$cache_cb</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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><br>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

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


 <div class="refsect1 parameters" id="refsect1-memcached.getbykey-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">key</code></dt>
     <dd>
      <p class="para">
       The key of the item to fetch.
      </p>
     </dd>
    
    
     <dt><code class="parameter">cache_cb</code></dt>
     <dd>
      <p class="para">
       Read-through caching callback or <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
      </p>
     </dd>
    
    
     <dt><code class="parameter">get_flags</code></dt>
     <dd>
      <p class="para">
       Flags to control the returned result. When value of <strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong>
       is given will return the CAS token.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-memcached.getbykey-returnvalues">
  <h3 class="title">Valori restituiti</h3>
  <p class="para">
   Returns the value stored in the cache or <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> otherwise.
   The <span class="methodname"><a href="memcached.getresultcode.php" class="methodname">Memcached::getResultCode()</a></span> will return
   <strong><code><a href="memcached.constants.php#memcached.constants.res-notfound">Memcached::RES_NOTFOUND</a></code></strong> if the key does not exist.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-memcached.getbykey-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_token</code> parameter was removed.
       Instead <code class="parameter">get_flags</code> was added and when it is given the value of <strong><code><a href="memcached.constants.php#memcached.constants.get-extended">Memcached::GET_EXTENDED</a></code></strong> it will ensure the CAS token to be fetched.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-memcached.getbykey-seealso">
  <h3 class="title">Vedere anche:</h3>
  <p class="para">
   <ul class="simplelist">
    <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.getmulti.php" class="methodname" rel="rdfs-seeAlso">Memcached::getMulti()</a> - Retrieve multiple items</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); ?>