Download the PHP package aubes/correlation-bundle without Composer

On this page you can find all versions of the php package aubes/correlation-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?

Example code of aubes/correlation-bundle

Informations about the package correlation-bundle

aubes/correlation-bundle

CI Latest Stable Version PHP Version License

Lightweight distributed tracing for Symfony. Propagates a correlation ID across your entire stack (HTTP, HTTP Client, Monolog, Messenger, Mercure, Twig) without the overhead of a full APM solution.

Worker-mode ready: the storage implements ResetInterface and is scoped per request/message. Works out of the box with FrankenPHP worker mode and Messenger workers.

Requirements

Installation

The bundle auto-registers via Symfony Flex.

How it works

The bundle captures or generates a correlation ID at the start of each HTTP request or console command, stores it in a request-scoped storage, and propagates it to all configured integrations.

Core (always active)

HTTP (always active)

Optional integrations

Each integration activates automatically when its dependency is installed, and can be explicitly disabled.

Integration Dependency What it does
HTTP Client symfony/http-client Forwards the correlation ID as a header on outgoing HTTP requests. Any caller-provided correlation header is overwritten (the storage is the single source of truth)
Monolog monolog/monolog Injects the ID into every log record's extra array
Messenger symfony/messenger Stamps the ID on dispatch, restores it on consume
Mercure symfony/mercure-bundle Injects the ID into JSON object payloads
Twig twig/twig Provides a correlation_id() template function

Configuration

All values shown above are defaults. Zero configuration is needed for the common case.

Interfaces

CorrelationIdProviderInterface

Read-only access. Inject this when you only need to read the current ID.

CorrelationIdStorageInterface

Full access: read, write, and reset. Extends CorrelationIdProviderInterface and ResetInterface.

CorrelationIdGeneratorInterface

Extension points

Built-in generators

Generator Format Use case
UuidCorrelationIdGenerator (default) UUID v4/v6/v7 (550e8400-e29b-…) General-purpose correlation
Hex32CorrelationIdGenerator 32-char lowercase hex (a1b2c3d4…) W3C Trace Context / ECS trace.id compatibility

To switch generator:

Custom generator

Implement CorrelationIdGeneratorInterface and reference your service:

Note: the service referenced by generator must implement Aubes\CorrelationBundle\Generator\CorrelationIdGeneratorInterface.

Seed the ID from a custom context

Inject CorrelationIdStorageInterface and call $storage->set($id) before the first downstream read:

Debug

The correlation:debug command displays active integrations, the generator class, and the current correlation ID:

When the Web Profiler is enabled, a correlation ID panel shows the ID source (generated vs provided) and the list of active integrations.

License

MIT

All versions of correlation-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
psr/log Version ^2.0 | ^3.0
symfony/config Version ^6.4 | ^7.4 | ^8.0
symfony/console Version ^6.4 | ^7.4 | ^8.0
symfony/dependency-injection Version ^6.4 | ^7.4 | ^8.0
symfony/http-foundation Version ^6.4 | ^7.4 | ^8.0
symfony/http-kernel Version ^6.4 | ^7.4 | ^8.0
symfony/service-contracts Version ^3.0
symfony/uid Version ^6.4 | ^7.4 | ^8.0
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 aubes/correlation-bundle contains the following files

Loading the files please wait ...