温馨提示×

怎样在debian部署laravel

小樊
38
2026-09-05 08:42:02
栏目: 智能运维

下面给你一个在 Debian(以 Debian 11/12 为例)部署 Laravel 的完整流程,涵盖 PHP、Composer、Nginx、MySQL、Laravel 项目部署与常见优化


一、系统准备

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

二、安装 PHP(推荐 PHP 8.1 / 8.2)

1. 安装 PHP 及常用扩展

sudo apt install -y php php-cli php-fpm php-mysql \
php-curl php-mbstring php-xml php-bcmath php-zip php-gd

查看版本:

php -v

三、安装 Composer

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

四、安装 Nginx

sudo apt install -y nginx

五、安装数据库(MySQL / MariaDB)

MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

创建数据库

mysql -u root -p
CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;
EXIT;

六、部署 Laravel 项目

方式一:从 Git 拉取

cd /var/www
git clone your-repo.git laravel
cd laravel

方式二:上传代码

mkdir -p /var/www/laravel

七、安装 Laravel 依赖

cd /var/www/laravel
composer install --optimize-autoloader --no-dev

八、配置环境

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

编辑 .env

APP_ENV=production
APP_DEBUG=false
APP_URL=http://yourdomain.com

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

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

sudo chown -R www-data:www-data /var/www/laravel
sudo chmod -R 755 /var/www/laravel
sudo chmod -R 775 /var/www/laravel/storage
sudo chmod -R 775 /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:/run/php/php-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

十一、运行 Laravel 初始化

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 -y certbot python3-certbot-nginx
sudo certbot --nginx

常见问题

500 错误

  • 检查 .env
  • 检查 storage 权限
  • 查看日志:storage/logs/laravel.log

白屏

php artisan config:clear
php artisan cache:clear

如果你需要:

  • Debian + Docker 部署
  • Laravel + Supervisor 队列
  • 生产环境性能优化

可以直接告诉我你的使用场景。

0