悠悠楠杉
网站页面
PHP项目在Apache服务器运行的配置方法
11/30
![]()
对于刚接触Web开发的新手来说，如何将一个写好的PHP项目成功运行在本地或远程服务器上，常常是一个让人头疼的问题。虽然现在有许多集成环境（如XAMPP、WAMP、Laragon）可以一键启动服务，但了解其背后的原理和手动配置过程，不仅能帮助我们更好地排查问题，还能提升对服务器工作机制的理解。本文将详细介绍如何在Apache服务器上正确配置并运行一个PHP项目，适合希望深入掌握Web部署流程的开发者。
首先，确保你的系统中已经安装了Apache服务器和PHP解释器。如果你使用的是Linux系统（如Ubuntu），可以通过命令行安装：
bash
sudo apt update
sudo apt install apache2 php libapache2-mod-php
在Windows系统上，则建议从Apache官网下载Apache HTTP Server，并从PHP官网下载对应的PHP版本，解压后进行配置。不过更推荐使用WAMP或XAMPP这类集成包，它们已经预配置好了Apache与PHP的关联，省去大量手动操作。
安装完成后，Apache默认的网站根目录通常是 /var/www/html（Linux）或 C:\wamp\www（Windows）。你可以将你的PHP项目文件夹复制到这个目录下，例如命名为 myproject，然后通过浏览器访问 http://localhost/myproject 即可查看效果。
但这只是最基础的方式。在实际开发中，我们往往希望使用自定义域名（如 myproject.test）来访问项目，这就需要用到Apache的虚拟主机（Virtual Host）功能。
打开Apache的主配置文件 httpd.conf 或 apache2.conf，找到并确保以下模块已启用：
apache
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
Include conf/extra/httpd-vhosts.conf
接着进入 conf/extra/httpd-vhosts.conf 文件（路径可能因安装方式不同而异），添加如下虚拟主机配置：
apache
<VirtualHost *:80>
ServerName myproject.test
DocumentRoot "C:/wamp/www/myproject"
<Directory "C:/wamp/www/myproject">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
注意：Windows路径中的反斜杠应使用正斜杠或双反斜杠，避免解析错误。AllowOverride All 允许.htaccess文件生效，这对使用URL重写的框架（如Laravel）至关重要。
配置完虚拟主机后，还需要修改本地的hosts文件，将自定义域名指向本机。在Windows系统中，路径为 C:\Windows\System32\drivers\etc\hosts；在Linux/macOS中为 /etc/hosts。添加一行：
127.0.0.1 myproject.test
保存后重启Apache服务。此时在浏览器中输入 http://myproject.test，即可访问你的PHP项目。
此外，还需检查PHP是否正常工作。可以在项目根目录创建一个 info.php 文件，内容为：
php
<?php phpinfo(); ?>
通过访问该文件，可以查看PHP的详细配置信息，确认Apache是否成功加载了PHP模块。
如果遇到页面无法访问或显示500错误，应优先查看Apache的错误日志（通常位于 logs/error.log），根据提示排查语法错误、权限问题或模块缺失等情况。
值得一提的是，若项目使用了数据库（如MySQL），还需确保PHP的PDO或mysqli扩展已启用。可在 php.ini 文件中取消相关扩展前的分号注释：
ini
extension=pdo_mysql
extension=mysqli
修改后同样需要重启Apache。
综上所述，运行PHP项目并非简单地“扔进文件夹就能用”，而是涉及Apache配置、PHP模块加载、文件权限、网络映射等多个环节。掌握这些底层配置，不仅能让你更灵活地管理多个项目，也为后续部署到生产环境打下坚实基础。
