📄 install.txt
字号:
system directory. For more details, see the FAQ on Setting the
PATH.
* The IIS user (usually IUSR_MACHINENAME) needs permission to read
various files and directories, such as php.ini, docroot, and the
session tmp directory.
* Be sure the extension_dir and doc_root PHP directives are
appropriately set in php.ini. These directives depend on the system
that PHP is being installed on. In PHP 4, the extension_dir is
extensions while with PHP 5 it's ext. So, an example PHP 5
extensions_dir value is "c:\php\ext" and an example IIS doc_root
value is "c:\Inetpub\wwwroot".
* PHP extension DLL files, such as php_mysql.dll and php_curl.dll,
are found in the zip package of the PHP download (not the PHP
installer). In PHP 5, many extensions are part of PECL and can be
downloaded in the "Collection of PECL modules" package. Files such
as php_zip.dll and php_ssh2.dll. Download PHP files here.
* When defining the executable, the 'check that file exists' box may
also be checked. For a small performance penalty, the IIS (or PWS)
will check that the script file exists and sort out authentication
before firing up PHP. This means that the web server will provide
sensible 404 style error messages instead of CGI errors complaining
that PHP did not output any data.
__________________________________________________________________
Windows NT/200x/XP and IIS 4 or newer
PHP may be installed as a CGI binary, or with the ISAPI module. In
either case, you need to start the Microsoft Management Console (may
appear as 'Internet Services Manager', either in your Windows NT 4.0
Option Pack branch or the Control Panel=>Administrative Tools under
Windows 2000/XP). Then right click on your Web server node (this will
most probably appear as 'Default Web Server'), and select 'Properties'.
If you want to use the CGI binary, do the following:
* Under 'Home Directory', 'Virtual Directory', or 'Directory', do the
following:
* Change the Execute Permissions to 'Scripts only'
* Click on the 'Configuration' button, and choose the Application
Mappings tab. Click Add and set the Executable path to the
appropriate CGI file. An example PHP 5 value is: C:\php\php-cgi.exe
Supply .php as the extension. Leave 'Method exclusions' blank, and
check the 'Script engine' checkbox. Now, click OK a few times.
* Set up the appropriate security. (This is done in Internet Service
Manager), and if your NT Server uses NTFS file system, add execute
rights for I_USR_ to the directory that contains php.exe /
php-cgi.exe.
To use the ISAPI module, do the following:
* If you don't want to perform HTTP Authentication using PHP, you can
(and should) skip this step. Under ISAPI Filters, add a new ISAPI
filter. Use PHP as the filter name, and supply a path to the
php4isapi.dll / php5isapi.dll.
* Under 'Home Directory', 'Virtual Directory', or 'Directory', do the
following:
* Change the Execute Permissions to 'Scripts only'
* Click on the 'Configuration' button, and choose the Application
Mappings tab. Click Add and set the Executable path to the
appropriate ISAPI DLL. An example PHP 5 value is:
C:\php\php5isapi.dll Supply .php as the extension. Leave 'Method
exclusions' blank, and check the 'Script engine' checkbox. Now,
click OK a few times.
* Stop IIS completely (NET STOP iisadmin)
* Start IIS again (NET START w3svc)
With IIS 6 (2003 Server), open up the IIS Manager, go to Web Service
Extensions, choose "Add a new Web service extension", enter in a name
such as PHP, choose the Add button and for the value browse to either
the ISAPI file (php4isapi.dll or php5isapi.dll) or CGI (php.exe or
php-cgi.exe) then check "Set extension status to Allowed" and click OK.
In order to use index.php as a default content page, do the following:
From within the Documents tab, choose Add. Type in index.php and click
OK. Adjust the order by choosing Move Up or Move Down. This is similar
to setting DirectoryIndex with Apache.
The steps above must be repeated for each extension that is to be
associated with PHP scripts. .php is the most common although .php3 may
be required for legacy applications.
If you experience 100% CPU usage after some time, turn off the IIS
setting Cache ISAPI Application.
__________________________________________________________________
Windows and PWS 4
PWS 4 does not support ISAPI, only PHP CGI should be used.
* Edit the enclosed pws-php4cgi.reg / pws-php5cgi.reg file (look into
the SAPI folder for PHP 4, or in the main folder for PHP 5) to
reflect the location of your php.exe / php-cgi.exe. Backslashes
should be escaped, for example:
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\paramet
ers\Script Map] ".php"="C:\\php\\php.exe" (change to
C:\\php\\php-cgi.exe if you are using PHP 5) Now merge this
registery file into your system; you may do this by double-clicking
it.
* In the PWS Manager, right click on a given directory you want to
add PHP support to, and select Properties. Check the 'Execute'
checkbox, and confirm.
__________________________________________________________________
Windows and PWS/IIS 3
The recommended method for configuring these servers is to use the REG
file included with the distribution (pws-php4cgi.reg in the SAPI folder
for PHP 4, or pws-php5cgi.reg in the main folder for PHP 5). You may
want to edit this file and make sure the extensions and PHP install
directories match your configuration. Or you can follow the steps below
to do it manually.
Warning
These steps involve working directly with the Windows registry. One
error here can leave your system in an unstable state. We highly
recommend that you back up your registry first. The PHP Development
team will not be held responsible if you damage your registry.
* Run Regedit.
* Navigate to: HKEY_LOCAL_MACHINE /System /CurrentControlSet
/Services /W3Svc /Parameters /ScriptMap.
* On the edit menu select: New->String Value.
* Type in the extension you wish to use for your php scripts. For
example .php
* Double click on the new string value and enter the path to php.exe
in the value data field. ex: C:\php\php.exe "%s" %s for PHP 4, or
C:\php\php-cgi.exe "%s" %s for PHP 5.
* Repeat these steps for each extension you wish to associate with
PHP scripts.
The following steps do not affect the web server installation and only
apply if you want your PHP scripts to be executed when they are run
from the command line (ex. run C:\myscripts\test.php) or by double
clicking on them in a directory viewer window. You may wish to skip
these steps as you might prefer the PHP files to load into a text
editor when you double click on them.
* Navigate to: HKEY_CLASSES_ROOT
* On the edit menu select: New->Key.
* Name the key to the extension you setup in the previous section.
ex: .php
* Highlight the new key and in the right side pane, double click the
"default value" and enter phpfile.
* Repeat the last step for each extension you set up in the previous
section.
* Now create another New->Key under HKEY_CLASSES_ROOT and name it
phpfile.
* Highlight the new key phpfile and in the right side pane, double
click the "default value" and enter PHP Script.
* Right click on the phpfile key and select New->Key, name it Shell.
* Right click on the Shell key and select New->Key, name it open.
* Right click on the open key and select New->Key, name it command.
* Highlight the new key command and in the right side pane, double
click the "default value" and enter the path to php.exe. ex:
c:\php\php.exe -q %1. (don't forget the %1).
* Exit Regedit.
* If using PWS on Windows, reboot to reload the registry.
PWS and IIS 3 users now have a fully operational system. IIS 3 users
can use a nifty tool from Steven Genusa to configure their script maps.
__________________________________________________________________
Apache 1.3.x on Microsoft Windows
This section contains notes and hints specific to Apache 1.3.x installs
of PHP on Microsoft Windows systems. There are also instructions and
notes for Apache 2 on a separate page.
Note: Please read the manual installation steps first!
There are two ways to set up PHP to work with Apache 1.3.x on Windows.
One is to use the CGI binary (php.exe for PHP 4 and php-cgi.exe for PHP
5), the other is to use the Apache Module DLL. In either case you need
to edit your httpd.conf to configure Apache to work with PHP, and then
restart the server.
It is worth noting here that now the SAPI module has been made more
stable under Windows, we recommend it's use above the CGI binary, since
it is more transparent and secure.
Although there can be a few variations of configuring PHP under Apache,
these are simple enough to be used by the newcomer. Please consult the
Apache Documentation for further configuration directives.
After changing the configuration file, remember to restart the server,
for example, NET STOP APACHE followed by NET START APACHE, if you run
Apache as a Windows Service, or use your regular shortcuts.
Note: Remember that when adding path values in the Apache
configuration files on Windows, all backslashes such as
c:\directory\file.ext must be converted to forward slashes, as
c:/directory/file.ext. A trailing slash may also be necessary for
directories.
__________________________________________________________________
Installing as an Apache module
You should add the following lines to your Apache httpd.conf file:
Example 2-3. PHP as an Apache 1.3.x module
This assumes PHP is installed to c:\php. Adjust the path if this is not
the case.
For PHP 4:
# Add to the end of the LoadModule section
# Don't forget to copy this file from the sapi directory!
LoadModule php4_module "C:/php/php4apache.dll"
# Add to the end of the AddModule section
AddModule mod_php4.c
For PHP 5:
# Add to the end of the LoadModule section
LoadModule php5_module "C:/php/php5apache.dll"
# Add to the end of the AddModule section
AddModule mod_php5.c
For both:
# Add this line inside the <IfModule mod_mime.c> conditional brace
AddType application/x-httpd-php .php
# For syntax highlighted .phps files, also add
AddType application/x-httpd-php-source .phps
__________________________________________________________________
Installing as a CGI binary
If you unzipped the PHP package to C:\php\ as described in the Manual
Installation Steps section, you need to insert these lines to your
Apache configuration file to set up the CGI binary:
Example 2-4. PHP and Apache 1.3.x as CGI
ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php
# For PHP 4
Action application/x-httpd-php "/php/php.exe"
# For PHP 5
Action application/x-httpd-php "/php/php-cgi.exe"
# specify the directory where php.ini is
SetEnv PHPRC C:/php
Note that the second line in the list above can be found in the actual
versions of httpd.conf, but it is commented out. Remember also to
substitute the c:/php/ for your actual path to PHP.
Warning
By using the CGI setup, your server is open to several possible
attacks. Please read our CGI security section to learn how to defend
yourself from those attacks.
If you would like to present PHP source files syntax highlighted, there
is no such convenient option as with the module version of PHP. If you
chose to configure Apache to use PHP as a CGI binary, you will need to
use the highlight_file() function. To do this simply create a PHP
script file and add this code: <?php
highlight_file('some_php_script.php'); ?>.
__________________________________________________________________
Apache 2.0.x on Microsoft Windows
This section contains notes and hints specific to Apache 2.0.x installs
of PHP on Microsoft Windows systems. We also have instructions and
notes for Apache 1.3.x users on a separate page.
Note: You should read the manual installation steps first!
Apache 2.2.x Support: Users of Apache 2.2.x may use the
documentation below except the appropriate DLL file is named
php5apache2_2.dll and it only exists as of PHP 5.2.0. See also
http://snaps.php.net/
Warning
We do not recommend using a threaded MPM in production with Apache2.
Use the prefork MPM instead, or use Apache1. For information on why,
read the related FAQ entry on using Apache2 with a threaded MPM
You are highly encouraged to take a look at the Apache Documentation to
get a basic understanding of the Apache 2.0.x Server. Also consider to
read the Windows specific notes for Apache 2.0.x before reading on
here.
PHP and Apache 2.0.x compatibility notes: The following versions of
PHP are known to work with the most recent version of Apache 2.0.x:
* PHP 4.3.0 or later available at http://www.php.net/downloads.php.
* the latest stable development version. Get the source code
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -