35 lines
1.0 KiB
PHP
35 lines
1.0 KiB
PHP
<?php
|
|
namespace DatabaseHelper\interfaces;
|
|
|
|
interface InsertionBuilder
|
|
{
|
|
/**
|
|
* Initializes an InsertionBuilder with a table blueprint.
|
|
* @param TableBlueprint $table Table to insert data into.
|
|
*/
|
|
public function __construct(TableBlueprint $table);
|
|
|
|
/**
|
|
* Specifies a single column-value pair for insertion.
|
|
* @param string $col Column name to insert into.
|
|
* @param mixed $val Value to insert.
|
|
* @return InsertionBuilder Current instance for method chaining.
|
|
*/
|
|
public function data(string $col, mixed $val): InsertionBuilder;
|
|
|
|
/**
|
|
* Marks the current row as complete and finalizes it for insertion.
|
|
* After calling done(), only finalized rows will be inserted.
|
|
* @return InsertionBuilder Current instance for method chaining.
|
|
*/
|
|
public function done(): InsertionBuilder;
|
|
|
|
/**
|
|
* Executes the insert query.
|
|
* Automatically determines whether to insert a single row or batch insert.
|
|
* @return void
|
|
*/
|
|
public function insert(): void;
|
|
}
|
|
|