diff --git a/chapters/install.xml b/chapters/install.xml index ca34fc642d..f48e852775 100644 --- a/chapters/install.xml +++ b/chapters/install.xml @@ -7,8 +7,8 @@ The source code, and binary distributions for some platforms (including Windows), can be found at &url.php;. We recommend - you to choose a near mirror site of php.net for downloading. - You can find one with the dropdown menu on every page. + you to choose mirror nearest + to you for downloading the distrobutions. @@ -60,14 +60,13 @@ There are several ways to install PHP for the Unix platform, either with a compile and configure process, or through various - pre-packaged methods. The user compile and configuration processes - are much more complex, so the documentation is more focused on those - procedures. + pre-packaged methods. This documentation is mainly focused around + the process of compiling and configuring PHP. The initial PHP setup and configuration process is controlled by the - use of commandline options to the configure + use of the commandline options of the configure script. This page outlines the usage of the most common options, but there are many others to play with. Check out the Complete list of configure @@ -142,8 +141,8 @@ Building - When PHP is configured, you are ready to build the CGI executable - or the PHP library. The command make should + When PHP is configured, you are ready to build the CGI executable. + The command make should take care of this. If it fails and you can't figure out why, see the Problems section. @@ -160,12 +159,12 @@ Using Packages Many Linux distributions have some sort of package installation, - such as RPM. This can greatly assist in setting up a standard + such as RPM. This can assist in setting up a standard configuration, but if you need to have a different set of features (such as a secure server, or a different database driver), you may need to build php and/or your webserver. If you are unfamiliar with building and compiling your own software, it is worth - investigating whether or not somebody has already built a packaged + checking to see whether somebody has already built a packaged version of PHP with the features you need. @@ -255,116 +254,113 @@ Paul Mckay. -Solaris installs - - This section contains notes and hints specific to installing - PHP on Solaris systems. - - - Required software + Solaris installs - Solaris installs often lack C compilers and their related tools. - The required software is as follows: - - - - gcc (recommended, other C compilers may work) - - - - - make - - - - - flex - - - - - bison - - - - - m4 - - - - - autoconf - - - - - automake - - - - - perl - - - - - gzip - - - - - tar - - - - In addition, you will need to install (and possibly compile) any - additional software specific to your configuration (such as Oracle - or MySQL. - - + This section contains notes and hints specific to installing + PHP on Solaris systems. + + + Required software + + Solaris installs often lack C compilers and their related tools. + The required software is as follows: + + + + gcc (recommended, other C compilers may work) + + + + + make + + + + + flex + + + + + bison + + + + + m4 + + + + + autoconf + + + + + automake + + + + + perl + + + + + gzip + + + + + tar + + + + In addition, you will need to install (and possibly compile) any + additional software specific to your configuration (such as Oracle + or MySQL. + + + + Using Packages + + You can simplify the Solaris install process by using pkgadd to + install most of your needed components. + + + - - Using Packages - - You can simplify the Solaris install process by using pkgadd to - install most of your needed components. - - - - - - Mac OS X installs - - This section contains notes and hints specific to installing - PHP on Mac OS X. - - - Using Packages - - There are a few pre-packaged and pre-compiled versions of PHP for - Mac OS X. This can greatly assist in setting up a standard - configuration, but if you need to have a different set of features - (such as a secure server, or a different database driver), you may - need to build PHP and/or your web server yourself. If you are unfamiliar - with building and compiling your own software, it's worth - investigating whether or not somebody has already built a packaged - version of PHP with the features you need. - Lightyear Design offers a - pre-built version of PHP for OS X, as does - Tenon Intersystems. - - - - Compiling for OS X server - - There are two slightly different versions of Mac OS X, client and - server. The following is for OS X Server. - - - - Mac OS X server install - - + + Mac OS X installs + + This section contains notes and hints specific to installing + PHP on Mac OS X. + + + Using Packages + + There are a few pre-packaged and pre-compiled versions of PHP for + Mac OS X. This can help in setting up a standard + configuration, but if you need to have a different set of features + (such as a secure server, or a different database driver), you may + need to build PHP and/or your web server yourself. If you are unfamiliar + with building and compiling your own software, it's worth + checking whether somebody has already built a packaged + version of PHP with the features you need. + Lightyear Design offers a + pre-built version of PHP for OS X, as does + Tenon Intersystems. + + + + Compiling for OS X server + + There are two slightly different versions of Mac OS X, client and + server. The following is for OS X Server. + + + Mac OS X server install + 1. Get the latest distributions of Apache and PHP 2. Untar them, and run the configure program on Apache like so. ./configure --exec-prefix=/usr \ @@ -420,6 +416,7 @@ Paul Mckay. date. 9. make + 10. make install 11. copy and rename the php.ini-dist file to your "bin" directory from your @@ -429,1354 +426,1275 @@ Paul Mckay. or (if your don't have a local directory) cp php.ini-dist /usr/bin/php.ini - - + + - - Other examples for - Mac OS X client - and - Mac OS X server - are available at Stepwise. - - - + + Other examples for + Mac OS X client + and + Mac OS X server + are available at Stepwise. + + + - - Complete list of configure options + + Complete list of configure options + + + These are only used at compile time. If you want to alter PHP's + runtime configuration, please see the chapter on Configuration. + + - - - These are only used at compile time. If you want to alter PHP's - runtime configuration, please see the chapter on Configuration. - - + + The following is a complete list of options supported by the PHP 3 + and PHP 4 configure scripts, used when + compiling in Unix-like environments. Some are available in PHP 3, + some in PHP 4, and some in both, as noted. There are many options + the names of which have changed between PHP 3 and PHP 4, but which + accomplish the same things. These entries are cross-referenced to + each other, so if you have a problem getting your PHP 3-era + configuration options to work, check here to see whether the names + have changed. + + + - The following is a complete list of options supported by the PHP 3 - and PHP 4 configure scripts, used when - compiling in Unix-like environments. Some are available in PHP 3, - some in PHP 4, and some in both, as noted. There are many options - the names of which have changed between PHP 3 and PHP 4, but which - accomplish the same things. These entries are cross-referenced to - each other, so if you have a problem getting your PHP 3-era - configuration options to work, check here to see whether the names - have changed. + Database + + + + Ecommerce + + + + + Graphics + + + + + Miscellaneous + + + + + Networking + + + + + PHP Behaviour + + + + + Server + + + + + Text and language + + + + + XML + + + - + + Database + + + + + --with-adabas[=DIR] + + + + PHP 3, PHP 4: Include Adabas D support. DIR is the Adabas base + install directory, defaults to /usr/local. + + + Adabas home page + + + + + + --enable-dba=shared + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Build DBA as a shared module + + + + + + --enable-dbase + + + + PHP 3: Option not available; use --with-dbase + instead. + + + PHP 4: Enable the bundled dbase library. No external libraries + are required. + + + + + + --with-dbase + + + + PHP 3: Include the bundled dbase library. No external + libraries are required. + + + PHP 4: Option not available; use --enable-dbase + instead. + + + + + + --with-db2[=DIR] + + + + PHP 3, PHP 4: Include Berkeley DB2 support + + + + + + --with-db3[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include Berkeley DB3 support + + + + + + --with-dbm[=DIR] + + + + PHP 3, PHP 4: Include DBM support + + + + + + --with-dbmaker[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include DBMaker support. DIR is the DBMaker base install + directory, defaults to where the latest version of DBMaker is installed + (such as /home/dbmaker/3.6). + + + + + + --with-empress[=DIR] + + + + PHP 3, PHP 4: Include Empress support. DIR is the Empress base install + directory, defaults to $EMPRESSPATH + + + + + + --enable-filepro + + + + PHP 3: Option not available; use --with-filepro + instead. + + + PHP 4: Enable the bundled read-only filePro support. No + external libraries are required. + + + + + + --with-filepro + + + + PHP 3: Include the bundled read-only filePro support. No + external libraries are required. + + + PHP 4: Option not available; use --enable-filepro + instead. + + + + + + --with-gdbm[=DIR] + + + + PHP 3, PHP 4: Include GDBM support + + + + + + --with-hyperwave + + + + PHP 3, PHP 4: Include Hyperwave support + + + + + + --with-ibm-db2[=DIR] + + + + PHP 3, PHP 4: Include IBM DB2 support. DIR is the DB2 base + install directory, defaults to + /home/db2inst1/sqllib. + + + IBM DB2 home page + + + + + + --with-informix[=DIR] + + + + PHP 3, PHP 4: Include Informix support. DIR is the Informix base install + directory, defaults to nothing. + + + + + + --with-ingres[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include Ingres II support. DIR is the Ingres base directory + (default /II/ingres) + + + + + + --with-interbase[=DIR] + + + + PHP 3, PHP 4: Include InterBase support. DIR is the InterBase base + install directory, which defaults to /usr/interbase. + + + Interbase functions + + + Interbase home page + + + + + + --with-ldap[=DIR] + + + + PHP 3: Include LDAP support. DIR is the LDAP base install + directory. Defaults to /usr and + /usr/local + + + PHP 4: Include LDAP support. DIR is the LDAP base install directory. + + + This provides LDAP (Lightweight Directory Access + Protocol support). The parameter is the LDAP base install + directory, defaults to /usr/local/ldap. + + + More information about LDAP can be found in RFC1777 and + RFC1778. + + + + + + --with-msql[=DIR] + + + + PHP 3, PHP 4: Enables mSQL support. The parameter to this + option is the mSQL install directory and defaults to /usr/local/Hughes. This is the + default directory of the mSQL 2.0 distribution. + configure automatically detects which mSQL + version you are running and PHP supports both 1.0 and 2.0, but + if you compile PHP with mSQL 1.0, you can only access mSQL 1.0 + databases, and vice-versa. + + + See also mSQL + Configuration Directives in the configuration file. + + + mSQL home page + + + + + + --with-mysql[=DIR] + + + + PHP 3: Include MySQL support. DIR is the MySQL base install directory, + defaults to searching through a number of common places for the MySQL + files. + + + PHP 4: Include MySQL support. DIR is the MySQL base directory. If + unspecified, the bundled MySQL library will be used. This + option is turned on by default. + + + See also MySQL + Configuration Directives in the configuration file. + + + MySQL home page + + + + + + --with-ndbm[=DIR] + + + + PHP 3, PHP 4: Include NDBM support + + + + + + --with-oci8[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include Oracle-oci8 support. Default DIR is ORACLE_HOME. + + + + + + --with-oracle[=DIR] + + + + PHP 3: Include Oracle database support. DIR is Oracle's home directory, + defaults to $ORACLE_HOME. + + + PHP 4: Include Oracle-oci7 support. Default DIR is ORACLE_HOME. + + + Includes Oracle support. Has been tested and should be + working at least with Oracle versions 7.0 through 7.3. The + parameter is the ORACLE_HOME directory. You do + not have to specify this parameter if your Oracle environment + has been set up. + + + Oracle home page + + + + + + --with-pgsql[=DIR] + - Database + PHP 3: Include PostgresSQL support. DIR is the PostgresSQL base + install directory, which defaults to + /usr/local/pgsql. + + PHP 4: Include PostgreSQL support. DIR is the PostgreSQL base + install directory, which defaults to + /usr/local/pgsql. Set DIR to shared to + build as a dl, or shared,DIR to build as a dl and still specify + DIR. + + + See also Postgres + Configuration Directives in the configuration file. + + + PostgreSQL home page + + + + + --with-solid[=DIR] + - Ecommerce + PHP 3, PHP 4: Include Solid support. DIR is the Solid base install + directory, defaults to /usr/local/solid + + Solid home page + + + + + --with-sybase-ct[=DIR] + - Graphics + PHP 3, PHP 4: Include Sybase-CT support. DIR is the Sybase home + directory, defaults to /home/sybase. + + See also Sybase-CT + Configuration Directives in the configuration + file. + + + + + --with-sybase[=DIR] + - Miscellaneous + PHP 3, PHP 4: Include Sybase-DB support. DIR is the Sybase home + directory, which defaults to /home/sybase. + + See also Sybase + Configuration Directives in the configuration file. + + + Sybase home page + + + + + --with-openlink[=DIR] + - Networking + PHP 3, PHP 4: Include OpenLink ODBC support. DIR is the OpenLink base + install directory, defaults to /usr/local/openlink. + + OpenLink Software's home page + + + + + --with-iodbc[=DIR] + - PHP Behaviour + PHP 3, PHP 4: Include iODBC support. DIR is the iODBC base install + directory, defaults to /usr/local. + + This feature was first developed for iODBC Driver Manager, a + freely redistributable ODBC driver manager which runs under + many flavors of UNIX. + + + FreeODBC home page + or iODBC home page + + + + + --with-custom-odbc[=DIR] + - Server + PHP 3, PHP 4: Includes support for an arbitrary custom ODBC + library. The parameter is the base directory and defaults to + /usr/local. + + This option implies that you have defined CUSTOM_ODBC_LIBS + when you run the configure script. You also must have a valid + odbc.h header somewhere in your include path. If you don't + have one, create it and include your specific header from + there. Your header may also require some extra definitions, + particularly when it is multiplatform. Define them in + CFLAGS. + + + For example, you can use Sybase SQL Anywhere on QNX as + following: + + CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib + -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 + + + + + + --disable-unified-odbc + - Text and language + PHP 3: Disable unified ODBC support. Only applicable if iODBC, Adabas, + Solid, Velocis or a custom ODBC interface is enabled. + + PHP 4: Option not available in PHP 4 + + + The Unified ODBC module, which is a common interface to all + the databases with ODBC-based interfaces, such as Solid, IBM + DB2 and Adabas D. It also works for normal ODBC libraries. + Has been tested with iODBC, Solid, Adabas D, IBM DB2 and + Sybase SQL Anywhere. Requires that one (and only one) of these + extensions or the Velocis extension is enabled, or a custom ODBC + library specified. This option is only applicable if one of + the following options is used: --with-iodbc, + --with-solid, + --with-ibm-db2, + --with-adabas, + --with-velocis, + or --with-custom-odbc. + + + See also Unified ODBC + Configuration Directives in the configuration + file. + + + + + --with-unixODBC[=DIR] + - XML + PHP 3: Option not available in PHP 3 + + + PHP 4: Include unixODBC support. DIR is the unixODBC base install + directory, defaults to /usr/local. - - - - Database - - - - - --with-adabas[=DIR] - - - - PHP 3, PHP 4: Include Adabas D support. DIR is the Adabas base - install directory, defaults to /usr/local. - - - Adabas home page - - - - - - - --enable-dba=shared - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Build DBA as a shared module - - - - - - - --enable-dbase - - - - PHP 3: Option not available; use --with-dbase - instead. - - - PHP 4: Enable the bundled dbase library. No external libraries - are required. - - - - - - - --with-dbase - - - - PHP 3: Include the bundled dbase library. No external - libraries are required. - - - PHP 4: Option not available; use --enable-dbase - instead. - - - - - - - --with-db2[=DIR] - - - - PHP 3, PHP 4: Include Berkeley DB2 support - - - - - - - --with-db3[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include Berkeley DB3 support - - - - - - - --with-dbm[=DIR] - - - - PHP 3, PHP 4: Include DBM support - - - - - - - --with-dbmaker[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include DBMaker support. DIR is the DBMaker base install - directory, defaults to where the latest version of DBMaker is installed - (such as /home/dbmaker/3.6). - - - - - - - --with-empress[=DIR] - - - - PHP 3, PHP 4: Include Empress support. DIR is the Empress base install - directory, defaults to $EMPRESSPATH - - - - - - - --enable-filepro - - - - PHP 3: Option not available; use --with-filepro - instead. - - - PHP 4: Enable the bundled read-only filePro support. No - external libraries are required. - - - - - - - --with-filepro - - - - PHP 3: Include the bundled read-only filePro support. No - external libraries are required. - - - PHP 4: Option not available; use --enable-filepro - instead. - - - - - - - --with-gdbm[=DIR] - - - - PHP 3, PHP 4: Include GDBM support - - - - - - - --with-hyperwave - - - - PHP 3, PHP 4: Include Hyperwave support - - - - - - - --with-ibm-db2[=DIR] - - - - PHP 3, PHP 4: Include IBM DB2 support. DIR is the DB2 base - install directory, defaults to - /home/db2inst1/sqllib. - - - IBM DB2 home page - - - - - - - --with-informix[=DIR] - - - - PHP 3, PHP 4: Include Informix support. DIR is the Informix base install - directory, defaults to nothing. - - - - - - - --with-ingres[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include Ingres II support. DIR is the Ingres base directory - (default /II/ingres) - - - - - - - --with-interbase[=DIR] - - - - PHP 3, PHP 4: Include InterBase support. DIR is the InterBase base - install directory, which defaults to /usr/interbase. - - - Interbase functions - - - Interbase home page - - - - - - - --with-ldap[=DIR] - - - - PHP 3: Include LDAP support. DIR is the LDAP base install - directory. Defaults to /usr and - /usr/local - - - PHP 4: Include LDAP support. DIR is the LDAP base install directory. - - - This provides LDAP (Lightweight Directory Access - Protocol support). The parameter is the LDAP base install - directory, defaults to /usr/local/ldap. - - - More information about LDAP can be found in RFC1777 and - RFC1778. - - - - - - - --with-msql[=DIR] - - - - PHP 3, PHP 4: Enables mSQL support. The parameter to this - option is the mSQL install directory and defaults to /usr/local/Hughes. This is the - default directory of the mSQL 2.0 distribution. - configure automatically detects which mSQL - version you are running and PHP supports both 1.0 and 2.0, but - if you compile PHP with mSQL 1.0, you can only access mSQL 1.0 - databases, and vice-versa. - - - See also mSQL - Configuration Directives in the configuration file. - - - mSQL home page - - - - - - - --with-mysql[=DIR] - - - - PHP 3: Include MySQL support. DIR is the MySQL base install directory, - defaults to searching through a number of common places for the MySQL - files. - - - PHP 4: Include MySQL support. DIR is the MySQL base directory. If - unspecified, the bundled MySQL library will be used. This - option is turned on by default. - - - See also MySQL - Configuration Directives in the configuration file. - - - MySQL home page - - - - - - - --with-ndbm[=DIR] - - - - PHP 3, PHP 4: Include NDBM support - - - - - - - --with-oci8[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include Oracle-oci8 support. Default DIR is ORACLE_HOME. - - - - - - - --with-oracle[=DIR] - - - - PHP 3: Include Oracle database support. DIR is Oracle's home directory, - defaults to $ORACLE_HOME. - - - PHP 4: Include Oracle-oci7 support. Default DIR is ORACLE_HOME. - - - Includes Oracle support. Has been tested and should be - working at least with Oracle versions 7.0 through 7.3. The - parameter is the ORACLE_HOME directory. You do - not have to specify this parameter if your Oracle environment - has been set up. - - - Oracle home page - - - - - - - --with-pgsql[=DIR] - - - - PHP 3: Include PostgresSQL support. DIR is the PostgresSQL base - install directory, which defaults to - /usr/local/pgsql. - - - PHP 4: Include PostgreSQL support. DIR is the PostgreSQL base - install directory, which defaults to - /usr/local/pgsql. Set DIR to shared to - build as a dl, or shared,DIR to build as a dl and still specify - DIR. - - - See also Postgres - Configuration Directives in the configuration file. - - - PostgreSQL home page - - - - - - - --with-solid[=DIR] - - - - PHP 3, PHP 4: Include Solid support. DIR is the Solid base install - directory, defaults to /usr/local/solid - - - Solid home page - - - - - - - --with-sybase-ct[=DIR] - - - - PHP 3, PHP 4: Include Sybase-CT support. DIR is the Sybase home - directory, defaults to /home/sybase. - - - See also Sybase-CT - Configuration Directives in the configuration - file. - - - - - - - --with-sybase[=DIR] - - - - PHP 3, PHP 4: Include Sybase-DB support. DIR is the Sybase home - directory, which defaults to /home/sybase. - - - See also Sybase - Configuration Directives in the configuration file. - - - Sybase home page - - - - - - - --with-openlink[=DIR] - - - - PHP 3, PHP 4: Include OpenLink ODBC support. DIR is the OpenLink base - install directory, defaults to /usr/local/openlink. - - - OpenLink Software's home page - - - - - - - --with-iodbc[=DIR] - - - - PHP 3, PHP 4: Include iODBC support. DIR is the iODBC base install - directory, defaults to /usr/local. - - - This feature was first developed for iODBC Driver Manager, a - freely redistributable ODBC driver manager which runs under - many flavors of UNIX. - - - FreeODBC home page - or iODBC home page - - - - - - - --with-custom-odbc[=DIR] - - - - PHP 3, PHP 4: Includes support for an arbitrary custom ODBC - library. The parameter is the base directory and defaults to - /usr/local. - - - This option implies that you have defined CUSTOM_ODBC_LIBS - when you run the configure script. You also must have a valid - odbc.h header somewhere in your include path. If you don't - have one, create it and include your specific header from - there. Your header may also require some extra definitions, - particularly when it is multiplatform. Define them in - CFLAGS. - - - For example, you can use Sybase SQL Anywhere on QNX as - following: - - CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib - -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50 - - - - - - - - --disable-unified-odbc - - - - PHP 3: Disable unified ODBC support. Only applicable if iODBC, Adabas, - Solid, Velocis or a custom ODBC interface is enabled. - - - PHP 4: Option not available in PHP 4 - - - The Unified ODBC module, which is a common interface to all - the databases with ODBC-based interfaces, such as Solid, IBM - DB2 and Adabas D. It also works for normal ODBC libraries. - Has been tested with iODBC, Solid, Adabas D, IBM DB2 and - Sybase SQL Anywhere. Requires that one (and only one) of these - extensions or the Velocis extension is enabled, or a custom ODBC - library specified. This option is only applicable if one of - the following options is used: --with-iodbc, - --with-solid, - --with-ibm-db2, - --with-adabas, - --with-velocis, - or --with-custom-odbc. - - - See also Unified ODBC - Configuration Directives in the configuration - file. - - - - - - - --with-unixODBC[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include unixODBC support. DIR is the unixODBC base install - directory, defaults to /usr/local. - - - - - - - --with-velocis[=DIR] - - - - PHP 3, PHP 4: Include Velocis support. DIR is the Velocis base install - directory, defaults to /usr/local/velocis. - - - Velocis home page - - - - - + + + + --with-velocis[=DIR] + + + + PHP 3, PHP 4: Include Velocis support. DIR is the Velocis base install + directory, defaults to /usr/local/velocis. + + + Velocis home page + + + + + - - Ecommerce - - - + + Ecommerce + + + + --with-ccvs[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Compile CCVS support into PHP 4. Please specify your CCVS base + install directory as DIR. + + + + + + --with-mck[=DIR] + + + + PHP 3: Include Cybercash MCK support. DIR is the cybercash mck + build directory, which defaults to + /usr/src/mck-3.2.0.3-linux. For help, look + in extra/cyberlib. + + + PHP 4: Option not available; use --with-cybercash + instead. + + + + + + --with-cybercash[=DIR] + + + + PHP 3: Option not available; use --with-mck + instead. + + + PHP 4: Include CyberCash support. DIR is the CyberCash MCK install + directory. + + + + - --with-ccvs[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Compile CCVS support into PHP 4. Please specify your CCVS base - install directory as DIR. - - - + --with-pfpro[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include Verisign Payflow Pro support + + + + + + + + Graphics + + + + --enable-freetype-4bit-antialias-hack + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Include support for FreeType2 (experimental). + + + + + + --with-gd[=DIR] + + + + PHP 3: Include GD support (DIR is GD's install dir). + + + PHP 4: Include GD support (DIR is GD's install dir). Set DIR to shared + to build as a dl, or shared,DIR to build as a dl and still specify DIR. + + + + + + --without-gd + + + + PHP 3, PHP 4: Disable GD support. + + + - - - --with-mck[=DIR] - - - - PHP 3: Include Cybercash MCK support. DIR is the cybercash mck - build directory, which defaults to - /usr/src/mck-3.2.0.3-linux. For help, look - in extra/cyberlib. - - - PHP 4: Option not available; use --with-cybercash - instead. - - - + + + --with-imagick[=DIR] + + + + PHP 3: Include ImageMagick support. DIR is the install + directory, and if left out, PHP will try to find it on its + own. [experimental] + + + PHP 4: Option not available in PHP 4 + + + + + + --with-jpeg-dir[=DIR] + + + + PHP 3: jpeg dir for pdflib 2.0 + + + PHP 4: jpeg dir for pdflib 3.x + + + + + + --with-png-dir[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: png dir for pdflib 3.x + + + + + + --enable-t1lib + + + + PHP 3: Enable t1lib support. + + + PHP 4: Option not available; use --with-t1lib + instead. + + + + + + --with-t1lib[=DIR] + + + + PHP 3: Option not available; use --enable-t1lib + instead. + + + PHP 4: Include T1lib support. + + + + + + --with-tiff-dir[=DIR] + + + + PHP 3: tiff dir for pdflib 2.0 + + + PHP 4: tiff dir for pdflib 3.x + + + + + + --with-ttf[=DIR] + + + + PHP 3, PHP 4: Include FreeType support + + + + + + --with-xpm-dir[=DIR] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: xpm dir for gd-1.8+ + + + + + - - - --with-cybercash[=DIR] - - - - PHP 3: Option not available; use --with-mck - instead. - - - PHP 4: Include CyberCash support. DIR is the CyberCash MCK install - directory. - - - - - - - --with-pfpro[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include Verisign Payflow Pro support - - - - - - - - - Graphics - - - - - --enable-freetype-4bit-antialias-hack - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Include support for FreeType2 (experimental). - - - - - - - --with-gd[=DIR] - - - - PHP 3: Include GD support (DIR is GD's install dir). - - - PHP 4: Include GD support (DIR is GD's install dir). Set DIR to shared - to build as a dl, or shared,DIR to build as a dl and still specify DIR. - - - - - - - --without-gd - - - - PHP 3, PHP 4: Disable GD support. - - - - - - - --with-imagick[=DIR] - - - - PHP 3: Include ImageMagick support. DIR is the install - directory, and if left out, PHP will try to find it on its - own. [experimental] - - - PHP 4: Option not available in PHP 4 - - - - - - - --with-jpeg-dir[=DIR] - - - - PHP 3: jpeg dir for pdflib 2.0 - - - PHP 4: jpeg dir for pdflib 3.x - - - - - - - --with-png-dir[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: png dir for pdflib 3.x - - - - - - - --enable-t1lib - - - - PHP 3: Enable t1lib support. - - - PHP 4: Option not available; use --with-t1lib - instead. - - - - - - - --with-t1lib[=DIR] - - - - PHP 3: Option not available; use --enable-t1lib - instead. - - - PHP 4: Include T1lib support. - - - - - - - --with-tiff-dir[=DIR] - - - - PHP 3: tiff dir for pdflib 2.0 - - - PHP 4: tiff dir for pdflib 3.x - - - - - - - --with-ttf[=DIR] - - - - PHP 3, PHP 4: Include FreeType support - - - - - - - --with-xpm-dir[=DIR] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: xpm dir for gd-1.8+ - - - - - - - - Miscellaneous - - - These are being classified over time, where appropriate. - - - - - - --disable-bcmath - - - - PHP 3: Compile without BC arbitrary precision math - functions. These functions allow you to operate with numbers - outside of the ranges allowed by regular integers and floats; - see BCMath Arbitrary Precision - Mathematics Functions for more information. - - - PHP 4: Option not available; bcmath is not compiled in by - default. Use --enable-bcmath - to compile it in. - - - - - - - --disable-display-source - - - - PHP 3: Compile without displaying source support - - - PHP 4: Option not available in PHP 4 - - - + + Miscellaneous + + These are being classified over time, where appropriate. + + + + + --disable-bcmath + + + + PHP 3: Compile without BC arbitrary precision math + functions. These functions allow you to operate with numbers + outside of the ranges allowed by regular integers and floats; + see BCMath Arbitrary Precision + Mathematics Functions for more information. + + + PHP 4: Option not available; bcmath is not compiled in by + default. Use --enable-bcmath + to compile it in. + + + + + + --disable-display-source + + + + PHP 3: Compile without displaying source support + + + PHP 4: Option not available in PHP 4 + + + - - --disable-libtool-lock - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: avoid locking (might break parallel builds) - - - - - - - --disable-pear - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Do not install PEAR - - - - - - - --disable-pic - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Disable PIC for shared objects - - - - - - - --disable-posix - - - - PHP 3: Option not available in PHP 3; use --without-posix - instead. - - - PHP 4: Disable POSIX-like functions - - - - - - - --disable-rpath - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Disable passing additional runtime library search paths - - - - - - - --disable-session - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Disable session support - - - - - - - --enable-bcmath - - - - PHP 3: Option not available in PHP 3; bcmath is compiled in - by default. Use --disable-bcmath - to disable it. - - - PHP 4: Compile with bc style precision math functions. Read - README-BCMATH for instructions on how to get this module - installed. These functions allow you to operate with numbers - outside of the ranges allowed by regular integers and floats; - see BCMath Arbitrary Precision - Mathematics Functions for more information. - - - - - - - --enable-c9x-inline - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable C9x-inline semantics - - - - - - - --enable-calendar - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable support for calendar conversion - - - - - - - --enable-debug - - - - PHP 3, PHP 4: Compile with debugging symbols. - - - - - - - --enable-debugger - - - - PHP 3: Compile with remote debugging functions - - - PHP 4: Option not available in PHP 4 - - - - - - - --enable-discard-path - - - - PHP 3, PHP 4: If this is enabled, the PHP CGI binary can safely be - placed outside of the web tree and people will not be able to circumvent - .htaccess security. - - - - - - - --enable-dmalloc - - - - PHP 3, PHP 4: Enable dmalloc - - - - - - - --enable-exif - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable exif support - - - - - - - --enable-experimental-zts - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: This will most likely break your build - - - - - - - --enable-fast-install[=PKGS] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: optimize for fast installation [default=yes] - - - - - - - --enable-force-cgi-redirect - - - - PHP 3, PHP 4: Enable the security check for internal server redirects. - You should use this if you are running the CGI version with Apache. - - - - + + --disable-libtool-lock + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: avoid locking (might break parallel builds) + + + + + + --disable-pear + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Do not install PEAR + + + + + + --disable-pic + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Disable PIC for shared objects + + + + + + --disable-posix + + + + PHP 3: Option not available in PHP 3; use --without-posix + instead. + + + PHP 4: Disable POSIX-like functions + + + + + + --disable-rpath + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Disable passing additional runtime library search paths + + + + + + --disable-session + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Disable session support + + + + + + --enable-bcmath + + + + PHP 3: Option not available in PHP 3; bcmath is compiled in + by default. Use --disable-bcmath + to disable it. + + + PHP 4: Compile with bc style precision math functions. Read + README-BCMATH for instructions on how to get this module + installed. These functions allow you to operate with numbers + outside of the ranges allowed by regular integers and floats; + see BCMath Arbitrary Precision + Mathematics Functions for more information. + + + + + + --enable-c9x-inline + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable C9x-inline semantics + + + + + + --enable-calendar + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable support for calendar conversion + + + + + + --enable-debug + + + + PHP 3, PHP 4: Compile with debugging symbols. + + + + + + --enable-debugger + + + + PHP 3: Compile with remote debugging functions + + + PHP 4: Option not available in PHP 4 + + + + + + --enable-discard-path + + + + PHP 3, PHP 4: If this is enabled, the PHP CGI binary can safely be + placed outside of the web tree and people will not be able to circumvent + .htaccess security. + + + + + + --enable-dmalloc + + + + PHP 3, PHP 4: Enable dmalloc + + + + + + --enable-exif + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable exif support + + + + + + --enable-experimental-zts + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: This will most likely break your build + + + + + + --enable-fast-install[=PKGS] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: optimize for fast installation [default=yes] + + + + + + --enable-force-cgi-redirect + + + + PHP 3, PHP 4: Enable the security check for internal server redirects. + You should use this if you are running the CGI version with Apache. + + + - - --enable-inline-optimization - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: If you have much memory and are using gcc, you might try this. - - - - + + --enable-inline-optimization + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: If you have much memory and are using gcc, you might try this. + + + - - --enable-libgcc - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable explicitly linking against libgcc - - - - - - - --enable-maintainer-mode - - - - PHP 3, PHP 4: enable make rules and dependencies not useful (and - sometimes confusing) to the casual installer - - - - - - - --enable-memory-limit - - - - PHP 3, PHP 4: Compile with memory limit support. [default=no] - - - - - - - --enable-safe-mode - - - - PHP 3, PHP 4: Enable safe mode by default. - - - - - - - --enable-satellite - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable CORBA support via Satellite (Requires ORBit) - - - - - - - --enable-shared[=PKGS] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: build shared libraries [default=yes] - - - - - - - --enable-sigchild - - - + + --enable-libgcc + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable explicitly linking against libgcc + + + + + + --enable-maintainer-mode + + + + PHP 3, PHP 4: enable make rules and dependencies not useful (and + sometimes confusing) to the casual installer + + + + + + --enable-memory-limit + + + + PHP 3, PHP 4: Compile with memory limit support. [default=no] + + + + + + --enable-safe-mode + + + + PHP 3, PHP 4: Enable safe mode by default. + + + + + + --enable-satellite + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable CORBA support via Satellite (Requires ORBit) + + + + + + --enable-shared[=PKGS] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: build shared libraries [default=yes] + + + + + + --enable-sigchild + + + PHP 3, PHP 4: Enable PHP's own SIGCHLD handler. - - - - - - - --enable-static[=PKGS] - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: build static libraries [default=yes] - - - - - - - --enable-sysvsem - - - - PHP 3, PHP 4: Enable System V semaphore support. - - - - - - - --enable-sysvshm - - - - PHP 3, PHP 4: Enable the System V shared memory support - - - - - - - --enable-trans-sid - - - - PHP 3: Option not available in PHP 3 - - - PHP 4: Enable transparent session id propagation - - - + + + + + + --enable-static[=PKGS] + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: build static libraries [default=yes] + + + + + + --enable-sysvsem + + + + PHP 3, PHP 4: Enable System V semaphore support. + + + + + + --enable-sysvshm + + + + PHP 3, PHP 4: Enable the System V shared memory support + + + + + + --enable-trans-sid + + + + PHP 3: Option not available in PHP 3 + + + PHP 4: Enable transparent session id propagation + + + @@ -2253,14 +2171,14 @@ Paul Mckay. PHP 3, PHP 4: Disable the URL-aware fopen wrapper that allows accessing files via http or ftp. - - - This switch is only available for PHP versions up to 4.0.3, newer - versions provide an INI parameter called + + + This switch is only available for PHP versions up to 4.0.3, newer + versions provide an INI parameter called allow_url_fopen instead of forcing you to decide upon this feature at compile time. - - + + @@ -2501,10 +2419,10 @@ Paul Mckay. PHP 4: Build PHP as a Pike module for use with the Caudium - webserver. DIR is the Caudium base directory. If no directory - is specified $prefix/caudium/server is used. The prefix is - controlled by the --prefix option and is /usr/local per - default. + webserver. DIR is the Caudium base directory. If no directory + is specified $prefix/caudium/server is used. The prefix is + controlled by the --prefix option and is /usr/local per + default. @@ -2785,7 +2703,7 @@ Paul Mckay. There are two main ways to install PHP for Windows: either manually - or by using an InstallShield + or by using the InstallShield installer. @@ -2804,7 +2722,7 @@ Paul Mckay. The Windows PHP installer available from the downloads page at - &url.php; installs the CGI version + &url.php;, this installs the CGI version of PHP and, for IIS, PWS, and Xitami, configures the web server as well. @@ -2840,62 +2758,62 @@ Paul Mckay. General Installation Steps - - This install guide will help you manually install and configure - PHP on your Windows 9x/Me/NT/2000 webservers. This guide was compiled by - &link.bob;. The original version can be found at &url.win32install;. - - - This guide provides manual installation support for: - - - - Personal Web Server 3 and 4 or newer - - - - - Internet Information Server 3 and 4 or newer - - - - - Apache 1.3.x - - - - - OmniHTTPd 2.0b1 and up - - - - - Oreilly Website Pro - - - - - Xitami - - - - - - PHP 4 for Windows comes in two flavours - a CGI executable (php.exe), - and several SAPI modules (for exapmle php4isapi.dll). The latter form - is new to PHP 4, and provides significantly improved performance and - some new functionality. However, please note that the SAPI modules - are NOT yet considered to be production quality. - The reason for this is that the PHP SAPI modules are using the - thread-safe version of the PHP code, which is new to PHP 4, and has - not yet been tested and pounded enough to be considered completely - stable, and there are actually a few known bugs. On the other hand, - some people have reported very good results with the SAPI modules, - even though we're not aware of anyone actually running it on a - production site. In short - your mileage may vary; If you need - absolute stability, trade the performance of the SAPI modules - with the stability of the CGI executable. + + This install guide will help you manually install and configure + PHP on your Windows 9x/Me/NT/2000 webservers. This guide was compiled by + &link.bob;. The original version can be found at &url.win32install;. + + + This guide provides manual installation support for: + + + + Personal Web Server 3 and 4 or newer + + + + + Internet Information Server 3 and 4 or newer + + + + + Apache 1.3.x + + + + + OmniHTTPd 2.0b1 and up + + + + + Oreilly Website Pro + + + + + Xitami + + + + + + PHP 4 for Windows comes in two flavours - a CGI executable (php.exe), + and several SAPI modules (for exapmle php4isapi.dll). The latter form + is new to PHP 4, and provides significantly improved performance and + some new functionality. However, please note that the SAPI modules + are NOT yet considered to be production quality. + The reason for this is that the PHP SAPI modules are using the + thread-safe version of the PHP code, which is new to PHP 4, and has + not yet been tested and pounded enough to be considered completely + stable, and there are actually a few known bugs. On the other hand, + some people have reported very good results with the SAPI modules, + even though we're not aware of anyone actually running it on a + production site. In short - your mileage may vary; If you need + absolute stability, trade the performance of the SAPI modules + with the stability of the CGI executable. If you choose one of the SAPI modules and use Windows 95, be sure @@ -2910,7 +2828,6 @@ Paul Mckay. The following steps should be performed on all installations before the server specific instructions. - @@ -3507,7 +3424,7 @@ Paul Mckay. If you would like to use PHP as a module in Apache, you should move php4ts.dll to - the windows/system (for Windows 9x/Me) or windows/system32 + the windows/system (for Windows 9x/Me) or winnt/system32 (for Windows NT/2000) directory, overwriting any older file. Then you should add the following two lines to you Apache conf file: @@ -3534,8 +3451,8 @@ Paul Mckay. script file and stick this code in: <?php show_source ("original_php_script.php"); ?>. Substitute original_php_script.php with the name of the - file you wish to show the source of. (This is only one way of - doing it). + file you wish to show the source of. (This is the only way of + doing so). @@ -3629,11 +3546,12 @@ Paul Mckay. 6. Restart Caudium if it's currently running. 7. Log into the graphical configuration interface and go to the virtual server where you want to add PHP 4 support. -8. Click Add Module and locate and add the PHP 4 Script Support module. +8. Click Add Module and locate and then add the PHP 4 Script Support module. 9. If the documentation says that the 'PHP 4 interpreter isn't available', make sure that you restarted the server. If you did check /opt/caudium/logs/debug/default.1 for any errors related to - PHP 4.so. Also make sure that caudium/server/lib/[pike-version]/PHP4.so + PHP4.so. Also make sure that + caudium/server/lib/[pike-version]/PHP4.so is present. 10. Configure the PHP Script Support module if needed. @@ -3660,7 +3578,7 @@ Paul Mckay. IIS/PWS Server installs This section contains notes and hints specific to IIS (Microsoft - Internet Information Server) installs of PHP for + Internet Information Server) installing PHP for PWS/IIS 3, PWS 4 or newer and IIS 4 or newer versions. @@ -3820,7 +3738,7 @@ Paul Mckay. When installing PHP on Windows with PWS 4 or newer version, - you have to options. One to set up the PHP CGI binary, + you have two options. One to set up the PHP CGI binary, the other is to use the ISAPI module dll. @@ -3881,13 +3799,13 @@ Paul Mckay. 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). Then - right click on your Web server node (will most probably + Panel=>Administrative Tools under Windows 2000). Then + right click on your Web server node (this will most probably appear as 'Default Web Server'), and select 'Properties'. - Now if you want to use the CGI binary, do the following: + If you want to use the CGI binary, do the following: @@ -3911,7 +3829,7 @@ Paul Mckay. associated with PHP scripts. Leave 'Method exclusions' blank, and check the Script engine checkbox. You must repeat step 3 and 4 for each extension you - want accociated with PHP scripts. + want associated with PHP scripts. (.php and .phtml are common.) @@ -4150,10 +4068,10 @@ From: bhager@invacare.com You can choose at setup time to do a custom setup, and uncheck the PHP component. We recommend you to use the latest PHP binaries. Some OmniHTTPd servers come with PHP 4 beta - distributions, so you should rather choose not to set up + distributions, so you should choose not to set up the built in support, but install your own. If the server is already on your machine, use the Replace button in Step - 4 and 5 to set the new information. + 4 and 5 to set the new, correct information. @@ -4191,7 +4109,7 @@ From: bhager@invacare.com - Now select "Content Types" add the same extension ".php" + Select "Content Types" add the same extension ".php" and enter the content type. If you choose the CGI exe file, enter 'wwwserver/shellcgi', if you chosse the ISAPI module, enter 'wwwserver/isapi' (both without @@ -4228,7 +4146,7 @@ From: bhager@invacare.com - Now navigate to the Filters, and put the + Navigate to the Filters, and put the extension which php should parse (i.e. .php) into the field File extensions (.xxx).