# apcu_store

(PECL apcu >= 4.0.0)

apcu_store — Cache a variable in the data store

### 说明

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

Cache a variable in the data store.

> Note: Unlike many other mechanisms in PHP, variables stored using apcu_store() will persist between requests (until the value is removed from the cache).

### 参数

`key`

  Store the variable using this name. `key`s are cache-unique, so storing a second value with the same `key` will overwrite the original value.

`var`

  The variable to store

`ttl`

  Time To Live; store `var` in the cache for `ttl` seconds. After the `ttl` has passed, the stored variable will be expunged from the cache (on the next request). If no `ttl` is supplied (or if the `ttl` is 0), the value will persist until it is removed from the cache manually, or otherwise fails to exist in the cache (clear, restart, etc.).

`values`

  Names in key, variables in value.

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。 Second syntax returns array with error keys.

### 范例

Example #1 A apcu_store() example

    <?php
    $bar = 'BAR';
    apcu_store('foo', $bar);
    var_dump(apcu_fetch('foo'));
    ?>

以上例程会输出：

    string(3) "BAR"

### 参见

- apcu_add() - Cache a new variable in the data store
- apcu_fetch() - Fetch a stored variable from the cache
- apcu_delete() - Removes a stored variable from the cache