apc_store

(PECL apc >= 3.0.0)

apc_store — 変数をデータ領域にキャッシュする

説明

bool apc_store ( string $key , mixed $var [, int $ttl = 0 ] )

変数をデータ領域にキャッシュします。

注意: PHP の他の多くの仕組みと異なり、apc_store() を用いて格納された変数はリクエストを超えて（その値がキャッシュから取り除かれるまで）持続します。

パラメータ

key: この名前を用いて変数を格納します。key はキャッシュ内で一意です。そのため、同一の key で新しい値を格納すると、元の値は上書きされます。
var: 格納する変数。
ttl: 有効期間。var は、キャッシュに ttl 秒間だけ格納されます。 ttl が経過すると、格納されている変数は（次のリクエスト時に）キャッシュから削除されます。 ttl が指定されていない（あるいは ttl が 0 の場合）は、キャッシュから手動で削除される・あるいはキャッシュに存在できなくなる（clear, restart など）まで値が持続します。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例

例1 A apc_store() の例


<?php
$bar = 'BAR';
apc_store('foo', $bar);
var_dump(apc_fetch('foo'));
?>

上の例の出力は以下となります。

string(3) "BAR"

参考

apc_add() - 変数をデータ領域にキャッシュする
apc_fetch() - 格納されている変数をキャッシュから取得する
apc_delete() - 格納されている変数をキャッシュから取り除く

APD

apc_sma_info

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
apc_store

sebastian at 7val dot com
10-Mar-2008 08:53


Note that since APC 3.0.15 or 3.0.16, the time-to-live-feature does not work within the same request (see http://pecl.php.net/bugs/bug.php?id=13331).

JaskaS
01-Mar-2007 02:06


if you want to store array of objects in apc use ArrayObject wrapper (PHP5).



<?php

$objs = array();

$objs[] = new TestClass();

$objs[] = new TestClass();

$objs[] = new TestClass();



//Doesn't work

apc_store('objs',$objs,60);

$tmp = apc_fetch('objs'); 

print_r($tmp);



//Works

apc_store('objs',new ArrayObject($objs),60);

$tmp = apc_fetch('objs'); 

print_r($tmp->getArrayCopy());



?>

Roberto Spadim
12-Jan-2007 10:11


be sure that setting FALSE values can be wrong returned from fetch since fetch return FALSE on errors

php at tequilasolutions dot com
03-Nov-2006 11:45


Seems to be no (easy) way at the to know how old a value fetched is and to check whether it is out of date.



I've made these wrappers so that you can fetch and store values based on a udt returned from get_last_modified_date() which should return a udt of when your data was last changed, and hence needs junking out of the cache.



function apc_fetch_udt($key){

    $g = apc_fetch($key);

    if ($g){

        list($udt,$val) = $g;

        if (get_last_modified_date()<$udt) {

            $val = unserialize($val);

            return $val; 

        } else {

            apc_delete($key);

        }

    }

}

function apc_store_udt($key,$g){

    $udt = time();

    $g   = serialize($g);

    $apc = array($udt,$g);

    apc_store($key, $apc);

}

Sudhee
30-Oct-2006 12:09


It should be noted that apc_store appears to only store one level deep.  So if you have an array of arrays, and you store it.  When you pull it back out with apc_fetch it will only have the top level row of keys with nulls as the values of each key. 

 

Solution to this, is to serialize the data before storing it in the cache and unserialize it while retrieving from the cache.

add a note

APD

apc_sma_info

Last updated: Fri, 13 Nov 2009