debian怎么迁移laravel

在 Debian（以及大多数 Linux）上迁移 Laravel 项目，通常分为 服务器迁移（从一台机器搬到另一台） 和 环境重建 两部分。下面给你一套 标准、稳妥的迁移流程（适用于 Debian 10/11/12）。

一、迁移前准备

1️⃣ 在旧服务器上确认信息

php -v
composer -V
nginx -v   # 或 apache
mysql -V   # 或 mariadb

记下：

PHP 版本
Web 服务器（Nginx / Apache）
数据库类型

二、在新 Debian 服务器上安装环境

1️⃣ 安装基础工具

sudo apt update
sudo apt install -y curl wget git unzip

2️⃣ 安装 PHP（以 PHP 8.2 为例）

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install -y php8.2 php8.2-fpm php8.2-cli \
php8.2-mysql php8.2-curl php8.2-mbstring \
php8.2-xml php8.2-zip php8.2-gd php8.2-redis

Laravel 10 推荐 PHP ≥ 8.1
Laravel 11 推荐 PHP ≥ 8.2

3️⃣ 安装 Composer

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

验证：

composer -V

4️⃣ 安装数据库（MySQL / MariaDB）

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库：

CREATE DATABASE laravel_db;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

三、迁移 Laravel 项目

✅ 方式一（推荐）：源码迁移（git）

1️⃣ 上传 / 拉取代码

cd /var/www
git clone your_repo.git laravel
cd laravel

2️⃣ 安装依赖

composer install --no-dev --optimize-autoloader

✅ 方式二：直接拷贝项目目录

scp -r /old/path/laravel user@new:/var/www/laravel

⚠️ 注意：

不要拷贝 vendor
不要拷贝 node_modules

四、配置 Laravel

1️⃣ 复制环境文件

cp .env.example .env

2️⃣ 修改数据库配置

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

3️⃣ 生成 APP_KEY

php artisan key:generate

五、权限设置（非常重要）

sudo chown -R www-data:www-data /var/www/laravel
sudo chmod -R 755 /var/www/laravel
sudo chmod -R 777 /var/www/laravel/storage
sudo chmod -R 777 /var/www/laravel/bootstrap/cache

六、数据库迁移

1️⃣ 导入旧数据库

旧服务器：

mysqldump -u root -p laravel_db > laravel.sql

新服务器：

mysql -u laravel -p laravel_db < laravel.sql

2️⃣ 或重新迁移（新项目）

php artisan migrate

七、配置 Web 服务器

✅ Nginx 示例

server {
    listen 80;
    server_name your_domain.com;

    root /var/www/laravel/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

重启：

sudo systemctl restart nginx

八、最后检查

php artisan config:clear
php artisan cache:clear
php artisan route:clear

访问域名，确认 Laravel 正常启动。

九、常见问题

1️⃣ 500 错误

tail -f storage/logs/laravel.log

2️⃣ storage 权限问题

sudo chown -R www-data:www-data storage

十、迁移清单（总结）

✅ PHP + Composer
✅ 项目代码
✅ .env
✅ 数据库
✅ storage 权限
✅ Web 服务器配置

如果你愿意，可以告诉我：

Laravel 版本
Debian 版本
是否从服务器 A 迁移到服务器 B
是否用 Docker

我可以给你 定制迁移方案（包括零停机迁移）。