PHP项目部署有五种方法:一、Apache+PHP+MySQL手动配置;二、Nginx+PHP-FPM高性能组合;三、Docker容器化封装;四、宝塔面板图形化操作;五、Git钩子自动部署。

如果您已完成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
立即学习“PHP免费学习笔记(深入)”;
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正常加载











