PHP项目部署方法：网站上线环境配置指南

本文系统介绍了PHP项目上线部署的五种主流方法——从传统手动配置Apache+PHP+MySQL，到高性能Nginx+PHP-FPM组合、标准化Docker容器化封装、零命令行门槛的宝塔面板图形化操作，再到面向协作开发的Git钩子自动部署，全面覆盖不同技术背景与运维需求的开发者场景；无论你是Linux高手、性能追求者、DevOps实践者、新手站长，还是敏捷团队成员，都能从中找到高效、稳定、可复用的上线解决方案，并快速将本地开发成果安全、可靠地交付至生产环境。

如果您已完成PHP项目的本地开发，准备将其部署到生产服务器并对外提供服务，则需要完成一系列环境配置和文件迁移操作。以下是实现此目标的多种方法：

一、使用Apache + PHP + MySQL手动配置环境

该方法适用于具备Linux服务器管理权限的用户，通过安装和配置LAMP（Linux, Apache, MySQL, PHP）基础组件，构建稳定可控的运行环境。

1、登录服务器，执行命令安装Apache：sudo apt update && sudo apt install apache2

2、安装PHP及常用扩展：sudo apt install php libapache2-mod-php php-mysql

3、启动并启用Apache服务：sudo systemctl start apache2 && sudo systemctl enable apache2

4、将PHP项目文件复制至/var/www/html/目录下，或创建子目录如/var/www/myproject/

5、修改Apache虚拟主机配置，指定DocumentRoot指向项目入口目录，并确保启用mod_rewrite模块

6、重启Apache服务使配置生效：sudo systemctl restart apache2

7、访问服务器IP或绑定域名，确认首页可正常加载且PHP文件能被解析执行而非直接下载

二、使用Nginx + PHP-FPM组合部署

该方法适合高并发场景，Nginx作为反向代理与静态资源服务器，PHP-FPM负责处理动态请求，性能与资源占用优于传统Apache模式。

1、安装Nginx和PHP-FPM：sudo apt install nginx php-fpm

2、确认PHP-FPM服务已启动：sudo systemctl start php7.4-fpm（版本号依实际安装调整）

3、编辑Nginx站点配置文件，通常位于/etc/nginx/sites-available/default或新建配置文件

4、在server块中设置root为项目路径，添加location ~ \.php$块，指定fastcgi_pass为127.0.0.1:9000或unix:/run/php/php7.4-fpm.sock

5、设置index指令包含index.php，确保支持PHP入口文件优先匹配

6、测试配置语法：sudo nginx -t，无误后重载服务：sudo systemctl reload nginx

7、检查PHPinfo页面是否正确输出，且$_SERVER['SERVER_SOFTWARE']显示Nginx而非Apache

三、通过Docker容器化部署

该方法利用标准化镜像封装运行环境，避免系统依赖冲突，便于多环境一致性交付与快速回滚。

1、在项目根目录创建Dockerfile，基于官方php:8.1-apache或php:8.1-fpm-alpine镜像

2、COPY项目代码至镜像内/var/www/html/路径，并设置WORKDIR

3、RUN安装必要扩展如pdo_mysql、mbstring，并启用Apache rewrite模块（若使用apache镜像）

4、创建docker-compose.yml，定义web服务与mysql服务，配置端口映射、卷挂载和环境变量

5、执行docker-compose build构建镜像，再运行docker-compose up -d启动容器组

6、确认容器状态为up：docker ps | grep web，且浏览器访问宿主机IP:80端口时返回预期页面内容

四、使用宝塔面板图形化部署

该方法面向不熟悉命令行操作的开发者，通过Web界面完成环境搭建、站点创建、SSL证书申请等全流程操作，降低部署门槛。

1、在服务器上执行宝塔一键安装脚本：wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

2、安装完成后记录面板地址、用户名与密码，通过浏览器访问并登录

3、进入软件商店，依次安装Nginx 1.22、PHP 8.1、MySQL 5.7（版本按项目兼容性选择）

4、点击网站 → 添加站点，填写域名（或IP）、根目录路径、PHP版本，勾选创建FTP与数据库

5、上传项目压缩包至根目录，解压后进入文件管理，确认public或web子目录为实际入口

6、在网站设置 → 网站目录中，将运行目录修改为/public或/web（如有），并保存

7、验证网站状态显示“正在运行”，且首页HTTP响应码为200而非500或403

五、通过Git钩子自动部署

该方法适用于已有Git仓库的团队协作项目，借助post-receive钩子在代码推送后自动拉取更新、安装依赖并重启服务，实现轻量级CI流程。

1、在服务器创建裸仓库：mkdir /home/git/myproject.git && cd /home/git/myproject.git && git init --bare

2、编辑hooks/post-receive文件，添加shell脚本：设置工作目录、git checkout到web路径、执行composer install（如需）、chown www-data权限

3、确保web目录拥有者为Web服务器运行用户（如www-data），且具有读写权限

4、本地项目中添加远程仓库：git remote add production user@server_ip:/home/git/myproject.git

5、推送代码触发部署：git push production main

6、检查web目录下文件时间戳是否随推送更新，且vendor目录存在且可被PHP正常加载

终于介绍完啦！小伙伴们，这篇关于《PHP项目部署方法：网站上线环境配置指南》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！