practo/gelf-php

A php implementation to send log-messages to a GELF compatible backend like Graylog2.

Friday, July 17, 2015
by abhinavlal
Repository
4 Watchers
0 Stars
17,312 Installations

PHP
0 Dependents
0 Suggesters
62 Forks
0 Open issues
11 Versions
6 % Grown

The README.md

gelf-php

, _(*1)

A php implementation to send log-files to a gelf compatible backend like Graylog2. This library conforms to the PSR standards in regards to structure (0), coding-style (1, 2) and logging (3)., _(*2)

It's a loosely based on the original Graylog2 gelf-php and mlehner's fork., _(*3)

Stable release and deprecation of the original graylog2/gelf-php

This implementation became the official PHP GELF library on 2013-12-19 and is now released as graylog2/gelf-php v1.0. The old library became deprecated at the same time and it's recommended to upgrade., _(*4)

Since the deprecated library never got a stable release, we decided keep it available as v0.1. This means: If you have a project based on the deprecated library but no time to upgrade to version 1.0, we recommend to change your composer.json as following:, _(*5)

    "require": {
       // ...
       "graylog2/gelf-php": "0.1.*"
       // ...
    }

After running an additional composer update everything should work as expected., _(*6)

Usage

Recommended installation via composer:

Add gelf-php to composer.json:, _(*7)

"require": {
   // ...
   "graylog2/gelf-php": "~1.0"
   // ...
}

Reinstall dependencies: composer install, _(*8)

Examples

For usage examples, go to /examples., _(*9)

License

The library is licensed under the MIT license. For details check out the LICENSE file., _(*10)

Development & Contributing

You are welcome to modify, extend and bugfix all you like. :-) In case you want to use the nifty PhpStorm-IDE, there is an OSS-license for this project, you can use. Just contact me @bzikarsky., _(*11)

Tools

composer, preferably a system-wide installation as composer
PHPUnit
Optional: PHP_CodeSniffer for PSR-X-compatibility checks

Steps

Clone repository and cd into it: git clone git@github.com:bzikarsky/gelf-php && cd gelf-php
Install dependencies: composer install --dev
Run unit-tests: phpunit
Check PSR compatibility: phpcs --standard=PSR src tests

, _(*12)