virtual()
is an Apache-specific function which is similar to
<!--#include virtual...-->
in
mod_include
. It performs an Apache sub-request. It is useful for including CGI scripts or
.shtml
files, or anything else that you would parse through Apache. Note that for a CGI script, the script must generate valid CGI headers. At the minimum that means it must generate a
Content-Type
header.
To run the sub-request, all buffers are terminated and flushed to the browser, pending headers are sent too.
This function is supported when PHP is installed as an Apache module webserver.
Parameters
uri
The file that the virtual command will be performed on.
Return Values
Performs the virtual command on success, or returns
false
on failure.
Examples
See
apache_note()
for an example.
Notes
Warning
The query string can be passed to the included file but
$_GET
is copied from the parent script and only
$_SERVER['QUERY_STRING']
is filled with the passed query string. The query string may only be passed when using Apache 2. The requested file will not be listed in the Apache access log.
Note
:
Environment variables set in the requested file are not visible to the calling script.
Note
:
This function may be used on PHP files. However, it is typically better to use
include
or
require
for PHP files.
Caches a variable in the data store, only if it's not already stored.
Note
:
Unlike many other mechanisms in PHP, variables stored using
apcu_add()
will persist between requests (until the value is removed from the cache).
Parameters
key
Store the variable using this name.
key
s are cache-unique, so attempting to use
apcu_add()
to store data with a key that already exists will not overwrite the existing data, and will instead return
false
. (This is the only difference between
apcu_add()
and
apcu_store()
.)
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.
Return Values
Returns TRUE if something has effectively been added into the cache, FALSE otherwise. Second syntax returns array with error keys.
apcu_cache_info
—
Retrieves cached information from APCu's data store
Description
apcu_cache_info(bool$limited=false):array|false
Retrieves cached information and meta-data from APC's data store.
Parameters
limited
If
limited
is
true
, the return value will exclude the individual list of cache entries. This is useful when trying to optimize calls for statistics gathering.
Return Values
Array of cached data (and meta-data) or
false
on failure
Note
:
apcu_cache_info()
will raise a warning if it is unable to retrieve APC cache data. This typically occurs when APC is not enabled.
Changelog
Version
Description
PECL apcu 3.0.11
The
limited
parameter was introduced.
PECL apcu 3.0.16
The "
filehits
" option for the
cache_type
parameter was introduced.
Examples
Example #1 A
apcu_cache_info()
example
<?phpprint_r(apcu_cache_info());?>
The above example will output something similar to:
Optionally pass the success or fail boolean value to this referenced variable.
ttl
TTL to use if the operation inserts a new value (rather than decrementing an existing one).
Return Values
Returns the current value of
key
's value on success, or
false
on failure
Examples
Example #1
apcu_dec()
example
<?phpecho"Let's do something with success",PHP_EOL;apcu_store('anumber',42);echoapcu_fetch('anumber'),PHP_EOL;echoapcu_dec('anumber'),PHP_EOL;echoapcu_dec('anumber',10),PHP_EOL;echoapcu_dec('anumber',10,$success),PHP_EOL;var_dump($success);echo"Now, let's fail",PHP_EOL,PHP_EOL;apcu_store('astring','foo');$ret=apcu_dec('astring',1,$fail);var_dump($ret);var_dump($fail);?>
The above example will output something similar to:
Let's do something with success
42
41
31
21
bool(true)
Now, let's fail
bool(false)
bool(false)