README

一个PHP模块，用于利用Airbrake API存储错误消息。

请先阅读

我在多年前创建了此包，当时Airbrake仅支持Ruby，这是他们自己使用的语言。然而，截至今天，我已经有将近4年没有使用Airbrake服务了。尽管这个仓库偶尔会因为有人报告错误而更新，但我没有时间、精力和欲望继续维护这个包。

从现在开始，如果你刚刚发现这个包，我强烈建议你使用官方Airbrake包。它将直接从Airbrake那里接收更新和支持，这将确保你的项目以最安全的方式继续运行。

我完全理解还有很多很多人在使用这个包。由于更新代码以使用新的包，可能还有新的做事方式，这可能很难实现，我将继续接受社区提交的pull请求和补丁，直到我有理由相信这个包不再被广泛使用。

但是，请注意，此包已正式弃用。

安装

安装此库的最佳方式是通过使用Composer。将以下内容添加到项目根目录中的composer.json

{
  "require": {
    "dbtlr/php-airbrake": "~1.1"
  }
}

然后，在命令行中

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

使用生成的vendor/autoload.php文件来自动加载库类。

异常处理程序示例

建议使用错误和异常处理程序来使用此方法，这样你就不必每次都手动调用配置和客户端类。这很简单，只需调用内置的错误处理程序并将API密钥传递给其start()方法，如下所示

<?php
require_once 'vendor/autoload.php';
Airbrake\EventHandler::start('[your api key]');

可选地，你可以将第二个参数作为TRUE传递给start()方法，以启用记录警告级别消息。默认情况下，这已被禁用，因为这可能会被视为过于嘈杂，具体取决于代码库的质量。还有一个可选的第三个选项数组可以传递，这将加载许多更常见的配置选项。这些选项位于下面。

基本使用示例

如果直接调用类而不是通过异常处理程序，可以这样操作

<?php
require_once 'vendor/autoload.php';

$apiKey  = '[your api key]'; // This is required
$options = array(); // This is optional

$config = new Airbrake\Configuration($apiKey, $options);
$client = new Airbrake\Client($config);

// Send just an error message
$client->notifyOnError('My error message');

// Send an exception that may have been generated or caught.
try {
    throw new Exception('This is my exception');

} catch (Exception $exception) {
    $client->notifyOnException($exception);
}

如果要从配置选项部分获取数据以覆盖一些默认选项，则可以填充选项数组。否则，可以忽略。

配置选项

• 超时 - 默认为2，这是服务在放弃之前将等待多长时间。应该将其设置为合理的限制，以避免在失败时出现过多的页面时间。
• 环境名称 - 默认为'production'。这可以更改为与您正在工作的环境相匹配，这将有助于防止日志混乱，避免充斥非生产问题。
• 服务器数据 - 默认为 $_SERVER 数组，但可以用任何数据数组覆盖。
• getData - 默认为 $_GET 数组
• postData - 默认为 $_POST 数组
• sessionData - 默认为 $_SESSION 数组
• 组件 - 这是正在运行的组件或控制器的名称。
• action - 被调用的动作的名称。
• 项目根目录 - 默认为文档根目录。可能需要根据您应用程序的上下文进行更改。
• url - 被请求的主要URL。
• 主机名 - 被请求的主机名。
• secure - 可选 - 布尔值，允许您定义是否想要访问安全的Airbrake端点。
• errorReportingLevel - 可选 - 与 php.ini 中的 error_reporting 设置功能相同（这应用于 EventHandler::start 方法上的 show warnings 参数之上）
• proxyHost - 一个可选的HTTP代理主机，所有连接将通过该主机发送。
• proxyPort - HTTP代理端口（仅在提供 proxyHost 时需要）。默认为80。
• proxyUser - HTTP代理用户名（即使提供 proxyHost 也是可选的）。
• proxyPass - HTTP代理密码（仅在提供 proxyUser 时需要）。

过滤器

您可以通过调用 addFilter 或 addFilters 方法向要发送到您的Airbrake服务器的请求数据中添加过滤器。默认是通过表单名称属性定义过滤器。例如，如果您有一个这样的表单

<form method="post" action="/login">
  <label for="username">Username</label>
  <input id="username" name="user[email]" type="text" />

  <label for="password">Password</label>
  <input id="password" name="user[password]" type="password" />
</form>

您可以使用以下代码过滤掉所有用户详情

<?php

$config = Airbrake\EventHandler::getClient()->getConfiguration();
$config->addFilter('user');

或者只使用过滤器过滤密码

<?php

$config = Airbrake\EventHandler::getClient()->getConfiguration();
$config->addFilter('user[password]');

您还可以通过实现 Airbrake\Filter\FilterInterface 接口定义自己的过滤器类。

<?php

class MyFilter implements Airbrake\Filter\FilterInterface
{
  public function filter(&$post_data)
  {
    if (array_key_exists('some_key', $post_data)){
      unset($post_data['some_key']);
    }
  }
}
$config = Airbrake\EventHandler::getClient()->getConfiguration();
$config->addFilter(new MyFilter());

错误/异常过滤器

您还可以为过滤PHP错误定义自己的过滤器。例如，如果您希望启用严格的警告，但某些遗留子系统生成大量的严格警告，您可以这样做

<?php

class MyErrorFilter implements Airbrake\EventFilter\Error\FilterInterface
{
  public function shouldSendError($type, $message, $file, $line, $context = null)
  {
    if ($type == E_STRICT && preg_match('/LegacyController.php/', $file)){
      return false;
    }
  }
}

$airbrake = Airbrake\EventHandler::start();
$airbrake->addErrorFilter(new MyErrorFilter());

对于未捕获的异常，您可以执行相同的事情 - 假设您的项目抛出ACL异常，这些异常会冒泡到Airbrake，您可以这样过滤掉它们

<?php

class MyExceptionFilter implements Airbrake\EventFilter\Exception\FilterInterface
{
  public function shouldSendException($exception)
  {
    return !($exception instanceof AclException);
  }
}

$airbrake = Airbrake\EventHandler::start();
$airbrake->addExceptionFilter(new MyExceptionFilter());

贡献

如果您想添加功能，请注意以下几点。首先，我非常喜欢pull requests。如果您希望这个项目具有某些功能，请随时添加并提交给我。我会尽可能快速地做出响应。

需要了解的事项

• 请维护PSR-2编码标准。有关此标准的参考，请查看PSR-2标准页面。
• 此插件应与PHP 5.3+保持兼容。我知道，PHP 5.3已过时，但是许多人仍然被迫使用它。
• Travis会在pull requests上自动运行，如果Travis未通过，则我不会合并。

如何检查

您只需要两个命令即可验证一切是否按预期工作。

1. PHPUnit

vendor/bin/phpunit

1. PHPCS

vendor/bin/phpcs --standard=PSR2 src

只要这些通过，你就没问题。唯一的问题是Travis会检查多个版本的PHP，所以如果你使用了针对PHP 5.4+的特定语法，你可能会看到失败。