DEV Community

Cover image for Turso libSQL Installer
Imam Ali Mustofa
Imam Ali Mustofa

Posted on

Turso libSQL Installer

Hello Punk! Yes I am, in this journal I want to share with you how to install libSQL in your PHP Environment without worry to configure php.ini file in your current PHP Version.

Install the libSQL extension for PHP it's like install a composer package:



composer require vendor/package


Enter fullscreen mode Exit fullscreen mode

to install libSQL extension for PHP



turso-php-installer install


Enter fullscreen mode Exit fullscreen mode

Turso PHP Installer

Anyway... I want you to know how the punk'in single file installer script work and setup it for you.

help command

You already see in the image above. That's the help command does.

install command

The install command will do some necessary checks before installing the libSQL Extension for PHP, what a questions will ask for? (checking in the background)

Are You Using Windows?

Even though Turso Client PHP has an extension built for Windows MSVC 2022. However, the installation process using this installer script will not work for Windows. WSL will work or you can use Turso Docker PHP!

If you're using Windows then you will get this message:



> turso-php-installer install # In Windows
Sorry, Turso PHP Installer is only support for Linux and MacOS.

You are using Windows, you can try our alternative using Dev Containers
visit: https://github.com/darkterminal/turso-docker-php

Thank you!


Enter fullscreen mode Exit fullscreen mode

Are You Using Laravel Herd?

Dang yeah... the installer is not support yet for Laravel Herd. But I will support soon, and you can follow up this discussion on Herd Community GitHub Disccussion.



$ turso-php-installer install
You are using Laravel Herd
Sorry, Laravel Herd is not supported yet.
You can try our alternative using Dev Containers
visit: https://github.com/darkterminal/turso-docker-php

Thank you!


Enter fullscreen mode Exit fullscreen mode

Is Already Installed

Sometimes I forgot when it's already installed.



$ turso-php-installer install
Turso Client PHP is already installed and configured!


Enter fullscreen mode Exit fullscreen mode

Which PHP Version?

Turso Client PHP / libSQL Extension for PHP need minimal PHP 8.0 and later. You see it at Turso Client PHP - Release page

If you have PHP below the minimum requirement, then it will failed



$ turso-php-installer install
Oops! Your PHP version environment does not meet the requirements.
Need a minimal PHP 8.0 installed on your environment.


Enter fullscreen mode Exit fullscreen mode

Check php.ini

The installer script need to lookup



$ turso-php-installer install
You don't have PHP install globaly in your environment
Turso Client PHP lookup php.ini file and it's not found


Enter fullscreen mode Exit fullscreen mode

Check The Functions Requiered

The installer script also need a shell_exec and curl function



$ turso-php-installer install
It looks like the 'shell_exec' and 'curl_version' functions are disabled in your PHP environment. These functions are essential for this script to work properly.
To enable them, follow these steps:
1. Open your 'php.ini' file. You can find the location of your 'php.ini' file by running the command 'php --ini' in your terminal or command prompt.
2. Search for 'disable_functions' directive. It might look something like this:
disable_functions = shell_exec, curl_version
3. Remove 'shell_exec' and 'curl_version' from this list. It should look like:
disable_functions =
4. Save the 'php.ini' file.
5. Restart your web server for the changes to take effect. If you are using Apache, you can restart it with:
sudo service apache2 restart
or for Nginx:
sudo service nginx restart
If you are using a web hosting service, you might need to contact your hosting provider to enable these functions for you.
For more information on 'shell_exec', visit: https://www.php.net/manual/en/function.shell-exec.php
For more information on 'curl_version', visit: https://www.php.net/manual/en/function.curl-version.php
Thank you!


Enter fullscreen mode Exit fullscreen mode

Asking Permission

The installer need to run with sudo role, because the installer will need to write php.ini file in your environment.



$ turso-php-installer install
Turso need to install the client extension in your PHP environment.
This script will ask your sudo password to modify your php.ini file:
Are you ok? [y/N]: 


Enter fullscreen mode Exit fullscreen mode

Download and Extract

After all requirements is meet, then installer will download and extract the libSQL Extension for PHP based on Current PHP version that used in your environment and store it at $HOME/.turso-client-php


The extension is required before you used Turso Driver Laravel and Turso Doctrine DBAL

Top comments (0)