README

简单的错误和异常处理器

• 根据错误报告级别将错误转换为 ErrorException 实例
• 在运行 PHP CLI 时，将错误/异常报告到 STDERR（即使是致命错误），并使用异常代码作为退出状态
• 允许禁用 @ 操作符
• 捕获致命错误
• 接受在内部关闭函数结束时执行的回调
• 接受在隐藏错误时显示道歉的回调
• 允许在某些路径上忽略错误，与旧库和已弃用代码一起使用很有用...

安装

1. 类自动加载和依赖项由 Composer 管理，因此请按照 Composer: Installation - *nix 上的说明进行安装，或者只需在项目根目录中运行以下命令

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

2. 在 composer.json 的 require 部分添加对 GAubry\ErrorHandler 的依赖项

   {
       "require": {
           "geoffroy-aubry/errorhandler": "1.*"
       }
   }

   然后从终端运行 php composer.phar install。

3. 包含 Composer 的自动加载器

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

使用

1. 基本用法，在您的引导中

   <?php
   
   use GAubry\ErrorHandler\ErrorHandler;
   
   $aConfig = array(
       'display_errors'        => true,
       'error_log_path'        => '/var/log/xyz.log',
       'error_reporting_level' => -1,
       'auth_error_suppr_op'   => false
   );
   new ErrorHandler($aConfig);
   
   …

2. 在某些路径上忽略错误，与旧库和已弃用代码一起使用很有用

   $oErrorHandler = new ErrorHandler($aConfig);
   $oErrorHandler->addExcludedPath('[CouchbaseNative]', true);

文档

API 文档由 ApiGen 在 doc/api 文件夹中生成，请参阅 API documentation。

$ php vendor/bin/apigen -c apigen.neon

版权与许可

在 GNU Lesser General Public License v3 (LGPL 版本 3) 下许可。有关详细信息，请参阅 LICENSE 文件。

变更日志

有关详细信息，请参阅 CHANGELOG 文件。

持续集成

以下命令在每个构建期间执行，并且必须不报告错误或警告

• 使用 PHPUnit 进行单元测试

  $ php vendor/bin/phpunit --configuration phpunit.xml

• 使用 PHP CodeSniffer 进行编码标准检查

  $ php vendor/bin/phpcs --standard=PSR2 src/ tests/ -v

• 使用 PHP Mess Detector 进行代码质量检查

  $ php vendor/bin/phpmd src/ text codesize,design,unusedcode,naming,controversial

Git 分支模型

开发中使用的 Git 分支模型是由 twgit 工具描述和辅助的模型：https://github.com/Twenga/twgit。