Download the PHP package tracewick/symfony-bundle without Composer

On this page you can find all versions of the php package tracewick/symfony-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package symfony-bundle

Tracewick Symfony Bundle

CI Coverage

[!WARNING] Tracewick Symfony Bundle 0.x is alpha. The public API is not stable until 1.0.0 — expect breaking changes in minor releases. Pin a version and read the changelog before upgrading.

Official Symfony integration for tracewick/tracewick — a PHP sampling profiler on ext-excimer that writes profiles to a local spool (recommended) or optionally to Grafana Pyroscope.

Requirements

PHP 8.2–8.5
Symfony 6.4 / 7.x / 8.x (CI matrix: 6.4, 7.4, 8.1)
Tracewick ^0.2
ext-excimer suggested (fail-open no-op without it)

Symfony 6.4 on PHP 8.1 is not supported (same PHP floor as the core library).

Install

The Flex recipe lives in symfony/recipes-contrib (tracewick/symfony-bundle/0.1). Enable contrib recipes once per app, then require the package:

Flex registers the bundle, copies a minimal config/packages/tracewick.yaml, and appends TRACEWICK_APPLICATION / TRACEWICK_SPOOL_DIR to .env.

Without Flex (or before the contrib recipe is merged), enable the bundle and copy config by hand:

Install the extension separately when you want samples (prefer PIE):

Minimal config (what the recipe installs):

enabled defaults to true, sample_rate to 0.1, sink to spool. Optional keys (label_controller, profile_console, profile_messenger, base_labels, Pyroscope) are documented in the fuller example: config/packages/tracewick.yaml.

What it does

On each main HTTP request the bundle:

  1. Starts a unit-of-work profile early (kernel.request, priority 4096) with route=unmatched and the HTTP method.
  2. After the router (priority 31), sets the route label to the Symfony route name (never the raw URI). Optionally also sets controller when label_controller: true.
  3. On kernel.terminate (priority -4096), stops and flushes to the configured sink.

On each console command (opt-in: profile_console: true):

  1. Starts on console.command (priority 4096) with command=<name> (never argv).
  2. On console.terminate (priority -4096), stops and flushes.

On each consumed Messenger message (opt-in: profile_messenger: true, needs symfony/messenger):

  1. Middleware starts only when the envelope has a ReceivedStamp (worker path), with message=<FQCN> (never the payload). Sync dispatch() inside HTTP is left to the request profile.
  2. Stops and flushes in finally after the rest of the bus stack.

HTTP is profiled by default; console and Messenger stay off until enabled. For messenger:consume, prefer profile_messenger: true. If both flags are on, the console subscriber skips messenger:consume / messenger:consume-messages so the long-lived consumer command does not share one unit of work with every message.

One shared UnitOfWorkProfiler is built per worker process.

Fail-open (runtime): listener/middleware boundaries swallow errors; factory construction failures (including a broken logger or an unknown sink after env resolve) return a no-op profiler so the worker keeps serving. Not fail-open: invalid YAML / config-tree values still fail at container build / cache:warmup — that is intentional so a half-wired profiler never reaches request handling. Missing %env(...)% values also fail when Symfony resolves service arguments, before the factory try/catch.

Inspect this process counters (collected / dropped / delivered / inactive sampler, …):

That command starts a new CLI process, so it shows zeros unless something profiled in that same process. FPM / RoadRunner / messenger:consume counters live in those workers — use HttpProfiler::diagnostics() from app code there, or scrape host metrics from core when configured. Same snapshot API is available as HttpProfiler::diagnostics().

Production path

Put the spool on a local volume or tmpfs. Details: core runtime, drain.

Kill switch

Turn profiling off without a deploy:

Layer How
Bundle tracewick.enabled: false (no subscriber / profiler services)
Core TRACEWICK_DISABLE_FILE — if the path exists, profiling is off
Core TRACEWICK_ENABLED=0 / false / off / no

Core kill switches still apply when the bundle is enabled. See docs/runtime.md.

Without ext-excimer, Tracewick is a no-op (warn once, then idle). The app keeps serving.

Development

License

Apache License 2.0. See NOTICE.


All versions of symfony-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
psr/log Version ^1.1 || ^2.0 || ^3.0
symfony/config Version ^6.4 || ^7.0 || ^8.0
symfony/console Version ^6.4 || ^7.0 || ^8.0
symfony/dependency-injection Version ^6.4 || ^7.0 || ^8.0
symfony/event-dispatcher Version ^6.4 || ^7.0 || ^8.0
symfony/http-kernel Version ^6.4 || ^7.0 || ^8.0
tracewick/tracewick Version ^0.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tracewick/symfony-bundle contains the following files

Loading the files please wait ...