Download the PHP package tonijz/raven without Composer
On this page you can find all versions of the php package tonijz/raven. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package raven
Short Description Raven client for Sentry that supports background processing through multiple providers.
License
Homepage https://github.com/rcrowe/Raven
Informations about the package raven
Raven
Raven is a client for recording and transmitting messages to Sentry.
Its special sauce is that it can transmit those messages to Sentry in the background. No more slow down while a HTTP request is made!
Installation
Add rcrowe\raven
as a requirement to composer.json:
Update your packages with composer update
or install with composer install
.
Usage
This library exposes the same API for recording your messages as the official raven-php client. It should just be a case of
replacing Raven_Client
with rcrowe\Raven\Client
. For usage of recording messages checkout out raven-php.
To record a message and transmit it to Sentry straight away (the default):
Handlers
Handlers are responsible for taking a new captured raven message and putting into a background queue. If no handler is registered with the raven client the message is transmitted straight away.
A handler can be added to the client as follows:
Sync Handler
(Default) Like raven-php new messages are transmitted straight away.
Laravel Handler
If using within a Laravel project, makes use of the illuminate\queue
API. For improved Laravel intergration checkout the Laravel provider below.
Resque Handler
TODO
- Will be based around https://github.com/chrisboulton/php-resque
Transports
Transports are responsible for sending the message to the Sentry API. Transports are always the first parameter passed into a handler. If no transport is provided it will default to HTTP.
Dummy
Dummy transport does absolutely nothing. Nothing is transmitted to the API. You may not want to transmit to any messages when working in a dev environment.
HTTP
(Default) Transmit the message over HTTP. To do this we make use of the great HTTP client Guzzle.
As this is the default transport mechanism there is no need to pass it into the handler. The above call is the same as:
UDP
TODO
Providers
Providers offer painless integration to other libraries / frameworks.
Laravel
Installation
Raven needs to know your client DSN. First publish the Raven config file with the following command:
Then edit app/config/packages/rcrowe/raven/config.php
Now add the RavenServiceProvider to app/config/app.php
:
Make sure app/config/queue.php
is setup with how you want to connect to your background queue. For further information on working
with queues in Laravel checkout their docs.
Usage
Now where ever you want to record a message just use the normal Log facade.