bella-baxter/laravel

Laravel integration for the Bella Baxter secret management platform

v0.1.1-beta.30 2026-03-27 11:23 UTC

Requires

• php: ^8.1
• bella-baxter/sdk: 0.1.1-beta.30
• illuminate/contracts: ^10.0 || ^11.0
• illuminate/support: ^10.0 || ^11.0

Requires (Dev)

• orchestra/testbench: ^8.0 || ^9.0
• phpunit/phpunit: ^10.0

MIT

• laravel
• secrets
• vault
• secret-management
• bella-baxter

README

Laravel integration for the Bella Baxter secret management platform.

Automatically loads your Bella Baxter secrets into Laravel's environment at boot — secrets are available everywhere via env(), config(), and $_ENV.

Installation

composer require bella-baxter/laravel

The BellaServiceProvider is auto-discovered by Laravel (no manual registration needed).

Configuration

Publish the config file:

php artisan vendor:publish --tag=bella-config

Set environment variables (or edit config/bella.php):

BELLA_BAXTER_URL=https://api.bella-baxter.io
BELLA_BAXTER_API_KEY=bax-your-api-key
BELLA_BAXTER_AUTO_LOAD=true

Usage

Auto-load (default)

With auto_load: true (the default), all secrets are injected into $_ENV and putenv() at boot:

// In any controller, service, or config file:
$dbUrl = env('DATABASE_URL');         // from Bella Baxter
$apiKey = env('STRIPE_API_KEY');      // from Bella Baxter

Facade

use BellaBaxter\Laravel\Facades\Bella;

$secrets = Bella::getAllSecrets();   // array<string, string>
$value   = Bella::getSecret('DATABASE_URL');

Dependency Injection

use BellaBaxter\BaxterClient;

class MyService
{
    public function __construct(private BaxterClient $bella) {}

    public function doSomething(): void
    {
        $secrets = $this->bella->getAllSecrets();
    }
}

Configuration Reference

Key	Env var	Default	Description
url	BELLA_BAXTER_URL	https://api.bella-baxter.io	Base URL of the Baxter API
api_key	BELLA_BAXTER_API_KEY	''	API key from bella apikeys create
auto_load	BELLA_BAXTER_AUTO_LOAD	true	Load secrets into $_ENV at boot

Manual registration (Laravel 10 or explicit)

If auto-discovery is disabled, add to config/app.php:

'providers' => [
    // ...
    BellaBaxter\Laravel\BellaServiceProvider::class,
],
'aliases' => [
    // ...
    'Bella' => BellaBaxter\Laravel\Facades\Bella::class,
],

Or in bootstrap/providers.php (Laravel 11+):

return [
    // ...
    BellaBaxter\Laravel\BellaServiceProvider::class,
];