Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/darkterminal/turso-http
The PHP library for Turso HTTP Database API & Platform API Wrapper
https://github.com/darkterminal/turso-http
codeigniter laravel libsql libsqlite3 php sqlite sqlite3 turso
Last synced: 2 months ago
JSON representation
The PHP library for Turso HTTP Database API & Platform API Wrapper
- Host: GitHub
- URL: https://github.com/darkterminal/turso-http
- Owner: darkterminal
- License: mit
- Created: 2024-01-21T10:01:22.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-07-30T02:05:49.000Z (2 months ago)
- Last Synced: 2024-07-31T06:03:41.779Z (2 months ago)
- Topics: codeigniter, laravel, libsql, libsqlite3, php, sqlite, sqlite3, turso
- Language: PHP
- Homepage:
- Size: 178 KB
- Stars: 35
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-turso - turso-http
README
The `TursoHTTP` library is a PHP wrapper for Turso HTTP Database API (Only). It simplifies interaction with Turso databases using the Hrana over HTTP protocol. This library provides an object-oriented approach to build and execute SQL queries with same API Interface like PHP Native Extension [Turso Client PHP](https://github.com/tursodatabase/turso-client-php).
## Requirements
- Intention and Courage
- Instinct as a Software Freestyle Engineer
- Strong determination!
- [Turso](https://turso.tech/) Account
- Don't forget to install [PHP](https://php.net) on your machine
- A cup of coffee and the music you hate the most
- Dancing (optional: if you are willing)
## Features
- **[libSQL Native Extension](https://github.com/tursodatabase/turso-client-php)** like API Interface
- Schema Builder
- Query Builder
- Turso Platform API
- Timezone Support
## Installation
You can install the **TursoHTTP** library using Composer:
```bash
composer require darkterminal/turso-http
```
## Setting Up Timezone
Set the database display timezome in your `env` variable. See the list of timezones [here](https://www.php.net/manual/en/timezones.php)
```env
DB_TIMEZOME=Asia/Jakarta
```
## Usage Example
```php
use Darkterminal\TursoHttp\LibSQL;
require_once 'vendor/autoload.php';
$dbname = getenv('DB_URL');
$authToken = getenv('DB_TOKEN');
$db = new LibSQL("dbname=$dbname&authToken=$authToken");
echo $db->version() . PHP_EOL;
$create_table = <<execute($create_table);
```
## LibSQL Schema Builder
```php
create('contacts', function(LibSQLBlueprint $table) {
$table->increments('id');
$table->string('name');
$table->unique('email');
$table->string('phone');
$table->timestamps();
})->execute();
echo "Table created successfully.\n";
// Add new column in the table
$schemaBuilder->table('contacts', function(LibSQLBlueprint $table) {
$table->addColumn(DataType::TEXT, 'address');
})->execute();
echo "Column added successfully.\n";
// Drop the table
$schemaBuilder->drop('contacts')->execute();
echo "Table contacts successfully dropped!.\n";
} catch (Exception $e) {
echo "An error occurred: " . $e->getMessage();
}
```
## Raw Query
```php
execute($query, [
'Imam Ali Mustofa',
'[email protected]',
'08123456789',
'Punk Univers'
]);
```
## Query Builder
```php
table('contacts')
->where('address', '=', 'Punk Universe')
->get();
var_dump($contacts);
```
## Turso Platform API - PHP
Manage databases, replicas, and teams with the Turso Platform API using PHP.
- [Quickstart](docs/PlatformAPI/README.md)
- [API Tokens](docs/PlatformAPI/APITokens.md)
- [Audit Logs](docs/PlatformAPI/AuditLogs.md)
- [Databases](docs/PlatformAPI/Databases.md)
- [Groups](docs/PlatformAPI/Groups.md)
- [Locations](docs/PlatformAPI/Locations.md)
## License
This library is licensed under the MIT License - see the [LICENSE](https://github.com/darkterminal/turso-http/blob/main/LICENSE) file for details.