PHP框架快速部署指南：从环境搭建到上线【新手必看】-php教程-PHP中文网

先装好php与web服务器环境，再上传项目、安装依赖、配置nginx并初始化框架参数。windows用xampp一键启动apache和mysql；ubuntu执行apt命令安装php 8.3、nginx、mysql及扩展；项目上传后用composer install --no-dev安装依赖；nginx配置指向public目录并启用url重写；最后修改.env关闭调试、设置数据库、生成密钥并缓存配置。

php框架快速部署指南：从环境搭建到上线【新手必看】

想把本地写好的PHP框架项目扔到服务器上跑起来，却卡在环境配不齐、依赖装不上、URL打不开这三道坎？别硬扛，照着这个实操路径走，跳过所有文档里没说清的坑。

本地开发环境一键拉起（XAMPP方案）

这一步操作起来很简单，直接把文件拖进去就行。下载适配PHP 8.3的XAMPP安装包，安装路径必须避开中文和空格，比如【D:\dev\xampp】，否则后续Apache服务会静默失败。

启动XAMPP控制面板，勾选Apache和MySQL，点Start按钮。看到两个绿色Running状态，就说明服务起来了。

浏览器打开 http://localhost ，出现黄色猫咪图标页面，代表本地环境已就绪。不用急着写代码，先验证PHP是否真能跑：在 xampp/htdocs 目录下新建 test.php，内容只有一行，访问 http://localhost/test.php 能看到完整配置页才算过关。

生产服务器基础环境准备

登录云服务器（Ubuntu 22.04推荐），执行以下命令一次性装齐核心组件：

sudo apt update && sudo apt install nginx php8.3-fpm php8.3-mysql php8.3-curl php8.3-mbstring php8.3-xml php8.3-zip php8.3-opcache mysql-server -y

启动并设为开机自启：sudo systemctl enable nginx php8.3-fpm mysql && sudo systemctl start nginx php8.3-fpm mysql

【关键检查】运行 php -v 确认输出是 8.3.x；运行 mysql --version 确保 MySQL 已就绪；执行 sudo ss -tlnp | grep ':80\|:3306' 验证端口监听正常。漏掉任一检查项，后面所有步骤都会卡死。

项目上传与依赖安装

方法一：Git克隆（推荐）
在 /var/www/ 下新建项目目录，如 myapp，执行：
git clone https://your-repo-url.git .

方法二：SCP上传（适合无Git权限场景）
本地终端执行：
scp -r ./my-project/ user@server-ip:/var/www/myapp/

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

进入项目根目录后，执行：
composer install --no-dev --optimize-autoloader
这步必须加 --no-dev 参数，否则会把 phpunit、debugbar 这类开发工具装进生产环境，既浪费空间又带来安全风险。

设置目录权限：
sudo chown -R www-data:www-data /var/www/myapp
sudo find /var/www/myapp -type d -exec chmod 755 {} \;
sudo find /var/www/myapp -type f -exec chmod 644 {} \;

Web服务器精准配置（Nginx）

第一步：创建站点配置文件
sudo nano /etc/nginx/sites-available/myapp

第二步：粘贴以下配置（注意替换路径和域名）：
server {
  listen 80;
  server_name example.com;
  root /var/www/myapp/public;
  index index.php;
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
  }
  location ~ /\.(env|git|log|lock)$ {
    deny all;
  }
}