feat: Add --skip-fk-checks option to disable foreign key checks

When seeding tables with foreign key constraints, use --skip-fk-checks
to wrap delete/insert statements with SET FOREIGN_KEY_CHECKS=0/1.
This prevents "foreign key constraint failed" errors.

Based on PR #157 by @aomini, with improved option naming and
implementation that doesn't require stub modifications.

Author: tihomiro

README.md

@@ -205,6 +205,16 @@ Example:
 php artisan iseed users --noregister
 ```
 
+### skip-fk-checks
+By using --skip-fk-checks the generated seeder will include statements to disable foreign key checks before deleting/inserting and re-enable them afterwards. This is useful when seeding tables that have foreign key constraints, as it prevents "foreign key constraint failed" errors.
+
+Example:
+```
+php artisan iseed users --skip-fk-checks
+```
+
+**Note**: This option generates MySQL-specific `SET FOREIGN_KEY_CHECKS` statements.
+
 ### where
 Optional parameter which allows you to specify a SQL WHERE clause to filter the rows that will be included in the seed file. The WHERE clause should be provided as a string and will be applied directly to the SQL query.
 

src/Orangehill/Iseed/Iseed.php

@@ -65,10 +65,11 @@ public function readStubFile($file)
      * @param  string   $prerunEvent
      * @param  string   $postrunEvent
      * @param  bool     $register
+     * @param  bool     $skipFkChecks
      * @return bool
      * @throws Orangehill\Iseed\TableNotFoundException
      */
-    public function generateSeed($table, $prefix = null, $suffix = null, $database = null, $max = 0, $chunkSize = 0, $exclude = null, $prerunEvent = null, $postrunEvent = null, $dumpAuto = true, $indexed = true, $orderBy = null, $direction = 'ASC', $whereClause = null, $register = true)
+    public function generateSeed($table, $prefix = null, $suffix = null, $database = null, $max = 0, $chunkSize = 0, $exclude = null, $prerunEvent = null, $postrunEvent = null, $dumpAuto = true, $indexed = true, $orderBy = null, $direction = 'ASC', $whereClause = null, $register = true, $skipFkChecks = false)
     {
         if (!$database) {
             $database = config('database.default');
@@ -109,7 +110,8 @@ public function generateSeed($table, $prefix = null, $suffix = null, $database =
             $prerunEvent,
             $postrunEvent,
             $indexed,
-            $database
+            $database,
+            $skipFkChecks
         );
 
         // Save a populated stub
@@ -243,9 +245,10 @@ public function getStubPath()
      * @param  string   $postrunEvent
      * @param  bool     $indexed
      * @param  string   $database
+     * @param  bool     $skipFkChecks
      * @return string
      */
-    public function populateStub($class, $stub, $table, $data, $chunkSize = null, $prerunEvent = null, $postrunEvent = null, $indexed = true, $database = null)
+    public function populateStub($class, $stub, $table, $data, $chunkSize = null, $prerunEvent = null, $postrunEvent = null, $indexed = true, $database = null, $skipFkChecks = false)
     {
         $chunkSize = $chunkSize ?: config('iseed::config.chunk_size');
 
@@ -336,6 +339,22 @@ public function populateStub($class, $stub, $table, $data, $chunkSize = null, $p
 
         $stub = str_replace('{{insert_statements}}', $inserts, $stub);
 
+        // Add foreign key check disable/enable if requested
+        if ($skipFkChecks) {
+            // Find the delete statement and wrap everything with FK disable/enable
+            $stub = preg_replace(
+                '/(\\\\DB::.*->delete\(\);)/',
+                "\\DB::statement('SET FOREIGN_KEY_CHECKS=0;');\n\n        $1",
+                $stub
+            );
+            // Add enable statement after the last insert
+            $stub = preg_replace(
+                '/(->insert\([^;]+\);)(?!.*->insert\()/',
+                "$1\n\n        \\DB::statement('SET FOREIGN_KEY_CHECKS=1;');",
+                $stub
+            );
+        }
+
         return $stub;
     }
 

src/Orangehill/Iseed/IseedCommand.php

@@ -71,6 +71,7 @@ public function fire()
          $dumpAuto = intval($this->option('dumpauto'));
          $indexed = !$this->option('noindex');
          $register = !$this->option('noregister');
+         $skipFkChecks = $this->option('skip-fk-checks');
          $orderBy = $this->option('orderby');
          $direction = $this->option('direction');
          $prefix = $this->option('classnameprefix');
@@ -112,7 +113,8 @@ public function fire()
                          $orderBy,
                          $direction,
                          $whereClause,
-                        $register
+                        $register,
+                        $skipFkChecks
                      ),
                      $table
                  );
@@ -137,7 +139,8 @@ public function fire()
                          $orderBy,
                          $direction,
                          $whereClause,
-                        $register
+                        $register,
+                        $skipFkChecks
                      ),
                      $table
                  );
@@ -182,6 +185,7 @@ protected function getOptions()
             array('classnameprefix', null, InputOption::VALUE_OPTIONAL, 'prefix for class and file name', null),
             array('classnamesuffix', null, InputOption::VALUE_OPTIONAL, 'suffix for class and file name', null),
             array('where', null, InputOption::VALUE_OPTIONAL, 'where clause to filter records', null),
+            array('skip-fk-checks', null, InputOption::VALUE_NONE, 'disable foreign key checks during seeding', null),
         );
     }