PHPackages                             darkterminal/turso-php-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. darkterminal/turso-php-installer

ActiveLibrary[Database &amp; ORM](/categories/database)

darkterminal/turso-php-installer
================================

Turso libSQL Extension PHP Installer

2.1.0(1y ago)194.2k↓26.4%2[1 PRs](https://github.com/darkterminal/turso-php-installer/pulls)1MITPHPPHP ^8.2.0CI passing

Since Jun 20Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/darkterminal/turso-php-installer)[ Packagist](https://packagist.org/packages/darkterminal/turso-php-installer)[ GitHub Sponsors](https://github.com/sponsors/darkterminal)[ RSS](/packages/darkterminal-turso-php-installer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (9)Versions (22)Used By (1)

 [    ![Shows a black logo in light color mode and a white one in dark color mode.](https://camo.githubusercontent.com/1231973ca7d74462fee93f4c961bcd721ad05606533ba80fa84994344a26ba78/68747470733a2f2f692e696d6775722e636f6d2f764743433049342e706e67)  ](https://discord.gg/turso)

Turso PHP Installer
===================

[](#turso-php-installer)

This is the Turso/libSQL Extension for PHP installer script for Linux and MacOS. Make sure you already have PHP minimal version 8.3.

Installation
------------

[](#installation)

```
composer global require darkterminal/turso-php-installer
```

Laravel Sail
------------

[](#laravel-sail)

Copy and Paste the stubs from [here](/docs/laravel-sail.md)

---

make sure the installer is available in `PATH` environment variable:

```
export PATH="$HOME/.composer/vendor/bin;$PATH"
# or
export PATH="$HOME/.config/composer/vendor/bin;$PATH"
```

Usage &amp; Overview
--------------------

[](#usage--overview)

```
USAGE:   [options] [arguments]

install                    Install Turso libSQL Extension for PHP
uninstall                  Uninstall Turso libSQL Extension for PHP
update                     Update Turso libSQL Extension for PHP
version                    Display Turso PHP Installer version

token:create               Create libSQL Server Database token for Local Development
token:delete               Delete a database token
token:list                 Display all generated database tokens
token:show                 Show libSQL Server Database token for Local Development
```

Unix Only Command

```
server:ca-cert-create      Generate CA certificate
server:ca-cert-delete      Delete a CA certificate from the global store location
server:ca-cert-list        List all generated CA certificates
server:ca-cert-show        Show raw CA certificate and private key
server:ca-peer-cert-create Create a peer certificate
server:cert-store-get      Get the cert store location
server:cert-store-set      Set/overwrite global certificate store, to use by the server later. Default is same as {installation_dir}/certs
server:check               Check server requirement, this will check if python3 pip and cyptography lib are installed

sqld:env-delete            Delete an environment by name or ID
sqld:env-edit              Edit an existing environment by ID or name
sqld:env-list              List all created environments
sqld:env-new               Create new sqld environment, save for future use.
sqld:env-show              Show detail of environment
sqld:open-db               Open database using Turso CLI based on environment id or name and database
sqld:server-run            Run sqld server based on environment id or name
```

Install Extension
-----------------

[](#install-extension)

**Interactive Mode**

```
turso-php-installer install
```

**Non Interactive Mode**

**PHP NTS (Non Thread-Safe) Build**

By default the installer will install the **stable** version of libSQL Client from `tursodatabase/turso-client-php` release with NTS (Non Thread-Safe) build version.

```
turso-php-installer install -n --php-vesion=8.3 --php-ini=/etc/php//cli/php.ini --extension-dir=/path/to/your-custom/extensions/directory
```

But, if you want to use the **unstable** version (which is the development) version of libSQL Client, the installer will install from another source `pandanotabear/turso-client-php` release with NTS (Non Thread-Safe) build version. (Btw, Panda is my another pet in GitHub)

```
turso-php-installer install -n --unstable --php-vesion=8.3 --php-ini=/etc/php//cli/php.ini --extension-dir=/path/to/your-custom/extensions/directory
```

**PHP TS (Thread-Safe) Build**

**Stable** version build - libSQL Client from `tursodatabase/turso-client-php` release with TS (Thread-Safe) build version.

```
turso-php-installer install -n --thread-safe --php-vesion=8.3 --php-ini=/etc/php//cli/php.ini --extension-dir=/path/to/your-custom/extensions/directory
```

**Unstable** version build - libSQL Client, the installer will install from another source `pandanotabear/turso-client-php` release with NTS (Non Thread-Safe) build version.

```
turso-php-installer install -n --unstable --thread-safe --php-vesion=8.3 --php-ini=/etc/php//cli/php.ini --extension-dir=/path/to/your-custom/extensions/directory
```

> See `turso-php-installer install --help`

Uninstall Extension
-------------------

[](#uninstall-extension)

```
turso-php-installer uninstall
```

Update Extension
----------------

[](#update-extension)

```
turso-php-installer update
```

Using Local LibSQL for Development
----------------------------------

[](#using-local-libsql-for-development)

**Create Database Token**

Create libSQL Server Database token for Local Development

```
turso-php-installer token:create
```

**Show Database Token**

Show libSQL Server Database token for Local Development

```
turso-php-installer token:show
```

This command will show all tokens and secrets. You can also see indivial token read at `turso-php-installer token:show --help`

> [See detail explanation](https://gist.github.com/darkterminal/c272bf2a572bc5d7378f31cf4aea5f19)

FAQ
---

[](#faq)

**The Extension Is Not Working in Windows**

Please, download the official release extension binary from [Turso Client PHP](https://github.com/tursodatabase/turso-client-php/releases) GitHub Release Page. Or you can you WSL or you can use [Turso Docker PHP](https://github.com/darkterminal/turso-docker-php)

Give Me a Coffe
---------------

[](#give-me-a-coffe)

- GitHub Sponsors
- Direct Paypal

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance66

Regular maintenance activity

Popularity33

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 71.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

19

Last Release

442d ago

Major Versions

1.0.0 → 2.0.02024-09-15

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/32319439?v=4)[Imam Ali Mustofa](/maintainers/darkterminal)[@darkterminal](https://github.com/darkterminal)

---

Top Contributors

[![darkterminal](https://avatars.githubusercontent.com/u/32319439?v=4)](https://github.com/darkterminal "darkterminal (172 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (65 commits)")[![eznix86](https://avatars.githubusercontent.com/u/26553194?v=4)](https://github.com/eznix86 "eznix86 (4 commits)")

---

Tags

databaseextensioninstaller-scriptlibsqlphpphp-extensionsqliteturso

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/darkterminal-turso-php-installer/health.svg)

```
[![Health](https://phpackages.com/badges/darkterminal-turso-php-installer/health.svg)](https://phpackages.com/packages/darkterminal-turso-php-installer)
```

###  Alternatives

[kreait/firebase-php

Firebase Admin SDK

2.4k39.7M72](/packages/kreait-firebase-php)[wnx/laravel-backup-restore

A package to restore database backups made with spatie/laravel-backup.

203330.1k2](/packages/wnx-laravel-backup-restore)[tpetry/laravel-mysql-explain

Get Visual MySQL EXPLAIN for Laravel.

264154.2k](/packages/tpetry-laravel-mysql-explain)[dragon-code/laravel-deploy-operations

Performing any actions during the deployment process

240173.5k2](/packages/dragon-code-laravel-deploy-operations)[webfactory/slimdump

slimdump is a little tool to help you creating dumps of large MySQL-databases.

188124.8k1](/packages/webfactory-slimdump)[worksome/foggy

Foggy is a tool for making database dumps with some data removed/changed.

26571.7k1](/packages/worksome-foggy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
