# Rollbar for Laravel

[![Latest Version on Packagist](https://img.shields.io/packagist/v/rollbar/rollbar-laravel.svg?style=flat-square)](https://packagist.org/packages/rollbar/rollbar-laravel)
![Build Status](https://github.com/rollbar/rollbar-php-laravel/workflows/Rollbar-PHP-Laravel%20CI/badge.svg)
[![Total Downloads](https://img.shields.io/packagist/dt/rollbar/rollbar-laravel.svg?style=flat-square)](https://packagist.org/packages/rollbar/rollbar-laravel)

Rollbar error monitoring integration for Laravel projects. This library adds a listener to Laravel's logging component. Laravel's session information will be sent in to Rollbar, as well as some other helpful information such as 'environment', 'server', and 'session'.

## Setup Instructions

1. [Sign up for a Rollbar account](https://rollbar.com/signup)
2. If you're using Laravel 5.6 and up follow [Installation](https://docs.rollbar.com/docs/laravel#section-installation) instructions in our [Laravel 5.6 and up SDK docs](https://docs.rollbar.com/docs/laravel)
3. If you're using Laravel 5.5 or lower follow [Installation](https://docs.rollbar.com/v1.0.0/docs/laravel-55) instructions in our [Laravel 5.5 and lower SDK docs](https://docs.rollbar.com/v1.0.0/docs/laravel-55)

## Usage and Reference

For complete usage instructions and configuration reference, see our [Laravel SDK docs](https://docs.rollbar.com/docs/laravel).
  
## Release History & Changelog

See our [Releases](https://github.com/rollbar/rollbar-php-laravel/releases) page for a list of all releases, including changes.

### Laravel 5.5 and below
Laravel 5.6 now requires PHP >= 7.1. As of `rollbar/rollbar-php-laravel:v3.0.0` and up master also supports 5.6.

We still maintain support for Laravel 5.5 and below on branch `laravel-5.5` and releases in the `2.x.x` major.

## Related projects

This project is a Laravel wrapper of Rollbar PHP: [Rollbar PHP](https://github.com/rollbar/rollbar-php)

A CakePHP-specific package is avaliable for integrating Rollbar PHP with CakePHP 2.x:
[CakeRollbar](https://github.com/tranfuga25s/CakeRollbar)

A Flow-specific package is available for integrating Rollbar PHP with Neos Flow: [m12/flow-rollbar](https://packagist.org/packages/m12/flow-rollbar)

Yii package: [baibaratsky/yii-rollbar](https://github.com/baibaratsky/yii-rollbar)

Yii2 package: [baibaratsky/yii2-rollbar](https://github.com/baibaratsky/yii2-rollbar)

## Help / Support

If you run into any issues, please email us at [support@rollbar.com](mailto:support@rollbar.com)

For bug reports, please [open an issue on GitHub](https://github.com/rollbar/rollbar-php/issues/new).


## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request


## Testing
Tests are in `tests`.
* To run the tests: `composer test`
* To fix code style issues: `composer fix`

## Docker
Docker binaries are located in `./bin` and can be run by simply executing `bin/phpunit` for example.
* To run tests: `bin/phpunit`
* To run code sniffer: `bin/phpcs` or `bin/phpcbf`
* To run all supported versions: `bin/phpunit-versions`
* To run composer : `bin/composer install` OR `bin/composer update`