Example 1 — Append Uppercased Buckets
A tiny custom filter uppercases each chunk, then stream_bucket_append() sends it onward. The demo uses php://memory only.
<?php
class UpperAppendFilter extends php_user_filter
{
public function filter($in, $out, &$consumed, $closing): int
{
while ($bucket = stream_bucket_make_writeable($in)) {
$bucket->data = strtoupper($bucket->data);
$consumed += $bucket->datalen;
stream_bucket_append($out, $bucket);
}
return PSFS_PASS_ON;
}
}
stream_filter_register("demo.upper.append", UpperAppendFilter::class);
$fp = fopen("php://memory", "w+");
stream_filter_append($fp, "demo.upper.append", STREAM_FILTER_WRITE);
fwrite($fp, "hello buckets");
rewind($fp);
echo stream_get_contents($fp), PHP_EOL;
fclose($fp); How It Works
- The filter class pulls each bucket from $in with stream_bucket_make_writeable().
- strtoupper() changes the text inside the bucket.
- stream_bucket_append() places that bucket on $out so the stream can continue.
- Writing through php://memory shows HELLO BUCKETS after rewind and read.

