90 lines
1.4 KiB
Markdown
90 lines
1.4 KiB
Markdown
|
# Fluent Logger PHP
|
||
|
|
|
||
|
|
**fluent-logger-php** is a PHP library to record events to fluentd from a PHP application.
|
||
|
|
|
||
|
|
[](http://travis-ci.org/fluent/fluent-logger-php)
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
- PHP 5.3 or higher
|
||
|
|
- fluentd v0.9.20 or higher
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
### Using Composer
|
||
|
|
|
||
|
|
composer.json
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"require": {
|
||
|
|
"fluent/logger": "v1.0.0"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
# Backward Compatibility Changes
|
||
|
|
|
||
|
|
As of v1, all loggers but `FluentLogger` are removed.
|
||
|
|
|
||
|
|
[Monolog](https://github.com/Seldaek/monolog) is recommended in such use cases.
|
||
|
|
|
||
|
|
# Usage
|
||
|
|
|
||
|
|
## PHP side
|
||
|
|
|
||
|
|
```php
|
||
|
|
<?php
|
||
|
|
|
||
|
|
require_once __DIR__.'/vendor/autoload.php';
|
||
|
|
|
||
|
|
use Fluent\Logger\FluentLogger;
|
||
|
|
$logger = new FluentLogger("localhost","24224");
|
||
|
|
$logger->post("debug.test",array("hello"=>"world"));
|
||
|
|
```
|
||
|
|
|
||
|
|
## Fluentd side
|
||
|
|
|
||
|
|
Use `in_forward`.
|
||
|
|
|
||
|
|
```aconf
|
||
|
|
<source>
|
||
|
|
@type forward
|
||
|
|
</source>
|
||
|
|
```
|
||
|
|
|
||
|
|
# Todos
|
||
|
|
|
||
|
|
* Stabilize method signatures.
|
||
|
|
* Improve performance and reliability.
|
||
|
|
|
||
|
|
# Restrictions
|
||
|
|
|
||
|
|
* Buffering and re-send support
|
||
|
|
|
||
|
|
PHP does not have threads. So, I strongaly recommend you use fluentd as a local fluent proxy.
|
||
|
|
|
||
|
|
````
|
||
|
|
apache2(mod_php)
|
||
|
|
fluent-logger-php
|
||
|
|
`-----proxy-fluentd
|
||
|
|
`------aggregator fluentd
|
||
|
|
````
|
||
|
|
|
||
|
|
# License
|
||
|
|
Apache License, Version 2.0
|
||
|
|
|
||
|
|
|
||
|
|
# Contributors
|
||
|
|
|
||
|
|
* Daniele Alessandri
|
||
|
|
* Hiro Yoshikawa
|
||
|
|
* Kazuki Ohta
|
||
|
|
* Shuhei Tanuma
|
||
|
|
* Sotaro KARASAWA
|
||
|
|
* edy
|
||
|
|
* kiyoto
|
||
|
|
* sasezaki
|
||
|
|
* satokoma
|
||
|
|
* DQNEO
|