apc_store(3) [php man page]

APC_STORE(3)								 1							      APC_STORE(3)

apc_store - Cache a variable in the data store

SYNOPSIS

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

DESCRIPTION

       array apc_store (array  $values, [mixed	$unused = NULL], [int  $ttl])

	Cache a variable in the data store.

       Note

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

PARAMETERS

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

	      o $var
		- The variable to store

	      o $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.).

	      o $values
		- Names in key, variables in value.

RETURN VALUES

	Returns TRUE on success or FALSE on failure. Second syntax returns array with error keys.

EXAMPLES

       Example #1

	      A apc_store(3) example

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

	      The above example will output:

	      string(3) "BAR"

SEE ALSO

       apc_add(3), apc_fetch(3), apc_delete(3).

PHP Documentation Group 													      APC_STORE(3)

APC_CAS(3)								 1								APC_CAS(3)

apc_cas - Updates an old value with a new value

SYNOPSIS

       bool apc_cas (string  $key, int	$old, int  $new)

DESCRIPTION

       apc_cas(3)  updates  an	already existing integer value if the $old parameter matches the currently stored value with the value of the $new
       parameter.

PARAMETERS

	      o $key
		- The key of the value being updated.

	      o $old
		- The old value (the value currently stored).

	      o $new
		- The new value to update to.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      apc_cas(3) example

	      <?php
	      apc_store('foobar', 2);
	      echo '$foobar = 2', PHP_EOL;
	      echo '$foobar == 1 ? 2 : 1 = ', (apc_cas('foobar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;
	      echo '$foobar == 2 ? 1 : 2 = ', (apc_cas('foobar', 2, 1) ? 'ok' : 'fail'), PHP_EOL;

	      echo '$foobar = ', apc_fetch('foobar'), PHP_EOL;

	      echo '$f__bar == 1 ? 2 : 1 = ', (apc_cas('f__bar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;

	      apc_store('perfection', 'xyz');
	      echo '$perfection == 2 ? 1 : 2 = ', (apc_cas('perfection', 2, 1) ? 'ok' : 'epic fail'), PHP_EOL;

	      echo '$foobar = ', apc_fetch('foobar'), PHP_EOL;
	      ?>

	      The above example will output something similar to:

	      $foobar = 2
	      $foobar == 1 ? 2 : 1 = fail
	      $foobar == 2 ? 1 : 2 = ok
	      $foobar = 1
	      $f__bar == 1 ? 2 : 1 = fail
	      $perfection == 2 ? 1 : 2 = epic fail
	      $foobar = 1

SEE ALSO 
apc_dec(3), apc_store(3).
PHP Documentation Group 														APC_CAS(3)