📄 install.txt
字号:
Example 2-1. PHP 4 package structure
c:\php
|
+--cli
| |
| |-php.exe -- CLI executable - ONLY for command line scripting
|
+--dlls -- support DLLs required by some extensions
| |
| |-expat.dll
| |
| |-fdftk.dll
| |
| |-...
|
+--extensions -- extension DLLs for PHP
| |
| |-php_bz2.dll
| |
| |-php_cpdf.dll
| |
| |-..
|
+--mibs -- support files for SNMP
|
+--openssl -- support files for Openssl
|
+--pdf-related -- support files for PDF
|
+--sapi -- SAPI (server module support) DLLs
| |
| |-php4apache.dll
| |
| |-php4apache2.dll
| |
| |-..
|
+--PEAR -- initial copy of PEAR
|
|
|-go-pear.bat -- PEAR setup script
|
|-..
|
|-php.exe -- CGI executable
|
|-..
|
|-php.ini-dist -- default php.ini settings
|
|-php.ini-recommended -- recommended php.ini settings
|
|-php4ts.dll -- core PHP DLL
|
|-...
Or:
Example 2-2. PHP 5 package structure
c:\php
|
+--dev
| |
| |-php5ts.lib
|
+--ext -- extension DLLs for PHP
| |
| |-php_bz2.dll
| |
| |-php_cpdf.dll
| |
| |-..
|
+--extras
| |
| +--mibs -- support files for SNMP
| |
| +--openssl -- support files for Openssl
| |
| +--pdf-related -- support files for PDF
| |
| |-mime.magic
|
+--pear -- initial copy of PEAR
|
|
|-go-pear.bat -- PEAR setup script
|
|-fdftk.dll
|
|-..
|
|-php-cgi.exe -- CGI executable
|
|-php-win.exe -- executes scripts without an opened command prompt
|
|-php.exe -- CLI executable - ONLY for command line scripting
|
|-..
|
|-php.ini-dist -- default php.ini settings
|
|-php.ini-recommended -- recommended php.ini settings
|
|-php5activescript.dll
|
|-php5apache.dll
|
|-php5apache2.dll
|
|-..
|
|-php5ts.dll -- core PHP DLL
|
|-...
Notice the differences and similarities. Both PHP 4 and PHP 5 have a
CGI executable, a CLI executable, and server modules, but they are
located in different folders and/or have different names. While PHP 4
packages have the server modules in the sapi folder, PHP 5
distributions have no such directory and instead they're in the PHP
folder root. The supporting DLLs for the PHP 5 extensions are also not
in a seperate directory.
Note: In PHP 4, you should move all files located in the dll and
sapi folders to the main folder (e.g. C:\php).
Here is a list of server modules shipped with PHP 4 and PHP 5:
* sapi/php4activescript.dll (php5activescript.dll) - ActiveScript
engine, allowing you to embed PHP in your Windows applications.
* sapi/php4apache.dll (php5apache.dll) - Apache 1.3.x module.
* sapi/php4apache2.dll (php5apache2.dll) - Apache 2.0.x module.
* sapi/php5apache2_2.dll - Apache 2.2.x module.
* sapi/php4isapi.dll (php5isapi.dll) - ISAPI Module for ISAPI
compliant web servers like IIS 4.0/PWS 4.0 or newer.
* sapi/php4nsapi.dll (php5nsapi.dll) - Sun/iPlanet/Netscape server
module.
* sapi/php4pi3web.dll (no equivalent in PHP 5) - Pi3Web server
module.
Server modules provide significantly better performance and additional
functionality compared to the CGI binary. The CLI version is designed
to let you use PHP for command line scripting. More information about
CLI is available in the chapter about using PHP from the command line.
Warning
The SAPI modules have been significantly improved as of the 4.1
release, however, in older systems you may encounter server errors or
other server modules failing, such as ASP.
The CGI and CLI binaries, and the web server modules all require the
php4ts.dll (php5ts.dll) file to be available to them. You have to make
sure that this file can be found by your PHP installation. The search
order for this DLL is as follows:
* The same directory from where php.exe is called, or in case you use
a SAPI module, the web server's directory (e.g. C:\Program
Files\Apache Group\Apache2\bin).
* Any directory in your Windows PATH environment variable.
To make php4ts.dll / php5ts.dll available you have three options: copy
the file to the Windows system directory, copy the file to the web
server's directory, or add your PHP directory, C:\php to the PATH. For
better maintenance, we advise you to follow the last option, add C:\php
to the PATH, because it will be simpler to upgrade PHP in the future.
Read more about how to add your PHP directory to PATH in the
corresponding FAQ entry (and then don't forget to restart the computer
- logoff isn't enough).
The next step is to set up a valid configuration file for PHP, php.ini.
There are two ini files distributed in the zip file, php.ini-dist and
php.ini-recommended. We advise you to use php.ini-recommended, because
we optimized the default settings in this file for performance, and
security. Read this well documented file carefully because it has
changes from php.ini-dist that will drastically affect your setup. Some
examples are display_errors being off and magic_quotes_gpc being off.
In addition to reading these, study the ini settings and set every
element manually yourself. If you would like to achieve the best
security, then this is the way for you, although PHP works fine with
these default ini files. Copy your chosen ini-file to a directory that
PHP is able to find and rename it to php.ini. PHP searches for php.ini
in the locations described in the Section called The configuration file
in Chapter 5 section.
If you are running Apache 2, the simpler option is to use the PHPIniDir
directive (read the installation on Apache 2 page), otherwise your best
option is to set the PHPRC environment variable. This process is
explained in the following FAQ entry.
Note: If you're using NTFS on Windows NT, 2000, XP or 2003, make
sure that the user running the web server has read permissions to
your php.ini (e.g. make it readable by Everyone).
The following steps are optional:
* Edit your new php.ini file. If you plan to use OmniHTTPd, do not
follow the next step. Set the doc_root to point to your web servers
document_root. For example:
doc_root = c:\inetpub\wwwroot // for IIS/PWS
doc_root = c:\apache\htdocs // for Apache
* Choose the extensions you would like to load when PHP starts. See
the section about Windows extensions, about how to set up one, and
what is already built in. Note that on a new installation it is
advisable to first get PHP working and tested without any
extensions before enabling them in php.ini.
* On PWS and IIS, you can set the browscap configuration setting to
point to: c:\windows\system\inetsrv\browscap.ini on Windows 9x/Me,
c:\winnt\system32\inetsrv\browscap.ini on NT/2000, and
c:\windows\system32\inetsrv\browscap.ini on XP. For an up-to-date
browscap.ini, read the following FAQ.
PHP is now setup on your system. The next step is to choose a web
server, and enable it to run PHP. Choose a web server from the table of
contents.
__________________________________________________________________
ActiveScript
This section contains notes specific to the ActiveScript installation.
ActiveScript is a Windows only SAPI that enables you to use PHP script
in any ActiveScript compliant host, like Windows Script Host,
ASP/ASP.NET, Windows Script Components or Microsoft Scriptlet control.
As of PHP 5.0.1, ActiveScript has been moved to the PECL repository.
The DLL for this PECL extension may be downloaded from either the PHP
Downloads page or from http://pecl4win.php.net/
Note: You should read the manual installation steps first!
After installing PHP, you should download the ActiveScript DLL
(php5activescript.dll) and place it in the main PHP folder (e.g.
C:\php).
After having all the files needed, you must register the DLL on your
system. To achieve this, open a Command Prompt window (located in the
Start Menu). Then go to your PHP directory by typing something like cd
C:\php. To register the DLL just type regsvr32 php5activescript.dll.
To test if ActiveScript is working, create a new file, named test.wsf
(the extension is very important) and type:
<job id="test">
<script language="PHPScript">
$WScript->Echo("Hello World!");
</script>
</job>
Save and double-click on the file. If you receive a little window
saying "Hello World!" you're done.
Note: In PHP 4, the engine was named 'ActivePHP', so if you are
using PHP 4, you should replace 'PHPScript' with 'ActivePHP' in the
above example.
Note: ActiveScript doesn't use the default php.ini file. Instead, it
will look only in the same directory as the .exe that caused it to
load. You should create php-activescript.ini and place it in that
folder, if you wish to load extensions, etc.
__________________________________________________________________
Microsoft IIS / PWS
This section contains notes and hints specific to IIS (Microsoft
Internet Information Server).
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.
__________________________________________________________________
General considerations for all installations of PHP with IIS or PWS
* First, read the Manual Installation Instructions. Do not skip this
step as it provides crucial information for installing PHP on
Windows.
* CGI users must set the cgi.force_redirect PHP directive to 0 inside
php.ini. Read the faq on cgi.force_redirect for important details.
Also, CGI users may want to set the cgi.redirect_status_env
directive. When using directives, be sure these directives aren't
commented out inside php.ini.
* The PHP 4 CGI is named php.exe while in PHP 5 it's php-cgi.exe. In
PHP 5, php.exe is the CLI, and not the CGI.
* Modify the Windows PATH environment variable to include the PHP
directory. This way the PHP DLL files and PHP executables can all
remain in the PHP directory without cluttering up the Windows
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -