Feature: Add request context providers for long-lived runtimes

[glensc]

Summary

• Add a request-context abstraction and provider hook so profiler metadata is captured at request start instead of shutdown
• Keep the current behavior via a default provider while allowing custom integrations to supply per-request URL, query, env, and server snapshots
• Document and expose the new configuration in the defaults, example config, autoloader, and README

Details

• Adds RequestContextInterface, RequestContext, RequestContextProviderInterface, DefaultProvider, and RequestContextFactory
• Updates Profiler to capture request context on enable() / start() and pass it into ProfilingData on stop()
• Updates ProfilingData to build metadata from the captured context instead of reading mutable globals at shutdown
• Adds profiler.request_context_provider config support

[Copilot]

Pull request overview

This PR introduces a request-context abstraction so profiler metadata (URL, query/env/server snapshots, timestamps) is captured at profiling start rather than relying on mutable globals at shutdown—improving correctness for long-lived PHP runtimes.

Changes:

• Add RequestContext* abstractions, a default provider, and a factory to select a configured provider.
• Update Profiler and ProfilingData to capture/pass request context from enable()/start() through disable()/stop().
• Update defaults/docs/autoloader and adjust tests to use explicit request-context objects.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/TestCase.php	Adds a helper to build RequestContextInterface instances for tests.
tests/ProfilingDataTest.php	Stops mutating globals; passes explicit request contexts into ProfilingData.
src/RequestContextFactory.php	Creates a request-context provider from config (or default).
src/RequestContext/RequestContextInterface.php	Defines the request-context contract (url/query/env/server snapshot).
src/RequestContext/RequestContext.php	Implements an immutable request-context value object with HTTP/CLI constructors.
src/RequestContext/Providers/RequestContextProviderInterface.php	Defines provider hook for capturing request-scoped metadata.
src/RequestContext/Providers/DefaultProvider.php	Default capture implementation using superglobals / CLI argv fallback.
src/ProfilingData.php	Builds meta from captured context instead of reading globals at shutdown.
src/Profiler.php	Captures context at enable() and passes it into ProfilingData at disable().
README.md	Documents long-lived runtime guidance and custom request-context providers.
examples/autoload.php	Exposes profiler.request_context_provider example config knob.
config/config.default.php	Adds default config entry for profiler.request_context_provider.
autoload.php	Requires newly added request-context classes for non-Composer usage.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 6 comments.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.