温馨提示×

如何安装debian运行laravel

小樊
53
2026-09-08 06:31:21
栏目: 智能运维

下面给你一份从零开始在 Debian 上安装并运行 Laravel 的实用指南(以 Debian 11/12 为例,使用 Nginx + PHP + MariaDB)。


一、系统准备

sudo apt update
sudo apt upgrade -y

建议安装常用工具:

sudo apt install -y curl git unzip wget

二、安装 PHP(Laravel 需要 PHP 8.1+)

1. 添加 Sury PHP 源(推荐)

sudo apt install -y lsb-release ca-certificates apt-transport-https
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
echo "deb [signed-by=/usr/stake/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

2. 安装 PHP 及扩展

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-intl

检查:

php -v

三、安装 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 -V

四、安装数据库(MariaDB)

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库:

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

五、安装 Nginx

sudo apt install -y nginx

六、创建 Laravel 项目

cd /var/www
sudo composer create-project laravel/laravel laravel-app
sudo chown -R www-data:www-data laravel-app
sudo chmod -R 775 laravel-app/storage laravel-app/bootstrap/cache

七、配置 Nginx

创建配置文件:

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

内容示例:

server {
    listen 80;
    server_name your_domain_or_ip;
    root /var/www/laravel-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/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

八、配置 Laravel 环境

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

编辑 .env:

DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

九、运行 Laravel

php artisan migrate

浏览器访问:

http://your_server_ip

看到 Laravel 欢迎页即成功 ✅


十、常见问题

1. 权限问题

sudo chown -R www-data:www-data /var/www/laravel-app

2. 使用 PHP 内置服务器(开发)

php artisan serve

3. 生产环境建议

  • 使用 HTTPS(Certbot)
  • 关闭 APP_DEBUG=true
  • 配置队列 / 缓存

如果你需要:

  • Debian + Docker 部署 Laravel
  • Laravel + PostgreSQL
  • Laravel + Apache
  • 生产级部署方案

告诉我你的使用场景即可。

0 踩