README

将 NewRelic PHP Agent API 集成到 Silex 框架。

致谢

最初由 mcuadros 创建。对他辛勤的工作表示感谢。

要求

• PHP 5.3.x
• intouch/newrelic
• newrelic >= 3.1

版本

该项目最近易主。以下更新版本提供了如何要求正确依赖项的信息。

• v0.1.0 - 原始仓库状态使用 NewRelic PHP Agent 旧版本支持的 ini 设置
• v1.0.0 - 移除了 ini 设置，并替换为更直接的 Intouch/NewRelic 库钩子

安装

建议通过 Composer 安装 NewRelic/Silex。您可以在 Packagist 上查看 包信息。

运行 composer require 以获取最新版本

composer require stikmanw/silex-newrelic

方法

• newrelic.custom_parameter ( string $key, $value ): 通过 NewRelic Agent 为请求分配一个自定义参数。详情： NewRelic custom_parameter
• newrelic.custom_metric (string $name, mixed $value): 为通过 NewRelic Agent 捕获的指标分配一个名称和值。详情： NewRelic custom_metric

参数

在数组 $app['newrelic.options'] 中设置所有参数

• application_name (默认 'Silex PHP Application'): 设置应用程序的名称为 name。
• transaction_name_method (默认 'uri'): 如果 'uri' 则使用请求 URI 作为事务名称，如果 'route' 则使用路由的别名。
• transaction_tracer_detail (默认 1): 在 newrelic.transaction_tracer.detail 中检查它 1.0.0 版本不支持
• capture_params (默认 false): 确定是否捕获 NewRelic 文档中指定的请求参数。 newrelic.capture_params
• ignored_params (默认 ''): 在 newrelic.ignored_params 中检查它 1.0.0 版本不支持
• disable_auto_rum (默认 false): 防止输出过滤器尝试为当前事务插入 RUM JavaScript。例如，对 AJAX 调用很有用。
• ignored_transaction（默认为false）：不向代理发送跟踪事务。 自1.0.0版新增 newrelic.ignored_params
• custom_params（默认为空数组）：分配给请求的自定义参数列表，请参阅上面的 custom_params 方法。 自1.0.0版新增
• custom_metrics（默认为空数组）：在注册提供者时设置的自定义指标，请参阅上面的 custom_metrics 方法。 自1.0.0版新增

注册

$app->register(new NewRelic\Silex\NewRelicServiceProvider());
$app['newrelic.options'] = array(
    'application_name' => 'Example PHP Application',
    'transaction_name_method' => 'route'
);

测试

测试在 tests 文件夹中。要运行它们，您需要 PHPUnit。示例

$ phpunit --configuration phpunit.xml.dist

许可协议

MIT，请参阅 LICENSE