Laravel本地项目迁移到服务器该怎么做-php教程-PHP中文网

直接迁移laravel项目需环境对齐、配置隔离、权限到位、路由通顺：php必须≥8.2且启用mbstring/openssl/pdo/xml/ctype/json/zip/bcmath/fileinfo；用git clone部署，执行composer install --no-dev、key:generate、migrate --force；.env按生产环境配置；nginx根目录指向public并配全try_files与script_filename；storage和bootstrap/cache需chown www-data并chmod 755。

laravel本地项目迁移到服务器该怎么做

直接把本地 Laravel 项目搬到服务器上，不能只复制文件。核心是环境对齐、配置隔离、权限到位、路由通顺——缺一不可。

确保 PHP 版本和扩展一致

本地用 PHP 8.2，服务器也得是 8.2（不是 8.1 或 8.3），且必须启用这些扩展：mbstring、openssl、pdo、xml、ctype、json、zip、bcmath、fileinfo。Laravel 12 要求 PHP ≥ 8.2，少一个扩展就可能报错退出。

Linux 上推荐用 apt 明确安装：

sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-fileinfo
装完运行 php -v 和 php -m | grep mbstring 验证

用 Git 部署代码，别手动传压缩包

在服务器目标目录（如 /var/www/myapp）执行：

git clone https://your-git-repo-url.git .（注意末尾的点）
composer install --no-dev --optimize-autoloader（跳过开发依赖，提升性能）
php artisan key:generate（生成唯一密钥）

如果没用 Git，至少用 SFTP 把整个项目上传，但务必排除 vendor/ 和 .env —— 这两个要现场生成。

正确配置 .env 和数据库

.env 绝对不提交到 Git。部署时走标准流程：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

cp .env.example .env
编辑 .env，改掉这些关键项：
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
DB_HOST=127.0.0.1（或远程地址）
DB_DATABASE=your_db_name
DB_USERNAME=your_user
DB_PASSWORD=your_pass
数据库迁移：php artisan migrate --force（生产环境需加 --force）

Nginx 必须配对 public 目录和重写规则

Web 根目录必须指向 public/，不是项目根目录。Nginx 配置里至少包含：

root /var/www/myapp/public;
location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ \.php$ { fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; }

漏掉 $query_string 会导致带参数的 URL 丢参；漏掉 $realpath_root 会让 $_SERVER['SCRIPT_FILENAME'] 错位，常见 500 错误。