PHP源码部署到Apache服务器需要经过环境准备、软件安装、配置关联、验证测试几个核心步骤,下面我们一步步展开说明。

一、部署前环境准备
首先确认系统环境,本文以CentOS 7为例,其他Linux发行版步骤类似,Windows系统可参考对应版本的软件安装方式。需要提前安装编译所需的依赖工具,避免后续编译过程报错。
执行以下命令安装基础依赖:
# 安装编译工具和依赖库 yum install -y gcc gcc-c++ make autoconf libxml2-devel openssl-devel curl-devel libjpeg-devel libpng-devel freetype-devel
二、安装Apache服务器
可以选择yum直接安装,也可以下载源码编译安装,这里以yum安装为例,操作更简单快捷。
# 安装Apache服务 yum install -y httpd # 启动Apache服务并设置开机自启 systemctl start httpd systemctl enable httpd
安装完成后可以通过浏览器访问服务器IP,看到Apache默认欢迎页说明Apache安装成功。
三、编译安装PHP源码
首先下载对应版本的PHP源码包,这里以PHP 7.4为例,你可以根据需要选择其他稳定版本。
# 下载PHP源码包 wget https://www.php.net/distributions/php-7.4.33.tar.gz # 解压源码包 tar -zxvf php-7.4.33.tar.gz cd php-7.4.33
接下来配置编译参数,需要指定Apache的apxs路径,让PHP能够生成Apache可用的模块。
# 配置编译参数,--with-apxs2指定Apache的apxs路径 ./configure --prefix=/usr/local/php --with-apxs2=/usr/sbin/apxs --enable-mysqlnd --with-mysqli --with-pdo-mysql --with-openssl --with-curl --with-gd --with-jpeg --with-png --with-freetype # 编译并安装 make && make install
安装完成后复制PHP配置文件到指定目录:
cp php.ini-development /usr/local/php/lib/php.ini
四、配置Apache关联PHP
PHP安装完成后,Apache的配置文件会自动添加PHP模块加载项,我们可以检查一下配置文件确认。
打开Apache的主配置文件httpd.conf,一般路径是/etc/httpd/conf/httpd.conf,确认是否有以下内容:
# 确认存在PHP模块加载配置 LoadModule php7_module /usr/lib64/httpd/modules/libphp7.so # 添加PHP文件解析规则 AddHandler php7-script .php AddType text/html .php # 设置目录索引包含index.php DirectoryIndex index.php index.html
如果缺少上述内容可以手动添加,修改完成后重启Apache服务让配置生效。
systemctl restart httpd
五、验证部署是否成功
我们可以通过两种方式来验证PHP是否已经正确部署到Apache服务器。
方法1:创建PHP测试文件
在Apache的默认网站根目录/var/www/html下创建test.php文件,内容如下:
<?php // 输出PHP配置信息 phpinfo(); ?>
保存文件后,通过浏览器访问http://服务器IP/test.php,如果能看到PHP的详细配置信息页面,说明PHP已经成功部署。
方法2:测试PHP代码执行
再创建一个简单的测试文件hello.php,内容如下:
<?php
// 输出欢迎信息
echo "Hello PHP on Apache";
// 测试时间函数
echo "<br>当前时间:" . date("Y-m-d H:i:s");
?>访问http://服务器IP/hello.php,如果页面正确输出对应内容,说明PHP代码可以正常在Apache环境下执行。
常见问题排查
如果访问测试文件出现下载或者空白页,可以检查以下几点:
- 确认Apache配置文件中PHP模块加载项是否正确,路径是否存在
- 确认PHP模块文件
libphp7.so是否生成并放在正确目录 - 检查Apache错误日志
/var/log/httpd/error_log,查看具体报错信息 - 确认测试文件的权限是否正确,Apache用户是否有读取权限