Linux系统下Laravel数据库管理指南

一、数据库环境配置

1. 安装数据库服务器

Linux系统下常用MySQL或PostgreSQL作为Laravel的数据库后端。以MySQL为例，安装步骤如下（以CentOS为例）：

sudo yum install mysql-server  # 安装MySQL服务器
sudo systemctl start mysqld    # 启动MySQL服务
sudo systemctl enable mysqld   # 设置开机自启
sudo mysql_secure_installation # 运行安全脚本，设置root密码并删除匿名用户

若使用PostgreSQL，命令类似：

sudo yum install postgresql-server postgresql-contrib  # 安装PostgreSQL
sudo systemctl start postgresql                      # 启动服务
sudo systemctl enable postgresql                     # 开机自启

2. 创建数据库与用户

登录数据库（MySQL示例）：

mysql -u root -p  # 输入root密码登录

执行以下SQL创建数据库和用户（替换laravel_db、laravel_user、your_password为实际值）：

CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  -- 创建数据库（指定字符集）
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'your_password';         -- 创建用户
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';           -- 授权
FLUSH PRIVILEGES;                                                           -- 刷新权限
EXIT;                                                                       -- 退出

3. 配置Laravel连接

修改Laravel项目根目录下的.env文件，调整数据库连接参数：

DB_CONNECTION=mysql       # 数据库驱动（MySQL/PostgreSQL/SQLite等）
DB_HOST=127.0.0.1         # 数据库服务器地址（本地为127.0.0.1）
DB_PORT=3306              # 数据库端口（MySQL默认3306，PostgreSQL默认5432）
DB_DATABASE=laravel_db    # 数据库名
DB_USERNAME=laravel_user  # 数据库用户名
DB_PASSWORD=your_password # 数据库密码

4. 测试连接

创建测试路由（routes/web.php）验证连接：

Route::get('/test-db', function () {
    $users = DB::table('users')->get();  // 查询users表（需存在）
    return view('welcome', compact('users'));
});

访问http://your-server-ip/test-db，若能显示数据则配置成功。

二、数据库迁移管理

迁移是Laravel管理数据库结构变更的核心工具，支持版本控制与团队协作。

1. 创建迁移文件

使用Artisan命令生成迁移文件，指定表名（如users）：

php artisan make:migration create_users_table --create=users  # 创建新表
php artisan make:migration add_votes_to_users_table --table=users  # 给现有表添加字段

迁移文件会保存在database/migrations目录下，文件名包含时间戳（如2025_09_18_000000_create_users_table.php）。

2. 编辑迁移文件

打开生成的迁移文件，修改up（创建/修改结构）和down（回滚操作）方法。例如，创建users表的迁移：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateUsersTable extends Migration {
    public function up() {
        Schema::create('users', function (Blueprint $table) {
            $table->id();                                  // 自增主键
            $table->string('name');                        // 用户名
            $table->string('email')->unique();             // 唯一邮箱
            $table->timestamp('email_verified_at')->nullable(); // 邮箱验证时间
            $table->string('password');                    // 密码
            $table->rememberToken();                       // 记住我token
            $table->timestamps();                          // 创建/更新时间
        });
    }

    public function down() {
        Schema::dropIfExists('users');                    // 回滚时删除表
    }
}

3. 运行迁移

执行以下命令应用所有未完成的迁移：

php artisan migrate

若需强制在生产环境运行（可能丢失数据），添加--force参数：

php artisan migrate --force

4. 回滚与重建

回滚最后一次迁移：
```
php artisan migrate:rollback
```
回滚最近5次迁移：
```
php artisan migrate:rollback --step=5
```

重建数据库（删除所有表并重新运行迁移）：

php artisan migrate:refresh  # 仅重建
php artisan migrate:refresh --seed  # 重建并填充种子数据

三、数据库种子管理

种子用于填充测试或演示数据，提升开发效率。

1. 创建种子类

使用Artisan生成种子文件（如UsersTableSeeder）：

php artisan make:seeder UsersTableSeeder

种子文件会保存在database/seeds目录下。

2. 编写种子逻辑

打开种子文件，编辑run方法，使用DB门面或Eloquent插入数据。例如：

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class UsersTableSeeder extends Seeder {
    public function run() {
        DB::table('users')->insert([
            'name' => 'John Doe',
            'email' => 'john@example.com',
            'password' => bcrypt('password'),  // 密码加密
            'created_at' => now(),
            'updated_at' => now(),
        ]);
    }
}

3. 关联模型工厂（可选）

若需生成大量随机数据，可使用模型工厂。首先创建工厂：

php artisan make:factory UserFactory --model=User

编辑database/factories/UserFactory.php，定义数据生成规则：

use Faker\Generator as Faker;

$factory->define(App\Models\User::class, function (Faker $faker) {
    return [
        'name' => $faker->name,
        'email' => $faker->unique()->safeEmail,
        'password' => bcrypt('password'),
        'created_at' => now(),
        'updated_at' => now(),
    ];
});

修改种子文件，使用工厂生成50条数据：

use App\Models\User;

public function run() {
    User::factory()->count(50)->create();  // 生成50条用户数据
}

4. 执行种子

运行所有种子（DatabaseSeeder.php中定义的种子类）：
```
php artisan db:seed
```

单独运行某个种子类：

php artisan db:seed --class=UsersTableSeeder

四、常见问题排查

连接失败：检查.env中的数据库配置是否正确，数据库服务是否启动，防火墙是否允许端口通信（如MySQL的3306端口）。
迁移冲突：若迁移文件已执行但结构有误，可修改down方法确保回滚正确，再重新运行迁移。
种子重复：避免多次运行同一种子导致数据重复，可在run方法中添加判断逻辑（如检查数据是否存在）。

通过以上步骤，可在Linux系统下高效管理Laravel数据库，实现结构变更的版本控制与测试数据的快速填充。

0 赞

0 踩

Linux系统下Laravel数据库如何管理