Symfony with AllStak

Installation

Install via Composer (requires PHP >= 8.1, Symfony 6.4 or 7.x).

composer require allstak/sdk-symfony

Configuration

Symfony Flex auto-registers the bundle. Set one environment variable; an optional config file customizes integrations.

# .env
ALLSTAK_API_KEY=allstak_live_xxxxxxxx

# optional: config/packages/allstak.yaml
allstak:
    api_key: '%env(ALLSTAK_API_KEY)%'
    environment: '%kernel.environment%'
    service: 'my-symfony-app'
    integrations:
        kernel: true
        doctrine: true
        http_client: true
        messenger: true

Basic example

Without Flex, register the bundle in config/bundles.php.

return [
    // ...
    AllStak\SymfonyBundle\AllStakBundle::class => ['all' => true],
];

Capturing errors

Unhandled exceptions are captured automatically. Inject the AllStak service to capture handled ones.

use AllStak\AllStak;

final class CheckoutController
{
    public function __construct(private AllStak $allstak) {}

    public function pay(): Response
    {
        try {
            // ...
        } catch (\Throwable $e) {
            $this->allstak->captureError($e);
            throw $e;
        }
    }
}

Tracking requests

The kernel integration opens an http.server span per request, records an inbound HTTP request, and captures exceptions with request context — buffers drain on kernel.terminate. Doctrine queries and outbound HttpClient calls are also captured automatically when their integrations are enabled.

Best practices

• Keep ALLSTAK_API_KEY in .env; the bundle is a safe no-op when it's empty.
• Toggle integrations (kernel/doctrine/http_client/messenger/monolog) in the config.
• Set service and release for clearer grouping.