WinCache Functions Reroutes
WinCache Functions Reroutes
WinCache Functions Reroutes
NOTE: wincache.rerouteini was removed as of WinCache 1.3.7.0.
It has been replaced with automatic function reroutes. See:
wincache.reroute_enabled.
The WinCache functions reroutes (available since
WinCache 1.2.0, removed since WinCache 1.3.7.0) can be used to
replace built-in PHP functions with their equivalents that are
optimized for a particular purpose. WinCache extension includes
Windows-optimized implementation of PHP file functions that may
improve performance of PHP applications in cases when PHP has to
access files on network shares. The optimized implementation is
provided for the following functions:
To configure WinCache to use the functions reroutes
use the file reroute.ini that is
included in WinCache installation package. Copy this file into the
same directory where php.ini file is
located. After that add the wincache.rerouteini setting in
php.ini and specify an absolute or
relative path to the reroute.ini
file.
Example #1 Enabling WinCache functions
reroutes
wincache.rerouteini = C:\PHP\reroute.ini
Note: If
WinCache functions reroutes are enabled it is recommended to
increase the WinCache file cache size. This can be done by using
wincache.fcachesize setting.
The reroute.ini file
contains the mappings between the native PHP functions and their
equivalents in WinCache. Each line in the file defines a mapping by
using the following syntax:
<PHP function name>:[<number of
function parameters>]=<wincache function name>
The example of the file is shown below. In this
example the calls to PHP function file_get_contents() will be replaced with
calls to wincache_file_get_contents()
only if the number of parameters passed to the function is less
than or equals to 2. Specifying the number of parameters is useful
when replacement function does not handle all the function’s
parameters.
Example #2 Reroute.ini file content
[FunctionRerouteList] file_exists=wincache_file_exists file_get_contents:2=wincache_file_get_contents readfile:2=wincache_readfile is_readable=wincache_is_readable is_writable=wincache_is_writable is_writeable=wincache_is_writable is_file=wincache_is_file is_dir=wincache_is_dir realpath=wincache_realpath filesize=wincache_filesize