База данных и миграции
Назначение и когда использовать
Connection даёт PDO, transactions и parameter binding; QueryBuilder и Model покрывают типичные CRUD-сценарии. Миграции описывают схему рядом с feature и запускаются повторяемо.
Настройка
В starter config/database.php default — env('DB_CONNECTION', 'sqlite'), SQLite database — env('DB_DATABASE', 'storage/database.sqlite'). Создайте миграцию:
php bin/console make:migration CreatePostsTable
Пример change():
use Esora\Database\Migrations\Migration;
final class CreatePostsTable extends Migration
{
public function change(): void
{
$this->table('posts')->addColumn('title', 'TEXT', ['nullable' => false])->create();
}
}
Migration::table(string $name, array $options = []), hasTable(), dropTable(); Table поддерживает addColumn, addPrimaryKey, addIndex, addForeignKey, dropColumn, create, update, drop. В безопасном portable-примере используйте Blueprint через Schema::create с id, string, integer, boolean, timestamps.
$connection->table('posts')->where('id', '=', 1)->first();
$connection->transaction(fn ($db) => $db->table('posts')->insert(['title' => 'Hello']));
QueryBuilder API: select, where, orWhere, orderBy, limit, offset, get, first, insert, update, delete, count, toSqlWithBindings. Model добавляет find, create, where, save, delete, hasMany, belongsTo.
php bin/console migrate
php bin/console migrate:rollback
Lifecycle и troubleshooting
Migration discovery → migration table → batch run() → application queries. Rollback снимает последнюю batch. Для no such table проверьте DB path и выполните migrate; для binding используйте QueryBuilder, не конкатенируйте input в SQL.