Fonctions APC
apc_cache_info
Fonctions APC
PHP Manual

# apc_add

(PECL apc:3.0.13-3.0.14)

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

### Description

bool apc_add ( string `$key` , mixed `$var` [, int `$ttl` ] )

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, utilisez donc 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 du cache manuellement, ou si le cache est effacé ou redémarré , etc.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

### 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()
- apc_fetch()
- apc_delete()

Fonctions APC
apc_cache_info
Fonctions APC
PHP Manual