温馨提示×

如何用debian搭建laravel环境

小樊
42
2026-10-22 19:39:58
栏目: 智能运维

下面给你一套在 Debian(以 Debian 11 / 12 为例)上搭建 Laravel 运行环境的常用做法,涵盖 Nginx + PHP + MySQL + Composer,适合新手也能直接用。


一、系统准备

sudo apt update
sudo apt upgrade -y

安装常用工具:

sudo apt install -y curl git unzip wget ca-certificates lsb-release gnupg

二、安装 Nginx

sudo apt install -y nginx

启动并设置开机自启:

sudo systemctl enable nginx
sudo systemctl start nginx

测试:

curl http://localhost

三、安装 PHP(推荐 PHP 8.2 / 8.3)

1. 添加 Sury PHP 源(Debian 官方 PHP 版本较旧)

curl -sSL https://packages.sury.org/php/README.txt
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

2. 安装 PHP 及 Laravel 所需扩展

sudo apt install -y php8.2 php8.2-fpm php8.2-cli \
php8.2-mysql php8.2-mbstring php8.2-xml \
php8.2-curl php8.2-zip php8.2-gd php8.2-bcmath

检查版本:

php -v

四、安装 MySQL(或 MariaDB)

安装 MySQL

sudo apt install -y mysql-server
sudo systemctl enable mysql
sudo systemctl start mysql

初始化安全设置

sudo mysql_secure_installation

创建 Laravel 数据库

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

五、安装 Composer

cd /tmp
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

六、创建 Laravel 项目

cd /var/www
sudo composer create-project laravel/laravel example-app

设置权限:

sudo chown -R www-data:www-data /var/www/example-app
sudo chmod -R 755 /var/www/example-app
sudo chmod -R 775 /var/www/example-app/storage

七、配置 Nginx 虚拟主机

sudo nano /etc/nginx/sites-available/example-app

示例配置:

server {
    listen 80;
    server_name example.com;

    root /var/www/example-app/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/php8.2-fpm.sock;
    }

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

启用站点:

sudo ln -s /etc/nginx/sites-available/example-app /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

八、配置 Laravel 环境

cd /var/www/example-app
cp .env.example .env
php artisan key:generate

编辑 .env:

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

九、测试运行

php artisan migrate

浏览器访问:

http://服务器IP

看到 Laravel 欢迎页面即成功 ✅


十、可选增强(推荐)

  • 安装 Redis:sudo apt install redis-server
  • 安装 Node.js(前端构建)
  • 配置 HTTPS(Let’s Encrypt)
  • 使用 Supervisor 管理队列

如果你告诉我:

  • Debian 版本(10 / 11 / 12)
  • PHP 版本需求
  • 是否用 Docker / 宝塔 / 单机

我可以给你更精确的配置方案。

0 踩