Download the PHP package richan-fongdasen/turso-laravel without Composer
On this page you can find all versions of the php package richan-fongdasen/turso-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download richan-fongdasen/turso-laravel
More information about richan-fongdasen/turso-laravel
Files in richan-fongdasen/turso-laravel
Package turso-laravel
Short Description A Turso/LibSQL database driver for Laravel
License MIT
Homepage https://github.com/richan-fongdasen/turso-laravel
Informations about the package turso-laravel
A Turso database driver for Laravel
This package provides a Turso database driver for Laravel, allowing you to use Turso as your database backend in Laravel applications. The driver communicates with the Turso database server using an HTTP client.
You can find a demo application that uses this Turso database driver in the richan-fongdasen/pingcrm repository.
Requirements
- PHP 8.2 or higher
- Laravel 11.0 or higher
- Node.js 18 or higher
Installation
You can install the package via Composer:
To use Turso as your database driver in Laravel, append the following configuration to the connections
array in your config/database.php
file:
Publishing Configuration and Sync Script
Publish the configuration file and sync script by running the following command:
The above command publishes the following files:
config/turso-laravel.php
turso-sync.mjs
The content of the config/turso-laravel.php
file should look like this:
You may need to set the NODE_PATH
environment variable to the path of your Node.js executable. This is required to run the sync script.
Installing Node.js Dependencies
The Turso database driver requires Node.js to run the sync script. Install the Node.js dependencies by running the following command:
Configuration
In Laravel applications, the database driver configuration is stored in your .env
file. Here are the available configurations for the Turso database driver:
ENV Variable Name | Description |
---|---|
DB_URL | The Turso database server URL. E.g: https://[databaseName]-[organizationName].turso.io |
DB_ACCESS_TOKEN | (Optional) The access token to access the Turso database server. |
DB_REPLICA | (Optional) The full path to the local embedded replica database file. E.g: /tmp/turso.sqlite |
DB_PREFIX | (Optional) The database table prefix. |
DB_FOREIGN_KEYS | Enable or disable foreign key constraints, default is true . |
DB_STICKY | Enable or disable sticky connections while performing write operations, default is true . |
Usage
For local development, you can use the local Turso database server provided by the Turso team. Refer to the Turso CLI documentation for instructions on running the local Turso database server.
The Turso database driver should work as expected with Laravel's Query Builder and Eloquent ORM. Here are some examples:
Embedded Replica Support
The driver supports the embedded replica feature. If you're unfamiliar with this feature, refer to the Turso embedded replica article for more information.
Running the sync script from artisan command
Run the sync script manually using the following Artisan command:
You may encounter an error if the path to the replica database does not exist. This is expected when the replica database has not been created yet.
Running the sync script programmatically
Run the sync script programmatically using the following code:
Debugging
To debug the HTTP requests and responses sent and received by the Turso database client, enable the debugging feature as follows:
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Richan Fongdasen
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of turso-laravel with dependencies
illuminate/bus Version ^11.0
illuminate/contracts Version ^11.0
illuminate/console Version ^11.0
illuminate/database Version ^11.0
illuminate/filesystem Version ^11.0
illuminate/http Version ^11.0
illuminate/queue Version ^11.0
illuminate/support Version ^11.0
spatie/laravel-package-tools Version ^1.16