Filesystem Stream Collector

Captures filesystem (file://) stream operations via a PHP stream wrapper proxy — reads, writes, stats, and directory operations.

What It Captures

Field	Description
operation	Operation type (open, read, write, stat, unlink, mkdir, etc.)
path	File path
args	Operation arguments

Data Schema

Operations are grouped by type:

{
    "open": [
        {"path": "/app/config/app.php", "args": {"mode": "r"}},
        {"path": "/app/var/cache/data.json", "args": {"mode": "w"}}
    ],
    "stat": [
        {"path": "/app/public/index.php", "args": {}}
    ]
}

Summary (shown in debug entry list):

{
    "fs_stream": {
        "open": 15,
        "read": 42,
        "stat": 8,
        "write": 3
    }
}

Contract

use AppDevPanel\Kernel\Collector\Stream\FilesystemStreamCollector;

$collector->collect(
    operation: 'open',
    path: '/app/config/app.php',
    args: ['mode' => 'r'],
);

INFO

FilesystemStreamCollectorAppDevPanel\Kernel\Collector\Stream\FilesystemStreamCollectorCollects Filesystem Stream data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface implements SummaryCollectorInterfaceAppDevPanel\Kernel\Collector\SummaryCollectorInterfaceSummary data collector responsibility is to collect summary data for a collector. Summary is used to display a list of previous requests and select one to display full info. Its data set is specific to the list and is reduced compared to full data collected in {@see CollectorInterface}.Kernel · interface · extends CollectorInterface. Supports configurable ignore patterns to exclude paths (e.g., vendor directory).

How It Works

The collector uses a PHP stream wrapper proxy (FilesystemStreamProxyAppDevPanel\Kernel\Collector\Stream\FilesystemStreamProxyDecorator proxy for Filesystem Stream. Intercepts calls and forwards data to collectors.final Kernel · class · implements StreamWrapperInterface) that registers itself for the file:// protocol. All filesystem operations (fopen, file_get_contents, is_file, mkdir, etc.) are intercepted via PHP's stream wrapper mechanism. Paths matching excludePaths patterns are ignored.

Debug Panel

• Operation groups — filesystem operations grouped by type
• File path list — all accessed paths with operation details
• Operation counts — summary of operations per type in sidebar badge (I/O)