Met en cache une nouvelle variable dans le magasin de données

# apc_add

(PECL apc >= 3.0.13)

apc_add — Met en cache une nouvelle variable dans le magasin de données

### Description

apc_add ( string `$key` , mixed `$var` [, int `$ttl` = 0 ] ) : bool
apc_add ( array `$values` [, mixed `$unused` = NULL [, int `$ttl` = 0 ]] ) : array

Met en cache une variable dans le magasin de données, uniquement si elle ne s'y trouve pas déjà.

> Note: Contrairement aux autres mécanismes en PHP, les variables stockées en utilisant la fonction apc_add() seront persistantes entre les requêtes (jusqu'à ce que la valeur soit effacée du cache).

### Liste de paramètres

`key`

  Stocke la variable en utilisant son nom. La clé `key` est unique dans le cache, donc utilisez la fonction apc_add() pour stocker une donnée avec une clé qui existe déjà n'efface pas la donnée existante, mais retournera `FALSE`. (C'est la seule différence entre la fonction apc_add() et la fonction apc_store().)

`var`

  La variable à stocker

`ttl`

  Durée de vie ; stocke la variable `var` dans le cache pendant `ttl` secondes. Après ce délai, la variable stockée sera effacée du cache (à la requête suivante). Si le paramètre `ttl` n'est pas fourni (ou s'il vaut 0), la valeur persistera tant qu'elle ne sera pas effacée manuellement du cache, ou si elle n'existe plus dans le cache (effacement, redémarrage, etc.).

`values`

  Les noms comme clés, les variables comme valeurs.

### Valeurs de retour

Retourne `TRUE` si quelque chose a bien été aujouté au cache, `FALSE` sinon. La seconde syntaxe retourne un tableau avec les clés en erreur.

### Exemples

Exemple #1 Exemple avec apc_add()

`<?php
$bar = 'BAR';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
$bar = 'NEVER GETS SET';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
?>`

L'exemple ci-dessus va afficher :

    string(3) "BAR"
    string(3) "BAR"

### Voir aussi

- apc_store() - Met en cache une variable dans le magasin
- apc_fetch() - Récupère une variable stockée dans le cache
- apc_delete() - Efface une variable stockée dans le cache