Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rollbar/rollbar-php

Error tracking and logging from PHP to Rollbar
https://github.com/rollbar/rollbar-php

codeigniter crash-report crash-reporting error-handler error-handling error-monitoring exceptions laravel observability php rollbar wordpress

Last synced: about 2 months ago
JSON representation

Error tracking and logging from PHP to Rollbar

Awesome Lists containing this project

README

        


rollbar-logo

Rollbar PHP SDK


Proactively discover, predict, and resolve errors in real-time with Rollbar’s error monitoring platform. Start tracking errors today!

[![Latest Version on Packagist](https://img.shields.io/packagist/v/rollbar/rollbar.svg?style=flat-square)](https://packagist.org/packages/rollbar/rollbar)
[![CI for Rollbar-PHP, master](https://github.com/rollbar/rollbar-php/actions/workflows/ci.yml/badge.svg)](https://github.com/rollbar/rollbar-php/actions/workflows/ci.yml)
[![Total Downloads](https://img.shields.io/packagist/dt/rollbar/rollbar.svg?style=flat-square)](https://packagist.org/packages/rollbar/rollbar)

---

## Key benefits of using Rollbar PHP SDK are:
- **Frameworks:** Rollbar php supports many popular php frameworks such as Laravel, CodeIgniter, Symfony and many more!
- **Plugins:** Rollbar php has plugin support for Heroku, Wordpress, Rollbar.js and more.
- **Automatic error grouping:** Rollbar aggregates Occurrences caused by the same error into Items that represent application issues. Learn more about reducing log noise.
- **Advanced search:** Filter items by many different properties. Learn more about search.
- **Customizable notifications:** Rollbar supports several messaging and incident management tools where your team can get notified about errors and important events by real-time alerts. Learn more about Rollbar notifications.

# Quickstart

If you've never used Rollbar before, [sign up for a Rollbar account][signup]
and follow the simple, three-step tour. In no time, you'll be capturing errors
and exceptions thrown in your code.

If you already have a Rollbar account, [log in to your Rollbar account][login].
From the Settings > Project Access Token menu, click Create New Access Token.
Copy the `post_client_item` value and paste it into the code below.

```php
require 'vendor/autoload.php'; // composer require rollbar/rollbar

\Rollbar\Rollbar::init([
'access_token' => '***',
'environment' => 'development',
]);
```

For detailed usage instructions and configuration reference, refer to our
[PHP SDK docs][sdkdoc].

[login]: https://rollbar.com/login/
[sdkdoc]:https://docs.rollbar.com/docs/php
[signup]: https://rollbar.com/signup

# Getting Help

* If you have a question, ask in our [Discussion Q&A][q-a]
* To report a bug, raise [an issue][issue]
* For account service, reach out to [[email protected]][support]

[issue]:https://github.com/rollbar/rollbar-php/issues
[q-a]:https://github.com/rollbar/rollbar-php/discussions/categories/q-a
[support]:mailto:[email protected]

# Releases, Versions, and PHP Compatibility

Major releases of this library support major versions of PHP, as follows:

* For PHP 8, choose the `4.x` or `3.x` branch.
* For PHP 7, choose a `2.x` release.
* For PHP 5, choose a `1.x` release.

To obtain a release, download an archive from the [Releases] page or use
composer:

```sh
# for PHP 8 compatibility
$ composer require rollbar/rollbar:^4
# or
$ composer require rollbar/rollbar:^3

# for PHP 7 compatibility
$ composer require rollbar/rollbar:^2

# for PHP 5 compatibility
$ composer require rollbar/rollbar:^1
```

Refer to [CHANGELOG.md] for a complete history.

[CHANGELOG.md]: ./CHANGELOG.md
[Releases]: https://github.com/rollbar/rollbar-php/releases

# License
Rollbar-PHP is free software released under the MIT License. See [LICENSE]
for details.

[LICENSE]: ./LICENSE