烂泥：php5.6源码安装与apache集成

唐伯虎

本文首发于烂泥行天下。

　　apache对php的支持是通过apache的mod_php5模块来支持的，这点与nginx不同。nginx是通过第三方的fastcgi处理器才可以对php进行解析，有关nginx与php集成，请看《烂泥：php5.6源码安装及php-fpm配置与nginx集成》。
　　如果源码编译安装php的话，需要在编译时指定--with-apxs2=/usr/local/apache2/bin/apxs表示告诉编译器通过apache的mod_php5模块来提供对php的解析。
　　同时php安装的最后一步make install时，我们会看到将动态链接库libphp5.so拷贝到apache2的安装目录的modules目录下，并且还需要在httpd.conf配置文件中添加LoadModule语句来动态将libphp5.so模块加载进来，从而实现Apache对php的支持。
　　php与apache集成需要以下几个步骤：
　　1、安装libiconv库
　　2、php源码安装
　　3、配置apache使其支持php
　　4、测试php
　　一、安装libiconv库
　　libiconv库为需要做转换的应用程序提供了一个iconv命令，以实现一个字符编码到另一个字符编码的转换，比如它可以将UTF8编码转换成GB18030编码，反过来也行。
　　php与apache集成时一定要安装libiconv库，否则在make时系统会报错。报错信息如下：
　　make: *** [sapi/cli/php] Error 1
　　/usr/bin/ld: cannot find -liconv
　　collect2: ld returned 1 exit status
　　make: *** [sapi/cli/php] Error 1
　　
　　现在开始正式安装libiconv库，首先下载libiconv库，如下：
　　wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz
　　
　　解压libiconv库，如下：
　　tar -xf libiconv-1.14.tar.gz
　　
　　安装libiconv库，首先查看安装帮助信息。如下：
　　./configure --help
　　
　　通过上图的帮助，我们可以看到libiconv库默认的安装路径为/usr/local。现在开始安装libiconv库，如下：
　　./configure --prefix=/usr/local
　　make && make install
　　
　　
　　libiconv库安装完毕后，建议把/usr/local/lib库加入到到/etc/ld.so.conf文件中，然后使用/sbin/ldconfig使其生效。如下：
　　echo "/usr/local/lib">>/etc/ld.so.conf
　　/sbin/ldconfig
　　
　　如果没有进行此步操作的话，在安装php执行make install，系统就会报错。报错信息如下：
　　/root/php-5.6.2/sapi/cli/php: error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory
　　二、php源码安装
　　有关php源码安装可以参照《烂泥：php5.6源码安装及php-fpm配置与nginx集成》文章， 下载并编译php命令如下：
　　yum -y install gcc gcc-c++ libxml2 libxml2-devel
　　wget http://mirrors.sohu.com/php/php-5.6.2.tar.gz
　　./configure --enable-fpm --enable-mbstring --with-mysql=/usr/local/mysql --with-iconv-dir=/usr/local --with-apxs2=/usr/local/apache2/bin/apxs
　　
　　
　　注意上述命令中--enable-fpm的作用是开启php的fastcgi功能，即开启php-fpm功能。
　　--with-mysql=/usr/local/mysql是启用php支持mysql的功能，/usr/local/mysql是mysql数据库的安装路径。
　　--enable-mbstring表示启用mbstring模块mbstring模块的主要作用在于检测和转换编码，提供对应的多字节操作的字符串函数。目前php内部的编码只支持ISO-8859-*、EUC-JP、UTF-8，其他的编码的语言是没办法在php程序上正确显示的，所以我们要启用mbstring模块。
　　--with-iconv-dir=/usr/local指定php存放libiconv库的位置。
　　--with-apxs2=/usr/local/apache2/bin/apxs指定php查找apache的位置。
　　编译完毕后，我们再来make。在make时，我们注意要加上-liconv参数。如果不加上-liconv参数，系统在make编译会报错。报错信息如下：
　　Generating phar.php
　　php-5.3.16/sapi/cli/php: error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory
　　使用命令如下：
　　make ZEND_EXTRA_LIBS='-liconv'
　　我们也可以通过修改Makefile文件，在ZEND_EXTRA_LIBS行加入-liconv。如下：
　　
　　vi Makefile
　　
　　make install
　　
　　通过上图，我们可以很明显的看到apache配置文件httpd中启用php支持，同时也把libphp5.so文件复制到apache的模块目录下。
　　三、配置apache使其支持php
　　php安装完毕后，我们就可以通过修改apache的配置文件httpd.conf来使其支持php。
　　我们只需要在httpd.conf文件中加入如下两行代码：
　　LoadModule php5_module modules/libphp5.so
　　AddType application/x-httpd-php .php
　　注意，其中LoadModule php5_module modules/libphp5.so行，我们查看httpd.conf文件时会发现该行已经存在。那是因为在安装php时，添加的。现在我们只需要添加AddType application/x-httpd-php .php行即可。
　　vi /usr/local/apache2/conf/httpd.conf
　　
　　除此之外，我们还需要修改apache的默认主页文件，添加index.php。内容如下：
　　echo "‹?php phpinfo();?>">/usr/local/apache2/htdocs/index.php
　　cat /usr/local/apache2/htdocs/index.php
　　
　　
　　四、测试php
　　以上修改完毕后，我们重新启动apache，使用如下命令：
　　/etc/init.d/httpd graceful
　　注意该命令可以优雅的重启apache。
　　
　　打开站点，如下：
　　
　　通过上图，我们可以很明显的看到apache已经支持php。