Laravel CSV Seeder 使用教程

Laravel CSV Seeder 使用教程

laravel-csv-seeder Seed your database with CSV files 项目地址: https://gitcode.com/gh_mirrors/la/laravel-csv-seeder

1. 项目介绍

Laravel CSV Seeder 是一个用于 Laravel 框架的开源项目，旨在通过 CSV 文件快速填充数据库。它允许开发者将 CSV 文件中的数据导入到数据库表中，从而简化了数据初始化和测试数据的准备过程。该项目支持多种配置选项，如自定义分隔符、数据映射、数据修剪等，以满足不同的导入需求。

2. 项目快速启动

安装

首先，在 composer.json 文件中添加依赖并运行 composer update 命令，或者直接运行以下命令：

composer require flynsarmy/csv-seeder:2.*

使用

1. 准备 CSV 文件
   确保 CSV 文件的表头与数据库表的列名一致。例如，如果要导入 id 和 name 列，CSV 文件应如下所示：

   id,name
   1,Foo
   2,Bar
   

2. 创建 Seeder 类
   创建一个新的 Seeder 类，并继承 Flynsarmy\CsvSeeder\CsvSeeder。在构造函数中定义目标数据库表和 CSV 文件路径，并在 run 方法中调用 parent::run()。

   use Flynsarmy\CsvSeeder\CsvSeeder;
   
   class StopsTableSeeder extends CsvSeeder
   {
       public function __construct()
       {
           $this->table = 'your_table';
           $this->filename = base_path() . '/database/seeds/csvs/your_csv.csv';
       }
   
       public function run()
       {
           // 建议在导入较大 CSV 文件时禁用查询日志
           DB::disableQueryLog();
   
           // 可选：在填充数据前清空表
           DB::table($this->table)->truncate();
   
           parent::run();
       }
   }
   

3. 运行 Seeder
   在 database/seeds/DatabaseSeeder.php 中调用新创建的 Seeder 类：

   public function run()
   {
       $this->call(StopsTableSeeder::class);
   }
   

   然后运行以下命令以执行 Seeder：

   php artisan db:seed
   

3. 应用案例和最佳实践

应用案例

• 初始化测试数据：在开发和测试阶段，使用 CSV 文件快速填充数据库，以便进行功能测试和性能测试。
• 数据迁移：在不同系统之间迁移数据时，将数据导出为 CSV 文件，然后使用 Laravel CSV Seeder 导入到新系统中。

最佳实践

• 数据映射：在 CSV 文件的表头与数据库表列名不一致时，使用 mapping 配置选项进行映射。
• 数据修剪：在导入数据时，使用 should_trim 选项自动去除数据中的空白字符，确保数据的准确性。
• 分块插入：对于较大的 CSV 文件，使用 insert_chunk_size 配置选项分块插入数据，以提高导入效率。

4. 典型生态项目

• Laravel：Laravel CSV Seeder 是 Laravel 框架的一个扩展，适用于所有使用 Laravel 的项目。
• Eloquent ORM：与 Laravel 的 Eloquent ORM 结合使用，可以更方便地管理和操作数据库数据。
• Laravel Nova：Laravel 的管理面板工具，可以与 Laravel CSV Seeder 结合使用，实现数据的批量导入和管理。

通过以上步骤，您可以快速上手并使用 Laravel CSV Seeder 项目，简化数据导入过程，提高开发效率。

laravel-csv-seeder Seed your database with CSV files 项目地址: https://gitcode.com/gh_mirrors/la/laravel-csv-seeder