Repository navigation
Home
This is the user documentation for tursodatabase/turso-driver-laravel, a
Laravel database driver backed by the native libsql_php extension.
Every feature documented here is verified against the repository; nothing on these pages is aspirational marketing. Where something is not verified by the repository, it is marked Not verified explicitly.
| Component | Requirement |
|---|---|
| PHP | 8.2 / 8.3 / 8.4 / 8.5 |
| Laravel | 12 or 13 (13 requires PHP 8.3+) |
| libsql_php extension | 1.7.0+ (installed automatically via Artisan) |
| Turso PHP installer | 2.2+ (bundled with this package) |
Verified by: the test suite runs on GitHub Actions on 7 legs (Laravel 12 ×
PHP 8.2–8.5, Laravel 13 × PHP 8.3–8.5) against two seeded libsql-server
instances (see .github/workflows/tests.yml). Laravel 10/11 are not
supported — they are EOL and cannot be installed alongside this package.
- Installation
- Configuration
- Connection Types
- Basic Usage
- Offline Writes (two flavors)
- Verification & Proof Harness
- Known Limitations
- Troubleshooting
tursodatabase/turso-driver-laravel is a Laravel database driver that talks
to libSQL — an embedded, SQLite-compatible database that can run fully
locally, replicate to a remote server, or sync with Turso Cloud.
It is not an ORM replacement and does not try to be one; it provides a
libsql driver compatible with Laravel's database abstraction layer (Eloquent,
Query Builder, migrations, schema builder, transactions).