在Debian上部署Laravel的核心是安装PHP(≥8.0,含cli、fpm、mysql/pgsq、mbstring、xml、zip、gd、curl、bcmath等扩展)、Composer、Nginx或Apache、MySQL/PostgreSQL,并正确配置文件权限、应用密钥和.env环境变量。

在 Debian 系统上部署 Laravel,核心是满足其运行时依赖:PHP(含关键扩展)、Composer、Web 服务器(如 Nginx 或 Apache)、数据库(如 PostgreSQL 或 MySQL),以及项目级权限与配置。不需要从源码编译 PHP,官方仓库的稳定包完全够用,也更安全省心。
PHP 及必需扩展
Laravel 要求 PHP ≥ 8.0(推荐 8.1+),并依赖以下扩展:
- php-cli:命令行执行基础(artisan 必需)
- php-fpm:处理 Web 请求(配合 Nginx)
- php-mysql 或 php-pgsql:对应你选的数据库驱动
- php-mbstring:多字节字符串处理(路由、验证等依赖)
- php-xml:Eloquent、配置加载等底层功能所需
- php-zip:Composer 安装包、文件解压所用
- php-gd:图像处理(如验证码、图片上传)
- php-curl:HTTP 请求(第三方服务集成常用)
- php-bcmath:高精度计算(部分加密/支付逻辑需要)
一键安装示例(以 PHP 8.2 为例):
sudo apt update && sudo apt install php8.2-cli php8.2-fpm php8.2-mysql php8.2-pgsql php8.2-mbstring php8.2-xml php8.2-zip php8.2-gd php8.2-curl php8.2-bcmathComposer(PHP 包管理器)
这是 Laravel 项目初始化和依赖管理的唯一入口,必须安装:
- 下载安装脚本并全局安装到
/usr/local/bin/composer - 建议更换国内镜像源提升速度:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证:运行
composer --version应显示版本号
Web 服务器(二选一)
Nginx(推荐):轻量、高性能,适合 Laravel 的静态资源分发与 PHP-FPM 协同。
- 安装:
sudo apt install nginx - 配置要点:root 指向
project/public,启用try_files $uri $uri/ /index.php?$query_string;,正确代理 .php 请求到 PHP-FPM socket
Apache(可选):若习惯使用,需启用 mod_rewrite 并确保 .htaccess 生效。
- 安装:
sudo apt install apache2 libapache2-mod-php - 启用重写模块:
a2enmod rewrite
数据库(按需选择一种)
Laravel 支持多种数据库,PostgreSQL 和 MySQL/MariaDB 最常用:
-
PostgreSQL:
sudo apt install postgresql postgresql-contrib,创建用户和数据库后,在.env中设DB_CONNECTION=pgsql -
MySQL/MariaDB:
sudo apt install mysql-server或mariadb-server,初始化后配置DB_CONNECTION=mysql
注意:无需额外安装 PDO 扩展——上述 php-mysql / php-pgsql 已自动包含 PDO 驱动。
其他必要项
-
文件权限:确保
storage和bootstrap/cache目录由 Web 服务器用户(如www-data)可写:sudo chown -R www-data:www-data storage bootstrap/cache -
应用密钥:首次部署必须运行
php artisan key:generate,否则会报错 -
环境配置:复制
.env.example为.env,填入数据库、缓存、邮件等真实参数


















