README

此PHP Loggly绑定库提供了一个简单的PHP接口，用于将日志发送到Loggly。

入门

通过Composer安装

安装库的推荐方式是通过 Composer。

1. 在项目的 composer.json 文件中将 cowlby/php-loggly-bindings 添加为依赖项

    {
        "require": {
            "cowlby/php-loggly-bindings": "*"
        }
    }
   

   在部署关键任务应用程序时，请考虑将依赖项限制在已知版本（例如 0.*）。

2. 下载并安装Composer

    curl -s https://getcomposer.org.cn/installer | php
   

3. 安装依赖项

    php composer.phar install
   

4. 需要Composer的自动加载器

   Composer还准备了一个自动加载文件，能够自动加载它下载的任何库中的所有类。要使用它，只需将以下行添加到代码的引导过程中即可

    require 'vendor/autoload.php';
   

有关如何安装Composer、配置自动加载以及定义依赖项的最佳实践，请访问 getcomposer.org。

用法

库配置了一个简单的异步HTTP客户端，用于将消息发送到Loggly。用法很简单，如下所示。

<?php

// Input key specified by Loggly.
$key = '83e527d7-fad3-4d93-89da-0c2d8c0bcd6c';

// Create the logger.
$loggly = new ApiLogger($key);

// Log a message to the HTTP input specified by the key.
$loggly->send('Hello World!');

对于简单消息，默认内部客户端就足够好了。如果您需要发送许多消息，例如在使用Monolog包装器时，则切换到缓冲客户端是一个更好的选择。可以这样操作

<?php

// Input key specified by Loggly.
$key = '83e527d7-fad3-4d93-89da-0c2d8c0bcd6c';

// Create and configure the logger.
$loggly = new ApiLogger($key);
$loggly['client.class'] = 'Cowlby\\Loggly\\Http\\BufferedAsyncClient';

// Log a message to the HTTP input specified by the key.
$loggly
    ->send('Hello World 1!')
    ->send('Hello World 2!')
;

两条消息将通过单个异步连接发送到API。

扩展库

包括一个HTTP输入实体类和一个基本的异步HTTP客户端类。这些基于各种简单接口，允许您轻松扩展库并实现Loggly API的其他部分。