ntanduy/cloudflare-d1-database

Easy configuration and setup for D1 Database connections in Laravel.

v0.2.0 2024-11-05 05:59 UTC

Requires

• php: ^8.2
• doctrine/dbal: ^3.0|^4.0
• illuminate/cache: *
• illuminate/contracts: *
• illuminate/database: *
• illuminate/http: *
• saloonphp/laravel-http-sender: ^2.0|^3.0
• saloonphp/laravel-plugin: ^3.5
• saloonphp/saloon: ^3.10

Requires (Dev)

• laravel/legacy-factories: ^1.4
• mockery/mockery: ^1.6
• orchestra/testbench: ^9.3
• pestphp/pest: ^2.35

Suggests

• ext-pdo: Extending the PDO driver for Cloudflare D1 is requireds.

MIT

• TanDuy03

• database
• laravel
• cloudflare
• d1
• TanDuy03

README

Integrate Cloudflare bindings into your PHP/Laravel application.

This package offers support for:

• Cloudflare D1

🚀 Installation

composer require ntanduy/cloudflare-d1-database

👏 Usage

Integrate Cloudflare D1 with Laravel

Add a new connection in your config/database.php file:

'connections' => [
    'd1' => [
        'driver' => 'd1',
        'prefix' => '',
        'database' => env('CLOUDFLARE_D1_DATABASE_ID', ''),
        'api' => 'https://api.cloudflare.com/client/v4',
        'auth' => [
            'token' => env('CLOUDFLARE_TOKEN', ''),
            'account_id' => env('CLOUDFLARE_ACCOUNT_ID', ''),
        ],
    ],
]

Next, configure your Cloudflare credentials in the .env file:

CLOUDFLARE_TOKEN=
CLOUDFLARE_ACCOUNT_ID=
CLOUDFLARE_D1_DATABASE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

The d1 driver will forward PDO queries to the Cloudflare D1 API to execute them.

🌱 Testing

Start the built-in Worker to simulate the Cloudflare API:

cd tests/worker
npm ci
npm run start

In a separate terminal, run the tests:

vendor/bin/phpunit

🤝 Contributing

Please see CONTRIBUTING for details.

🔒 Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

🎉 Credits

• TanDuy03
• All Contributors