Symfony

Prerequisites

• You need a Sentry account and project
• Your Symfony application needs to run on PHP 7.2 or later

Install

Install the sentry/sentry-symfony bundle:

composer require sentry/sentry-symfony

composer require sentry/sentry-symfony

If you're already using Monolog, see the Monolog integration docs for Monolog-related configuration.

Configure

Add your DSN to your .env file:

###> sentry/sentry-symfony ###
SENTRY_DSN="___PUBLIC_DSN___"
###< sentry/sentry-symfony ###

###> sentry/sentry-symfony ###
SENTRY_DSN="___PUBLIC_DSN___"
###< sentry/sentry-symfony ###

When using Symfony Flex, the Sentry bundle is configured to be enabled in the prod environment only by default. You can change this behaviour in your config/packages/sentry.yaml and config/bundles.php files.

Verify

To test that Sentry is capturing unhandled exceptions, you can create the following controller:

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Attribute\Route;

class SentryTestController extends AbstractController
{
    #[Route('/_sentry-test', name: 'sentry_test')]
    public function testException()
    {
        throw new \RuntimeException('Example exception.');
    }
}

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Attribute\Route;

class SentryTestController extends AbstractController
{
    #[Route('/_sentry-test', name: 'sentry_test')]
    public function testException()
    {
        throw new \RuntimeException('Example exception.');
    }
}

After you visit the /_sentry-test page, you can view and resolve the recorded error by logging into sentry.io and opening your project.

Next Steps

• Explore practical guides on what to monitor, log, track, and investigate after setup