温馨提示×

linux laravel怎样部署

小樊
41
2026-09-22 10:31:33
栏目: 智能运维

下面给你一份在 Linux 上部署 Laravel 项目的常见、实用方案(以 Ubuntu / Debian 为例,CentOS 类似)。


一、服务器环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装基础软件

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

Laravel 版本不同,PHP 版本要求不同(Laravel 10 需要 PHP 8.1+)


二、安装 Composer

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

三、部署 Laravel 项目

1. 上传或拉取代码

cd /var/www
git clone https://github.com/your/laravel.git
cd laravel

或上传 zip 解压。

2. 安装依赖

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

3. 配置环境

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

编辑 .env

nano .env

配置数据库等信息。


四、权限设置(很重要)

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

五、配置 Nginx

sudo nano /etc/nginx/sites-available/laravel

示例配置:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/laravel/public;

    index index.php index.html;

    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;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用站点:

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

六、数据库迁移

php artisan migrate --force

七、优化(生产环境)

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

八、队列 / 定时任务(可选)

队列

php artisan queue:work

建议用 supervisor 守护进程。

定时任务

crontab -e
* * * * * cd /var/www/laravel && php artisan schedule:run >> /dev/null 2>&1

九、HTTPS(推荐)

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx

十、常见问题

✅ 500 错误

  • 看 storage/logs/laravel.log
  • 检查权限和 .env

✅ 404

  • Nginx root 指向 public

✅ 白屏

  • 检查 PHP 版本

如果你告诉我:

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

我可以给你更精确的部署步骤。

0 踩