PHP源码发布是将本地开发完成的PHP项目部署到线上服务器，使其可以通过公网访问的过程，整个流程需要兼顾环境适配、数据安全、服务稳定等多个维度，下面逐步介绍具体操作步骤。
一、发布前的环境准备
首先需要确认线上服务器的运行环境，确保和本地开发环境的核心配置一致，避免出现兼容性问题。需要准备的内容包括：
- 一台配置合适的云服务器，系统推荐CentOS 7及以上或者Ubuntu 18.04及以上版本
- 安装对应版本的PHP运行环境，版本需要和本地开发使用的PHP版本一致，比如本地用PHP 7.4，服务器也需要安装PHP 7.4
- 安装Web服务器，常用的是Nginx或者Apache，根据项目需求选择即可
- 安装对应版本的数据库，比如MySQL 5.7或者MariaDB，版本需要和本地开发使用的数据库版本匹配
- 如果需要用到Redis、Memcached等缓存组件，也需要提前在服务器安装配置
二、本地源码预处理
在上传源码到服务器之前，需要对本地源码做一些预处理，避免把不必要的文件或者敏感信息带到线上环境。
1. 清理冗余文件
删除本地开发过程中生成的临时文件、测试文件、版本控制目录（比如.git目录）、开发日志等，减少源码包的体积，也避免敏感信息泄露。
2. 调整配置文件
将源码中的数据库配置、缓存配置、第三方接口配置等修改为线上环境的对应参数，注意不要直接把本地配置上传到服务器。比如数据库配置部分，本地可能是连接127.0.0.1的数据库，线上需要修改为服务器数据库的实际地址、账号和密码。
3. 打包源码
将处理好的源码打包成压缩文件，方便后续上传到服务器，Linux系统下可以直接用tar命令打包，Windows系统可以用压缩软件打包成zip格式。
如果是Linux本地环境，打包命令示例如下：
# 进入项目根目录 cd /path/to/your/php_project # 打包所有文件为tar.gz格式 tar -zcvf php_project.tar.gz ./
三、源码上传与解压
将打包好的源码上传到服务器的Web服务器根目录下，不同Web服务器的默认根目录不同：
- Nginx默认根目录通常是
/usr/share/nginx/html或者/var/www/html - Apache默认根目录通常是
/var/www/html
上传方式可以选择scp命令、FTP工具或者云服务器厂商提供的文件上传功能，这里以scp命令为例：
# 本地终端执行，将本地打包文件上传到服务器 scp /local/path/php_project.tar.gz root@服务器公网IP:/var/www/html/
上传完成后，登录服务器，解压源码到对应目录：
# 登录服务器后执行 cd /var/www/html/ # 解压tar.gz格式压缩包 tar -zxvf php_project.tar.gz # 如果是zip格式，执行 unzip php_project.zip # 解压后删除压缩包 rm -f php_project.tar.gz
四、服务器环境配置
1. 配置Web服务器
需要根据项目需求配置Web服务器的站点信息，以Nginx为例，配置示例如下：
server {
listen 80;
# 站点域名，没有域名可以填服务器公网IP
server_name example.ipipp.com;
# 站点根目录，指向解压后的源码目录
root /var/www/html/;
# 默认首页文件
index index.php index.html index.htm;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# PHP文件处理配置
location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
配置完成后重启Nginx服务使配置生效：
systemctl restart nginx
2. 配置PHP运行参数
根据项目需求调整PHP的配置文件php.ini，比如修改上传文件大小限制、脚本执行时间限制等，修改后重启PHP服务：
# 重启PHP服务，根据安装的PHP版本调整服务名，比如php-fpm7.4 systemctl restart php-fpm
3. 设置文件权限
需要给源码目录设置合适的权限，避免PHP进程没有读写权限导致功能异常，通常将站点目录的属主设置为Web服务器运行的用户，比如Nginx的运行用户是nginx，执行以下命令：
chown -R nginx:nginx /var/www/html/ # 给需要写权限的目录（比如上传目录、缓存目录）单独设置写权限 chmod -R 755 /var/www/html/
五、数据库迁移
将本地开发环境的数据库结构和数据迁移到线上服务器数据库，步骤如下：
1. 导出本地数据库
在本地终端执行以下命令导出数据库：
mysqldump -u本地数据库账号 -p本地数据库密码 数据库名 > database_backup.sql
2. 导入到线上数据库
先将导出的database_backup.sql文件上传到服务器，然后登录线上数据库执行导入：
# 登录线上MySQL mysql -u线上数据库账号 -p # 创建对应的数据库 CREATE DATABASE IF NOT EXISTS 数据库名 DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; # 退出MySQL，执行导入 exit mysql -u线上数据库账号 -p线上数据库密码 数据库名 < /path/to/database_backup.sql
六、测试验证
完成以上步骤后，就可以通过浏览器访问站点域名或者服务器公网IP，测试站点是否正常运行：
- 检查首页是否正常加载，没有报错信息
- 测试核心功能，比如用户登录、数据提交、文件上传等是否正常工作
- 查看服务器错误日志，比如Nginx的错误日志在
/var/log/nginx/error.log，PHP错误日志在/var/log/php-fpm/error.log，排查可能存在的问题
七、常见问题与解决方法
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 访问站点显示502错误 | PHP服务未启动或者Nginx配置的PHP监听地址错误 | 检查PHP服务状态，确认Nginx配置中fastcgi_pass的地址和PHP监听地址一致 |
| 页面显示PHP代码而不是执行结果 | Web服务器未正确配置PHP解析规则 | 检查Nginx或者Apache的PHP解析配置，确保.php$的请求被正确转发到PHP处理器 |
| 数据库连接失败 | 数据库配置错误或者数据库账号没有远程访问权限 | 检查源码中的数据库配置参数，确认线上数据库账号有权限访问对应数据库 |
| 上传文件失败 | 上传目录没有写权限或者PHP上传大小限制过小 | 给上传目录设置写权限，修改php.ini中的upload_max_filesize和post_max_size参数 |
以上就是PHP源码发布的完整流程，按照步骤操作基本可以顺利完成站点上线，发布完成后建议定期备份源码和数据库，避免数据丢失。