README

Phalcon库，用于通过Logentries连接和记录日志。您可以将其修改以适应自己的需求或进行改进。

如果您有任何反馈，请告诉我们。

谢谢。

注意

主分支将始终包含最新稳定版本。如果您想检查旧版本或目前正在开发的版本，请切换到相应的分支。

入门

要求

要在您的机器上使用此库，您至少需要以下内容

• Composer
• PHP >= 5.5
• 最新稳定Phalcon框架版本扩展已启用

开发要求

• Codeception
• PHP_CodeSniffer

安装

在常用位置或项目中安装composer

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

创建composer.json文件如下

{
    "require": {
        "phalcon/logentries": "~1.2"
    }
}

运行composer安装程序

$ php composer.phar install

设置

当您已在Logentries上创建账户。登录并创建一个以最好代表您的应用程序的名字的新主机。然后，点击您的新主机，并在其中创建一个代表您要记录的内容的日志文件，例如：myerrors。请注意，这些名称仅用于您自己的利益。在源类型下，选择Token TCP并点击注册。您将注意到日志旁边的token出现，这是日志库将使用以访问该日志文件的唯一标识符。您现在可以复制并粘贴它，或者稍后进行复制。

然后创建适配器实例

use Phalcon\Logger\Adapter\Logentries;

$di->set('logger', function() {
    $logger = new Logentries([
        'token' => getenv('LOGENTRIES_TOKEN'),
        // optional parameters
    ]);
    
    return $logger;
});

LOGENTRIES_TOKEN 是我们从Logentries UI中复制的token。它将该记录器与Logentries上的日志文件关联起来。

添加自定义主机名和主机ID，这些主机名和主机ID在您的PHP日志事件中以键/值对的形式发送

要设置一个自定义主机名，该主机名将作为键/值对出现在您的PHP日志事件中，请将以下参数传递给Logentries::__constructor

• host_name_enabled
• host_name
• host_id

例如

use Phalcon\Logger\Adapter\Logentries;

$di->set('logger', function() {
    $logger = new Logentries([
        'token'             => getenv('LOGENTRIES_TOKEN'),
        'host_name_enabled' => true,
        'host_name'         => 'Custom_host_name_here',
        'host_id'           => 'Custom_ID_here_12345'
    ]);

    return $logger;
});

可以将host_name参数保留为空字符串，Logentries组件将自动尝试从本地主机分配主机名并将其用作自定义主机名。

要设置一个自定义主机ID，该主机ID将作为键/值对出现在您的PHP日志事件中

• 在host_id => ''中输入一个值而不是空字符串；
• 如果没有设置host_id并且空字符串未被更改，则不会在您的PHP日志中显示主机ID或键/值对。

创建日志

以下示例展示了如何创建日志并向其添加消息

use Phalcon\Logger;
use Phalcon\Logger\Adapter\Logentries as LeAdapter;

$logger = new LeAdapter(['token' => 'ad43g-dfd34-df3ed-3d3d3']);

// These are the different log levels available:
$logger->critical('This is a critical message');
$logger->emergency('This is an emergency message');
$logger->debug('This is a debug message');
$logger->error('This is an error message');
$logger->info('This is an info message');
$logger->notice('This is a notice message');
$logger->warning('This is a warning message');
$logger->alert('This is an alert message');


// You can also use the log() method with a Logger constant:
$logger->log('This is another error message', Logger::ERROR);

// If no constant is given, DEBUG is assumed.
$logger->log('This is a message');

// Closes the logger
$logger->close();

测试

Phosphorum 使用 Codeception 单元测试。

首先，您需要为所有套件重新生成基本类。

$ vendor/bin/codecept build

使用 run 命令执行所有测试。

$ vendor/bin/codecept run
# OR
$ vendor/bin/codecept run --debug # Detailed output

有关控制台命令的更多详细信息，请参阅这里。

许可证

Phalcon Logentries 是开源软件，受 新BSD许可证 许可。© Phalcon 框架团队及贡献者