Dear Wiki user, You have subscribed to a wiki page or wiki category on "Httpd Wiki" for change notification.
The "PHPOnUnix" page has been changed by RichBowen. http://wiki.apache.org/httpd/PHPOnUnix?action=diff&rev1=3&rev2=4 -------------------------------------------------- &install.snippet.apache2.compat; The most recent version of Apache HTTP Server may be obtained from + <link xlink:href="&url.apache;">Apache download site</link>, and a fitting PHP version from the above mentioned places. - <link xlink:href="&url.apache;">Apache download site</link>, - and a fitting PHP version from the above mentioned places. - This quick guide covers only the basics to get started with Apache 2.x + This quick guide covers only the basics to get started with Apache 2.x - and PHP. For more information read the + and PHP. For more information read the - <link xlink:href="&url.apache2.docs;">Apache Documentation</link>. + <link xlink:href="&url.apache2.docs;">Apache Documentation</link>. - The version numbers have been omitted here, to ensure the - instructions are not incorrect. In the examples below, 'NN' should be - replaced with the specific version of Apache being used. + In the examples below, 'NN' should be replaced with the specific version of Apache being used. + - There are currently two versions of Apache 2.x - there's 2.0 and 2.2. + There are currently two versions of Apache 2.x - there's 2.0 and 2.2. - While there are various reasons for choosing each, 2.2 is the current + While there are various reasons for choosing each, 2.2 is the current - latest version, and the one that is recommended, if that option is + latest version, and the one that is recommended, if that option is - available to you. However, the instructions here will work for either + available to you. However, the instructions here will work for either - 2.0 or 2.2. + 2.0 or 2.2. Obtain the Apache HTTP server from the location listed above, and unpack it: - + {{{ gzip -d httpd-2_x_NN.tar.gz tar xvf httpd-2_x_NN.tar + }}} + Obtain and unpack the PHP source. + {{{ - 3. gunzip php-NN.tar.gz + gunzip php-NN.tar.gz - 4. tar -xvf php-NN.tar + tar -xvf php-NN.tar + }}} - 5. cd httpd-2_x_NN - 6. ./configure --enable-so - 7. make - 8. make install + Build Apache, as per the installation instructions. - Now you have Apache 2.x.NN available under /usr/local/apache2, - configured with loadable module support and the standard MPM prefork. - To test the installation use your normal procedure for starting - the Apache server, e.g.: - /usr/local/apache2/bin/apachectl start - and stop the server to go on with the configuration for PHP: - /usr/local/apache2/bin/apachectl stop. - 9. cd ../php-NN + {{{ + cd httpd-2_x_NN + ./configure --enable-so + make + make install + }}} + Now you have Apache 2.x.NN available under /usr/local/apache2, + configured with loadable module support and the standard prefork MPM. + To test the installation use your normal procedure for starting + the Apache server: - 10. Now, configure your PHP. This is where you customize your PHP - with various options, like which extensions will be enabled. Do a - ./configure --help for a list of available options. In our example - we'll do a simple configure with Apache 2 and MySQL support. Your - path to apxs may differ, in fact, the binary may even be named apxs2 on - your system. + {{{ + /usr/local/apache2/bin/apachectl start + }}} + + and stop the server to go on with the configuration for PHP: + + {{{ + /usr/local/apache2/bin/apachectl stop. + }}} + + Now, configure PHP. This is where you customize PHP + with various options, like which extensions will be enabled. Run + ./configure --help for a list of available options. In our example + we'll do a simple configure with Apache 2 and MySQL support. + + If you have installed Apache as describe above, the path to apxs will be as shown below, however, if Apache was installed via an operating system package, the path to apxs may be different, and apxs may have an alternate name, such as apxs2. + + {{{ + cd ../php-NN + ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql + make + make install + }}} + + If you decide to change your configure options after installation, + you only need to repeat the last three steps. You only need to + restart apache for the new module to take effect. A recompile of + Apache is not needed. + + Note that unless told otherwise, 'make install' will also install PEAR, + various PHP tools such as phpize, install the PHP CLI, and more. - ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql + Next, you may customize your php.ini + + {{{ + cp php.ini-development /usr/local/lib/php.ini + }}} + + You may edit your .ini file to set PHP options. If you prefer having + php.ini in another location, add the --with-config-file-path=/some/path when you run configure. + + If you instead choose php.ini-production, be certain to read the list + of changes within, as they affect how PHP behaves. - 11. make - 12. make install + Edit your httpd.conf to load the PHP module. The path on the right hand + side of the LoadModule statement must point to the path of the PHP + module on your system. The make install from above may have already + added this for you, but be sure to check. + {{{ + LoadModule php5_module modules/libphp5.so + }}} - If you decide to change your configure options after installation, - you only need to repeat the last three steps. You only need to - restart apache for the new module to take effect. A recompile of - Apache is not needed. - - Note that unless told otherwise, 'make install' will also install PEAR, - various PHP tools such as phpize, install the PHP CLI, and more. - - 13. Setup your php.ini - - cp php.ini-development /usr/local/lib/php.ini - - You may edit your .ini file to set PHP options. If you prefer having - php.ini in another location, use --with-config-file-path=/some/path in - step 10. - - If you instead choose php.ini-production, be certain to read the list - of changes within, as they affect how PHP behaves. - 14. Edit your httpd.conf to load the PHP module. The path on the right hand - side of the LoadModule statement must point to the path of the PHP - module on your system. The make install from above may have already - added this for you, but be sure to check. + Tell Apache to parse certain extensions as PHP. For example, let's have + Apache parse .php files as PHP. Instead of only using the Apache AddType + directive, we want to avoid potentially dangerous uploads and created + files such as exploit.php.jpg from being executed as PHP. Using this + example, you could have any extension(s) parse as PHP by simply adding + them. We'll add .phtml to demonstrate. - LoadModule php5_module modules/libphp5.so - - 15. Tell Apache to parse certain extensions as PHP. For example, let's have - Apache parse .php files as PHP. Instead of only using the Apache AddType - directive, we want to avoid potentially dangerous uploads and created - files such as exploit.php.jpg from being executed as PHP. Using this - example, you could have any extension(s) parse as PHP by simply adding - them. We'll add .phtml to demonstrate. - + {{{ - <FilesMatch \.php$> + <FilesMatch \.php$> - SetHandler application/x-httpd-php + SetHandler application/x-httpd-php - </FilesMatch> + </FilesMatch> - + }}} Or, if we wanted to allow .php, .php2, .php3, .php4, .php5, .php6, and .phtml files to be executed as PHP, but nothing else, we'd use this: @@ -149, +166 @@ step 6 above: {{{ - --with-mpm=worker + --with-mpm=worker }}}
