Laravel create migration file in specific folder
Stefan Bogdanescu
Founder & Senior Architect · 2026-06-29
Title: Efficiently Create Migration Files for Your Payment Package in Laravel using Custom Artisan Commands
Introduction:
Creating migration files is an important part of managing a database for your Laravel application. In some cases, you may need to create the migration scripts within a specific folder structure, such as when working with a package or module. This article will guide you through the process of creating custom artisan commands to achieve this goal.
Step 1: Create Folder Structure for Your Payment Package
Begin by organizing your payment package's files into an appropriate directory structure. Typically, it would be within the 'app/Payment/' folder to keep all related files and classes in one place. This includes creating a new folder named "Database" inside this path.
Step 2: Create a Simple Migration File as Example
Create a basic migration file under your newly created 'app/Payment/Database' directory, like "create_payment_table". This migration will contain the necessary code to create a table for storing payment information:
class CreatePaymentTable extends Migration
{
public function up()
{
Schema::create('payments', function (Blueprint $table) {
$table->bigIncrements('id');
$table->string('order_id');
// Add more columns as needed
$table->timestamps();
});
}
public function down()
{
Schema::dropIfExists('payments');
}
}
class MakePaymentMigration extends Command
{
use CreatesApplicationCommands;
/**
* The name and signature of the console command.
*
* @var string
*/
protected $signature = 'make:payment-migration {name}';
/**
* The console command description.
*
* @var string
*/
protected $description = 'Create a new payment migration file within the "Payment" package.';
public function handle()
{
$name = $this->argument('name');
$namespace = config("app.namespace") . '\\Payment\\Database\\Migrations\\';
$path = base_path("app/Payment/Database");
if (!empty($name)) {
// If a name is provided, create the migration file and its corresponding table.
$this->call('make:migration', [
'--table' => 'payments',
'--create' => true,
'--timestamps' => true,
]);
} else {
// If no name is provided, create an example migration file.
$this->call('make:migration', [
'name' => 'CreatePaymentTable',
'table' => 'payments',
'--create' => true,
'--timestamps' => true,
]);
}
// Move the migration file to a specific folder.
$this->command->call('migrate:refresh');
$this->moveMigrationFile();
}
protected function moveMigrationFile()
{
copy(config('filesystems.disks.local.root') . '/database/migrations/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '.php', $path);
copy(config('filesystems.disks.local.root') . '/database/migrations/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '_down.php', $path);
rename(config('filesystems.disks.local.root') . '/database/migrations/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '.php', 'Payment/src/Database/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '_' . (strpos($this->argument('name'), '-') !== false ? explode('-', $this->argument('name'))[1] : 'default') . '.php');
rename(config('filesystems.disks.local.root') . '/database/migrations/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '_down.php', 'Payment/src/Database/' . date('Y_m_d_His', time()) . '_' . strtolower(explode(' ', $this->argument('name'))[0]) . '_' . (strpos($this->argument('name'), '-') !== false ? explode('-', $this->argument('name'))[1] : 'default') . '_down.php');
}
}