debian下laravel如何连数据库

在 Debian 下让 Laravel 连接数据库，一般分为 安装数据库 → 配置 Laravel → 测试连接 几个步骤。下面以最常见的 MySQL / MariaDB 为例说明（PostgreSQL 类似）。

一、在 Debian 上安装数据库（以 MySQL 为例）

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 MySQL / MariaDB

# MySQL
sudo apt install mysql-server -y

# 或 MariaDB
sudo apt install mariadb-server -y

3. 启动并设置开机自启

sudo systemctl start mysql
sudo systemctl enable mysql

4. 安全初始化（可选但推荐）

sudo mysql_secure_installation

二、创建数据库和用户

sudo mysql -u root -p

在 MySQL 中执行：

CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'password';

GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';

FLUSH PRIVILEGES;
EXIT;

三、Laravel 配置数据库连接

1. 修改 .env 文件

进入你的 Laravel 项目目录：

cd /var/www/laravel

编辑 .env：

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

⚠️ 如果是 Laravel 11+，可能是 .env.example → 复制成 .env

2. 清除配置缓存（非常重要）

php artisan config:clear
php artisan cache:clear

四、测试 Laravel 是否能连数据库

方法 1：执行迁移

php artisan migrate

如果成功，说明连接正常。

方法 2：Tinker 测试

php artisan tinker

DB::connection()->getPdo();

不报错即代表连接成功。

五、常见问题排查

1. 找不到 php 或 artisan

sudo apt install php php-cli php-mysql

2. 缺少 PDO 扩展

sudo apt install php-mysql
sudo systemctl restart apache2  # 或 php-fpm

3. 权限问题

确保：

• .env 可读
• 数据库用户只允许 localhost（或服务地址正确）

六、PostgreSQL（简要）

sudo apt install postgresql

.env：

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=laravel_db
DB_USERNAME=postgres
DB_PASSWORD=password

安装扩展：

sudo apt install php-pgsql

如果你愿意，可以告诉我：

• Laravel 版本
• 使用 Nginx 还是 Apache
• 数据库类型（MySQL / PostgreSQL）

我可以给你 更精确的配置示例。