php源码部署是将开发完成的php项目从本地环境迁移到服务器，使其能够通过网络被用户访问的过程，整个流程涉及环境搭建、源码传输、配置调整、域名解析等多个环节，不同服务器系统的操作细节略有差异，但核心逻辑一致。
一、部署前的环境准备
部署php源码前需要先准备好运行环境，主流的搭配是LAMP（Linux + Apache + MySQL + PHP）或者LNMP（Linux + Nginx + MySQL + PHP），新手建议优先选择LAMP架构，配置相对简单。
1. 服务器系统选择
常用的服务器系统有CentOS、Ubuntu、Debian等，本文以CentOS 7系统为例演示部署步骤，其他系统的包管理命令略有不同，可根据实际情况调整。
2. 安装基础环境组件
首先通过yum命令安装Apache、MySQL和PHP相关组件，执行以下命令：
# 安装Apache服务 yum install httpd -y # 安装MySQL服务 yum install mariadb mariadb-server -y # 安装PHP及常用扩展 yum install php php-mysql php-gd php-xml php-mbstring -y # 启动Apache和MySQL服务并设置开机自启 systemctl start httpd systemctl start mariadb systemctl enable httpd systemctl enable mariadb
安装完成后可以通过访问服务器公网IP验证Apache是否正常运行，如果看到Apache默认欢迎页说明环境基础部分安装成功。
二、源码上传与权限配置
开发完成的php源码需要先上传到服务器的网站根目录，默认情况下Apache的网站根目录是/var/www/html，也可以自定义配置其他目录。
1. 源码上传方式
常用的上传方式有scp命令、FTP工具（如FileZilla）、Git拉取三种，本地小项目可以用scp命令直接传输：
# 将本地项目文件夹上传到服务器网站根目录，假设本地项目在~/my_php_project scp -r ~/my_php_project/* root@服务器公网IP:/var/www/html/
如果是线上已有项目更新，建议先备份原有源码再上传新版本，避免更新失败导致站点无法访问。
2. 目录权限调整
php项目通常需要读写某些目录（如缓存目录、上传目录），需要给这些目录设置正确的权限，避免权限不足导致的错误：
# 假设项目缓存目录是/var/www/html/runtime chmod -R 755 /var/www/html/runtime # 设置目录所属用户为Apache运行用户 chown -R apache:apache /var/www/html/runtime
三、数据库配置与导入
大部分php项目都需要连接数据库，部署时需要创建对应的数据库和用户，并导入本地开发时的数据库结构数据。
1. 初始化MySQL
首次安装MySQL需要设置root密码，执行以下命令初始化：
# 运行MySQL安全配置脚本 mysql_secure_installation # 按照提示设置root密码，其他选项建议选择Y
2. 创建项目数据库
登录MySQL后创建项目对应的数据库和用户，并授权：
-- 登录MySQL mysql -u root -p -- 创建数据库，假设数据库名为my_php_db CREATE DATABASE my_php_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建数据库用户，假设用户名为php_user，密码为php_pass CREATE USER 'php_user'@'localhost' IDENTIFIED BY 'php_pass'; -- 授权用户访问数据库 GRANT ALL PRIVILEGES ON my_php_db.* TO 'php_user'@'localhost'; -- 刷新权限 FLUSH PRIVILEGES;
3. 导入数据库数据
将本地导出的sql文件上传到服务器，然后导入到新建的数据库中：
# 假设sql文件路径为/tmp/my_db.sql mysql -u php_user -p my_php_db < /tmp/my_db.sql
4. 修改项目数据库配置
打开项目的数据库配置文件，通常是config/database.php或者.env文件，修改数据库连接参数：
<?php
// 数据库配置示例
$db_config = [
'host' => 'localhost',
'port' => 3306,
'user' => 'php_user',
'pass' => 'php_pass',
'dbname' => 'my_php_db',
'charset' => 'utf8mb4'
];
?>
四、站点配置与域名绑定
如果有域名需要绑定到站点，需要修改Apache的虚拟主机配置，让服务器能够识别对应域名的请求并指向项目目录。
1. 创建虚拟主机配置文件
在/etc/httpd/conf.d/目录下新建站点配置文件，比如my_site.conf：
<VirtualHost *:80>
# 绑定的域名
ServerName www.ipipp.com
# 域名别名，可选
ServerAlias ipipp.com
# 项目根目录
DocumentRoot /var/www/html
# 目录权限配置
<Directory /var/www/html>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
# 错误日志路径
ErrorLog /var/log/httpd/my_site_error.log
# 访问日志路径
CustomLog /var/log/httpd/my_site_access.log combined
</VirtualHost>
2. 配置伪静态规则
很多php框架（如ThinkPHP、Laravel）需要开启伪静态，在网站根目录创建.htaccess文件：
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
# 如果请求的不是真实存在的文件或目录，转发到index.php
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
修改完成后重启Apache服务让配置生效：
systemctl restart httpd
3. 域名解析配置
登录域名服务商的控制台，添加A记录，将域名指向服务器的公网IP，等待解析生效即可通过域名访问站点。
五、部署后测试与问题排查
部署完成后需要测试站点是否正常运行，常见问题可以通过以下方式排查。
1. 基础访问测试
访问域名或者服务器IP，查看页面是否正常加载，如果出现空白页可以打开php的错误提示：
<?php
// 在入口文件顶部添加以下代码开启错误显示
ini_set('display_errors', '1');
error_reporting(E_ALL);
?>
2. 常见错误排查
- 403 Forbidden：通常是目录权限不足或者
.htaccess配置错误，检查目录权限和Apache配置 - 500 Internal Server Error：查看Apache错误日志
/var/log/httpd/error_log，定位具体错误原因 - 数据库连接失败：检查数据库配置参数是否正确，数据库用户是否有权限访问对应数据库
3. 生产环境优化
测试通过后建议关闭php错误显示，开启opcache提升php运行效率，同时配置SSL证书让站点支持https访问，提升站点安全性。
整个php源码部署流程并不复杂，按照步骤逐步操作，遇到错误优先查看对应服务的日志文件，大部分问题都能快速定位解决，部署完成后定期备份源码和数据库，避免数据丢失。