PHP

On this page, we get you up and running with Sentry's PHP SDK, automatically reporting errors and exceptions in your application.

If you don't already have an account and Sentry project established, head over to sentry.io, then return to this page.

Using a framework? Check out the other SDKs we support in the left-hand dropdown.

Related Guides

This Sentry PHP SDK provides support for PHP 7.2 or later. If you are using our previous PHP SDK, you can access the legacy SDK documentation, until further notice.

Sentry captures data by using an SDK within your application’s runtime. These are platform-specific and allow Sentry to have a deep understanding of how your application works.

Install the SDK using Composer.

Copied
composer require sentry/sentry

Install the Excimer extension via PECL:

Copied
pecl install excimer

The Excimer PHP extension supports PHP 7.2 and up. Excimer requires Linux or macOS and doesn't support Windows. For additional ways to install Excimer, see docs.

To capture all errors, even the one during the startup of your application, you should initialize the Sentry PHP SDK as soon as possible.

Copied
\Sentry\init([
  'dsn' => 'https://examplePublicKey@o0.ingest.sentry.io/0' ,
  // Specify a fixed sample rate
  'traces_sample_rate' => 1.0,
  // Set a sampling rate for profiling - this is relative to traces_sample_rate
  'profiles_sample_rate' => 1.0,
]);

In PHP you can either capture a caught exception or capture the last error with captureLastError.

Copied
try {
  $this->functionFailsForSure();
} catch (\Throwable $exception) {
  \Sentry\captureException($exception);
}
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").