温馨提示×

linux laravel如何迁移

小樊
39
2026-10-27 19:53:37
栏目: 智能运维

在 Linux 服务器上迁移 Laravel 项目,通常分为:代码迁移、环境配置、数据库迁移、文件/存储迁移、服务配置 几个步骤。下面给你一套通用、实战可用的迁移流程。


一、原服务器(旧环境)准备工作

1. 打包项目代码

cd /path/to/laravel
tar -czf laravel_project.tar.gz .

建议排除:

tar --exclude=node_modules --exclude=vendor --exclude=.git -czf laravel_project.tar.gz .

2. 导出数据库

mysqldump -u db_user -p db_name > db.sql

3. 备份 storage 文件(如有上传文件)

tar -czf storage.tar.gz storage

二、新服务器(Linux)环境准备

1. 安装基础环境

以 Ubuntu + Nginx + PHP + MySQL 为例:

sudo apt update
sudo apt install nginx php php-fpm php-mysql php-mbstring php-xml php-curl mysql-server unzip git -y

2. 安装 Composer

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

三、部署 Laravel 项目

1. 上传代码

scp laravel_project.tar.gz user@new_server:/var/www/

解压:

cd /var/www
tar -xzf laravel_project.tar.gz

2. 安装依赖

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

3. 配置环境变量

cp .env.example .env
php artisan key:generate

修改 .env:

APP_URL=http://your-domain.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=db_user
DB_PASSWORD=db_pass

四、数据库迁移

1. 创建数据库

mysql -u root -p
CREATE DATABASE laravel;

2. 导入数据

mysql -u db_user -p db_name < db.sql

或重新迁移(空库):

php artisan migrate

五、权限设置(非常重要)

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

六、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:/var/run/php/php8.1-fpm.sock;
    }
}
sudo nginx -t
sudo systemctl restart nginx

七、缓存 & 优化

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan optimize

八、常见问题排查

1. 500 错误

tail -f storage/logs/laravel.log

2. 权限错误

sudo chmod -R 777 storage

3. 无法写入日志

chown -R www-data:www-data storage

九、可选:使用 Git 迁移(推荐)

git clone git@github.com:user/laravel.git
composer install

如果你愿意,可以告诉我:

  • ✅ 使用的 Linux 发行版(Ubuntu / CentOS)
  • ✅ 是否使用 Docker / 宝塔 / 面板
  • ✅ Laravel 版本

我可以给你更精确的迁移方案。

0 踩