home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 August / PCWorld_2001-08_cd.bin / Komunikace / phptriad / phptriadsetup2-11.exe / php / README.txt < prev   
Text File  |  2000-07-14  |  5KB  |  108 lines
  1. PHP 4.0 - Win32 Distribution
  2. ============================
  3.  
  4.  
  5. Note
  6. ----
  7.  
  8. PHP 4.0 for Windows comes in two flavours - a CGI executable (php.exe), and an
  9. ISAPI module (php4isapi.dll).  The latter is new to PHP 4.0, and provides
  10. significantly improved performance and some new functionality.  However,
  11. please note that the ISAPI module is *NOT* yet considered to be production
  12. quality.  The reason for this is that the PHP ISAPI module uses the
  13. thread-safe version of the PHP code, which is completely new to PHP 4.0, and
  14. has not yet been tested and pounded enough to be considered completely stable,
  15. and there are actually a few known bugs.  On the other hand, some people have
  16. reported very good results with the ISAPI module, even though we're not aware
  17. of anyone actually running it on a production site.  In short - your mileage
  18. may vary;  If you need absolute stability, trade the performance of the ISAPI
  19. module with the stability of the CGI executable.
  20.  
  21.  
  22. Requirements
  23. ------------
  24.  
  25. - Windows 95 or later, Windows NT 4.0 or later
  26. - ISAPI 4.0 compliant Web server required for ISAPI module (tested on IIS 4.0,
  27.   PWS 4.0 IIS 5.0).  IIS 3.0 is *NOT* supported;  You should download and
  28.   install the Windows NT 4.0 Option Pack with IIS 4.0 if you want native PHP
  29.   support.
  30. - Windows 95 requires the DCOM update, freely available from:
  31.     http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe
  32.  
  33.  
  34. Installation
  35. ------------
  36.  
  37. Unlike PHP 3, PHP 4 is divided into several components;  Even when you use
  38. PHP in its CGI mode, php.exe is no longer a standalone executable, and relies
  39. on external DLLs for execution.  For this reason, if you install php.exe as
  40. a handler for your web server, you must make sure that the DLLs in the
  41. distribution exist in a directory that is in the Windows PATH.  The easiest
  42. way to do it is to copy these DLLs to your SYSTEM (Windows 9x) or SYSTEM32
  43. (Windows NT) directory, which is under your Windows directory.
  44. The DLLs that need to be copied are MSVCRT.DLL (it may already exist in there)
  45. and PHP4TS.DLL.
  46.  
  47. Installation Notes for IIS 4.0 and 5.0
  48. --------------------------------------
  49.  
  50. - Install the DLLs as mentioned above.
  51. - If you wish to change any defaults, copy either the php.ini-dist or
  52.   php.ini-optimized files into your Windows directory, and rename it to
  53.   'php.ini'.  You can then modify any of the directives inside it.
  54. - Start the Microsoft Management Console (may appear as
  55.   'Internet Services Manager', either in your Windows NT 4.0 Option Pack
  56.   branch or the Control Panel->Administrative Tools under Windows 2000).
  57. - Right click on your Web server node (will most probably appear as 'Default
  58.   Web Server'), and select 'Properties'.
  59. - If you don't want to perform HTTP Authentication using PHP, you can (and
  60.   should) skip this step.  Under 'ISAPI Filters', add a new ISAPI filter.
  61.   Use 'PHP' as the filter name, and supply a path to the php4isapi.dll that
  62.   is included in the distribution.
  63. - Under 'Home Directory', click on the 'Configuration' button.  Add a new
  64.   entry to the Application Mappings;  Use the path the php4isapi.dll as the
  65.   Executable, supply .php as the extension, leave 'Method exclusions', blank,
  66.   and check the Script engine checkbox.
  67. - Stop IIS completely (you would have to stop the IIS Administration service
  68.   for that - stopping it through the Management Console isn't good enough;
  69.   You can do it by typing 'net stop iisadmin' on a command prompt).
  70. - Start IIS again (you can do it by typing 'net start w3svc' on a command
  71.   prompt).
  72. - Put a .php file under your Web server's document root and check if it works!
  73.  
  74.  
  75.  
  76. Installation Notes for Microsoft PWS 4.0
  77. ----------------------------------------
  78.  
  79. - Install the php.ini file and the DLLs as mentioned above.
  80. - Edit the enclosed PWS-php4.reg file to reflect the location of your
  81.   php4isapi.dll.  Forward slashes should be escaped, for example:
  82.   
  83. [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map]
  84. ".php"="C:\\Program Files\\PHP\\php4isapi.dll"
  85.  
  86. - In the PWS Manager, right click on a given directory you want to add PHP
  87.   support to, and select Properties.  Check the 'Execute' checkbox, and
  88.   confirm.
  89.  
  90. At this point, PWS should have built-in PHP support.
  91.  
  92.  
  93.  
  94. Adding Extensions
  95. -----------------
  96.  
  97. A few pre-compiled extensions are included in this release.  You can load them
  98. by adding a line like the following to your php.ini file:
  99. extension=path\to\extension\extension_name.dll
  100. Loading these extensions extends the functionality of PHP to support more
  101. functions and protocols.
  102. Note:  MySQL support is *built-in* as of PHP 4.0.  You don't need to load any
  103.        additional extensions in order to use the MySQL functions.
  104.  
  105. Good luck,
  106.  
  107. Zeev <zeev@zend.com>, Andi <andi@zend.com>  [June 25, 2000]
  108.