/php/wincache.reroutes.html

https://bitbucket.org/thncr/manuals · HTML · 119 lines · 116 code · 3 blank · 0 comment · 0 complexity · 02373b5195ad76b5f1cebda7d29209b5 MD5 · raw file 

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>WinCache Functions Reroutes</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="wincache.sessionhandler.html">WinCache Session Handler</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="wincache.resources.html">资源类型</a></div>
    11. 

  11.  <div class="up"><a href="wincache.setup.html">安装／配置</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="wincache.reroutes" class="section">
    14. 

  14.   <h2 class="title">WinCache Functions Reroutes</h2>
    15. 

  15.   <p class="para">
    16. 

  16.    The WinCache functions reroutes (available since WinCache 1.2.0) can be used to replace built-in PHP functions with their equivalents 
    17. 

  17.    that are optimized for a particular purpose. WinCache extension includes Windows-optimized implementation of PHP file functions that 
    18. 

  18.    may improve performance of PHP applications in cases when PHP has to access files on network shares. The optimized implementation is 
    19. 

  19.    provided for the following functions:
    20. 

  20.   </p>
    21. 

  21.   <ul class="itemizedlist">
    22. 

  22.    <li class="listitem">
    23. 

  23.     <span class="simpara">
    24. 

  24.      <a href="function.file-exists.html" class="link">file_exists</a>
    25. 

  25.     </span>
    26. 

  26.    </li>
    27. 

  27.    <li class="listitem">
    28. 

  28.     <span class="simpara">
    29. 

  29.      <a href="function.file-get-contents.html" class="link">file_get_contents</a>
    30. 

  30.     </span>
    31. 

  31.    </li>
    32. 

  32.    <li class="listitem">
    33. 

  33.     <span class="simpara">
    34. 

  34.      <a href="function.readfile.html" class="link">readfile</a>
    35. 

  35.     </span>
    36. 

  36.    </li>
    37. 

  37.    <li class="listitem">
    38. 

  38.     <span class="simpara">
    39. 

  39.      <a href="function.is-readable.html" class="link">is_readable</a>
    40. 

  40.     </span>
    41. 

  41.    </li>
    42. 

  42.    <li class="listitem">
    43. 

  43.     <span class="simpara">
    44. 

  44.      <a href="function.is-writable.html" class="link">is_writable</a>
    45. 

  45.     </span>
    46. 

  46.    </li>
    47. 

  47.    <li class="listitem">
    48. 

  48.     <span class="simpara">
    49. 

  49.      <a href="function.is-dir.html" class="link">is_dir</a>
    50. 

  50.     </span>
    51. 

  51.    </li>
    52. 

  52.    <li class="listitem">
    53. 

  53.     <span class="simpara">
    54. 

  54.      <a href="function.realpath.html" class="link">realpath</a>
    55. 

  55.     </span>
    56. 

  56.    </li>
    57. 

  57.       <li class="listitem">
    58. 

  58.     <span class="simpara">
    59. 

  59.      <a href="function.filesize.html" class="link">filesize</a>
    60. 

  60.     </span>
    61. 

  61.    </li>
    62. 

  62.   </ul>
    63. 

  63.   <p class="para">
    64. 

  64.    To configure WinCache to use the functions reroutes use the file <var class="filename">reroute.ini</var> that is included in 
    65. 

  65.    WinCache installation package. Copy this file into the same directory where <var class="filename">php.ini</var> 
    66. 

  66.    file is located. After that add the wincache.rerouteini setting in <var class="filename">php.ini</var> 
    67. 

  67.    and specify an absolute or relative path to the <var class="filename">reroute.ini</var> file.
    68. 

  68.    <div class="example" id="example-509">
    69. 

  69.     <p><strong>Example #1 Enabling WinCache functions reroutes</strong></p>
    70. 

  70.     <div class="example-contents">
    71. 

  71. <div class="php.inicode"><pre class="php.inicode">wincache.rerouteini = C:\PHP\reroute.ini</pre>
    72. 

  72. </div>
    73. 

  73.     </div>
    74. 

  74. 

  75.    </div>
    76. 

  76.   </p>
    77. 

  77.   <blockquote class="note"><p><strong class="note">Note</strong>: 
    78. 

  78.    <span class="simpara">
    79. 

  79.     If WinCache functions reroutes are enabled it is recommended to increase the WinCache file cache size. This 
    80. 

  80.     can be done by using <a href="wincache.configuration.html#ini.wincache.fcachesize" class="link">wincache.fcachesize</a> setting.
    81. 

  81.    </span>
    82. 

  82.   </p></blockquote>
    83. 

  83.   <p class="para">
    84. 

  84.    The <var class="filename">reroute.ini</var> file contains the mappings between the native PHP functions and 
    85. 

  85.    their equivalents in WinCache. Each line in the file defines a mapping by using the following syntax:
    86. 

  86.   </p>
    87. 

  87.   <p class="simpara">
    88. 

  88.    <em>&lt;PHP function name&gt;:[&lt;number of function parameters&gt;]=&lt;wincache function name&gt;</em>
    89. 

  89.   </p>
    90. 

  90.   <p class="para">
    91. 

  91.    The example of the file is shown below. In this example the calls to PHP function  <span class="function"><a href="function.file-get-contents.html" class="function">file_get_contents()</a></span> 
    92. 

  92.    will be replaced with calls to  <span class="function"><strong>wincache_file_get_contents()</strong></span> only if the number of parameters passed to 
    93. 

  93.    the function is less than or equals to 2. Specifying the number of parameters is useful when replacement function 
    94. 

  94.    does not handle all the function&#039;s parameters.
    95. 

  95.    <div class="example" id="example-510">
    96. 

  96.     <p><strong>Example #2 Reroute.ini file content</strong></p>
    97. 

  97.     <div class="example-contents">
    98. 

  98.  <div class="php.inicode"><pre class="php.inicode">[FunctionRerouteList]
    99. 

  99. file_exists=wincache_file_exists
    100. 

  100. file_get_contents:2=wincache_file_get_contents
    101. 

  101. readfile:2=wincache_readfile
    102. 

  102. is_readable=wincache_is_readable
    103. 

  103. is_writable=wincache_is_writable
    104. 

  104. is_writeable=wincache_is_writable
    105. 

  105. is_file=wincache_is_file
    106. 

  106. is_dir=wincache_is_dir
    107. 

  107. realpath=wincache_realpath
    108. 

  108. filesize=wincache_filesize</pre>
    109. 

  109. </div>
    110. 

  110.     </div>
    111. 

  111. 

  112.    </div>
    113. 

  113.   </p>
    114. 

  114.  </div><hr /><div class="manualnavbar" style="text-align: center;">
    115. 

  115.  <div class="prev" style="text-align: left; float: left;"><a href="wincache.sessionhandler.html">WinCache Session Handler</a></div>
    116. 

  116.  <div class="next" style="text-align: right; float: right;"><a href="wincache.resources.html">资源类型</a></div>
    117. 

  117.  <div class="up"><a href="wincache.setup.html">安装／配置</a></div>
    118. 

  118.  <div class="home"><a href="index.html">PHP Manual</a></div>
    119. 

  119. </div></body></html>
    120.