README

AppNeta\TraceViewBundle 扩展包为 AppNeta TraceView 提供有关 Symfony2 组件的额外信息。它目前支持

• 报告控制器和操作
• 追踪内核事件作为层级
• 追踪其他事件监听器作为配置文件

安装

首先，您需要使用 Composer 将 TraceViewBundle 作为您的应用程序依赖之一拉入。您可以使用 composer require，或者在您的 composer.json 文件中修改 "require" 部分，包括该包

    "require": {
        "php": ">=5.3.3",
        "symfony/symfony": "~2.4",
        "doctrine/orm": "~2.2,>=2.2.3",
        "doctrine/doctrine-bundle": "~1.2",
        "twig/extensions": "~1.0",
        [...]
        "appneta/traceview-bundle": "master@dev" # Or whatever version you prefer.
        [...]
    },

如果您直接从 GitHub 安装，而不是从 Packagist 安装，您可以在 composer.json 中添加额外的存储库到 repositories 的顶层键，如下所示

    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/appneta/AppNetaTraceViewBundle"
        }
    ]

使用 Composer 拉入包后，您需要使它对您的应用程序可用。将其添加到 app/AppKernel.php，如下所示

    public function registerBundles()
    {
        $bundles = array(
            new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
            new Symfony\Bundle\SecurityBundle\SecurityBundle(),
            new Symfony\Bundle\TwigBundle\TwigBundle(),
            [...]
            new AppNeta\TraceViewBundle\TraceViewBundle(),
            [...]
        );

        return $bundles;
    }

为了启用控制器/操作和事件监听器追踪，将此部分添加到您的 config.yml

parameters:
  event_dispatcher.class: AppNeta\TraceViewBundle\EventDispatcher\TraceViewContainerAwareEventDispatcher

已知问题

• 对于长或多个控制器，控制器/操作名称报告更友好
• 当前事件调度器替换与 Symfony 调试工具栏冲突
• 用户可配置的设置，用于指定要跟踪的白名单/黑名单事件

贡献

改进此扩展包的最佳方法是与使用它的人合作！我们积极鼓励补丁、拉取请求、功能请求和错误报告。当前目标包括与 Symfony 开发者工具栏集成以及在可能的情况下进行性能或架构改进。