/rollbar-php

Error tracking and logging from PHP to Rollbar

Primary LanguagePHPMIT LicenseMIT

Rollbar-PHP Build Status

This library detects errors and exceptions in your application and reports them to Rollbar for alerts, reporting, and analysis.

Supported PHP versions: 5.3, 5.4, 5.5, 5.6, 7, 7.1, 7.2, 7.3, 7.4 Supported HHVM versions: 3.6, 3.18, 3.21, 3.24, 3.27

Setup Instructions

  1. Sign up for a Rollbar account
  2. Follow the Quick Start instructions in our PHP SDK docs to install rollbar-php and configure it for your platform.

Usage and Reference

For complete usage instructions and configuration reference, see our PHP SDK docs.

Release History & Changelog

See our Releases page for a list of all releases, including changes.

Related projects

A range of examples of using Rollbar PHP is available here: Rollbar PHP Examples.

A Wordpress Plugin is available through Wordpress Admin Panel or through Wordpress Plugin directory: Rollbar Wordpress

A Laravel-specific package is available for integrating with Laravel: Rollbar Laravel

A CakePHP-specific package is avaliable for integrating with CakePHP 2.x: CakeRollbar

A Flow-specific package is available for integrating with Neos Flow: m12/flow-rollbar

Yii package: baibaratsky/yii-rollbar

Yii2 package: baibaratsky/yii2-rollbar

Help / Support

If you run into any issues, please email us at support@rollbar.com

For bug reports, please open an issue on GitHub.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (See Conventional Commits below)
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Conventional Commits

This repository follows the Conventional Commits guidelines. Commit messages should include a prefix describing the commit before the short description. Recognized prefixes include: feat, fix, doc, style, refactor, perf, test, build, chore, revert. Breaking changes should include 'BREAKING CHANGE'.

Example:

git commit -m 'feat(bars): add foo support for all bars

fix #123
BREAKING CHANGE: bars supporting foo break bars supporting qwerty'

Optionally, you can use commitizen to format your commit messages.

npm install -g commitizen
npm install -g cz-conventional-changelog
echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

And then commit using git cz. You'll be prompted for information describing your commit.

Testing

Tests are in tests. To run the tests: composer test To fix code style issues: composer fix

Tagging

  1. ROLLBAR_PHP_TAG=[version number]
  2. git checkout master
  3. Update version numbers in src/Payload/Notifier.php and tests/NotifierTest.php.
  4. git add .
  5. git commit -m"Bump version numbers".
  6. git push origin master
  7. git tag v$ROLLBAR_PHP_TAG
  8. git push --tags

License

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