部署PHP项目需先配置服务器环境，安装Web服务器、PHP和数据库；再通过FTP或SCP上传代码至服务器并设置文件权限；接着配置Apache或Nginx虚拟主机指向项目目录；若有数据库则创建用户、导入数据并更新项目配置；最后重启服务并通过浏览器访问测试，检查日志排查错误确保正常运行。
将PHP源码部署到服务器上，本质上是把本地开发完成的PHP项目上传到远程服务器，并配置好运行环境，使其可以通过域名或IP地址访问。整个过程包括准备服务器、上传代码、配置Web服务和数据库等步骤。下面是一个清晰实用的部署流程。
1. 准备服务器环境
在上传PHP源码前，必须确保服务器已安装并配置好必要的运行环境。
基本组件包括：- Web服务器：常用的是Apache或Nginx
- PHP运行环境：建议使用PHP 7.4及以上版本
- 数据库：如MySQL或MariaDB（如果项目用到）
- phpMyAdmin（可选）：便于管理数据库
以Ubuntu系统为例，可通过以下命令快速安装：
sudo apt update sudo apt install apache2 mysql-server php libapache2-mod-php php-mysql
安装完成后，测试PHP是否正常运行，可在/var/www/html下创建info.php：
立即学习“PHP免费学习笔记（深入）”；
通过浏览器访问http://你的服务器IP/info.php，若显示PHP信息页，则环境配置成功。
2. 上传PHP源码到服务器
有多种方式可将本地PHP项目上传至服务器，最常见的是使用FTP或SCP工具。
方法一：使用FTP客户端（如FileZilla）- 打开FileZilla，输入服务器IP、用户名（通常是root或www-data）、密码和端口（默认22）
- 连接后，将本地项目文件拖拽上传到服务器目录，如
/var/www/html/your-site
scp -r /本地/项目路径 root@服务器IP:/var/www/html/your-site
上传完成后，确保文件权限正确：
sudo chown -R www-data:www-data /var/www/html/your-site sudo chmod -R 755 /var/www/html/your-site
3. 配置Web服务器
为了让服务器正确解析和访问你的PHP项目，需要配置虚拟主机（Virtual Host）。
- 创建配置文件：
/etc/apache2/sites-available/your-site.conf - 写入如下内容（根据实际情况修改）：
ServerName yourdomain.com DocumentRoot /var/www/html/your-site zuojiankuohaophpcnDirectory /var/www/html/your-siteyoujiankuohaophpcn AllowOverride All Require all granted zuojiankuohaophpcn/Directoryyoujiankuohaophpcn ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined
- 启用站点：
sudo a2ensite your-site.conf sudo systemctl reload apache2如果你使用Nginx，需修改
nginx.conf或在sites-available中添加server块。4. 导入数据库（如有）
如果项目包含数据库（如WordPress、自定义CMS等），需在服务器上创建数据库并导入数据。
- 登录MySQL：
sudo mysql -u root -p
- 创建数据库：
CREATE DATABASE your_db_name; CREATE USER 'your_user'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON your_db_name.* TO 'your_user'@'localhost'; FLUSH PRIVILEGES; EXIT;
- 导入SQL文件：
mysql -u your_user -p your_db_name < /path/to/your-dump.sql然后修改项目中的配置文件（如
config.php或.env），填写正确的数据库名、用户名和密码。5. 测试访问与调试
全部配置完成后，在浏览器中输入服务器IP或绑定的域名，查看是否正常加载页面。
如果出现错误，可检查以下几点：
- Apache/Nginx是否运行：
sudo systemctl status apache2- PHP是否报错：查看日志
/var/log/apache2/error.log- 文件权限是否正确，尤其是上传目录和配置文件
- 数据库连接信息是否准确
开启PHP错误显示有助于调试（仅限开发环境）：
ini_set('display_errors', 1); ini_set('display_startup_errors', 1); error_reporting(E_ALL);基本上就这些。只要环境装好、代码传对、权限设准、数据库连通，大多数PHP项目都能顺利运行。部署不复杂但容易忽略细节，比如路径大小写、.htaccess支持、URL重写等，注意对照项目文档调整即可。
