aeatech/web-snapshot-profiler-xhprof-bundle

Web snapshot profiler xhprof bundle for symfony (production ready)

1.0.1 2025-12-23 11:58 UTC

Requires

• php: >=8.2
• ext-xhprof: *
• aeatech/snapshot-profiler-xhprof: ^1.0
• aeatech/web-snapshot-profiler-event-subscriber: ^1.0
• symfony/framework-bundle: ^6.4 || ^7.4
• symfony/yaml: ^6.4 || ^7.4

Requires (Dev)

• mockery/mockery: ^1.6
• nyholm/symfony-bundle-test: ^3.1
• phpunit/phpunit: ^11.5
• roave/security-advisories: dev-master
• symfony/test-pack: ^1.2

MIT

• web
• bundle
• snapshot
• profiler
• xhprof
• aeatech

README

The package contains symfony bundle to profile web applications with xhprof. It can be used for production profiling.

System requirements:

• PHP >= 8.2
• ext-xhprof
• xhgui (tested on xhgui/xhgui:0.22.1)

Installation (Composer):

composer require aeatech/web-snapshot-profiler-xhprof-bundle

Auto installation

You can install it with custom recipe.

composer config extra.symfony.allow-contrib true
composer config --json --merge extra.symfony.endpoint '["https://api.github.com/repos/AEATech/recipes/contents/index.json?ref=main", "flex://defaults"]'
composer require aeatech/web-snapshot-profiler-xhprof-bundle

Manual installation

Enable bundle in dev and prod env.

// config/bundles.php

return [
    // ...
    AEATech\WebSnapshotProfilerXhprofBundle\AEATechWebSnapshotProfilerXhprofBundle::class => ['dev' => true, 'prod' => true],
    // ...
];

Configuration

Symfony Flex generates a default configuration in config/packages/aea_tech_web_snapshot_profiler_xhprof.yaml

aea_tech_web_snapshot_profiler_xhprof:
    # Enable/Disable profiling
    is_profiling_enabled: false

    # Application info for snapshot naming
    app_version: '0.0.1'

    # XHGUI configuration
    xhgui:
        import_uri: '%env(string:AEA_TECH_WEB_SNAPSHOT_PROFILER_XHPROF_XHGUI)%'
        import_timeout: 1

    ###
    # xhprof configuration
    # - collect internal functions info
    # - collect memory allocation info
    ###
    xhprof:
        collect_additional_info: '1'
        flags:
            - !php/const Xhgui\Profiler\ProfilingFlags::MEMORY

    ###
    # Event matched configuration - START
    ###
    event_matcher:
        # Enable/Disable all routes profiling
        is_profile_all_routes: false

        # Enable profile if header was set (\AEATech\WebSnapshotProfilerEventSubscriber\EventMatcher\HeaderEventMatcher)
        header:
            is_enabled: false
            name: 'x-profiling-header'
            value: '1'

        # Enable profile if request param was set and route matched (\AEATech\WebSnapshotProfilerEventSubscriber\EventMatcher\RequestParamAwareRouteEventMatcher)
        request:
            is_enabled: false
            name: 'x-profile-request-param'
            route_to_probability:
                # 1% probability to profile route
                -
                    route_name: 'app_route_name_1'
                    probability: 1
                # 100% probability to profile route
                -
                    route_name: 'app_route_name_2'
                    probability: 100

        # Enabled profile if route matched and probability happened
        route:
            is_enabled: false
            route_to_probability:
                # 1% probability to profile route
                -
                    route_name: 'app_route_name_1'
                    probability: 1
                # 100% probability to profile route
                -
                    route_name: 'app_route_name_2'
                    probability: 100
    ###
    # Event matched configuration - END
    ###

License

MIT License. See LICENSE for details.