Example 1 — Register and Use an Uppercase Filter
Define a small filter class, register it, then write through php://memory.
<?php
class TutorialUpperFilter 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;
}
}
$ok = stream_filter_register("tutorial.upper", TutorialUpperFilter::class);
$fp = fopen("php://memory", "w+");
stream_filter_append($fp, "tutorial.upper", STREAM_FILTER_WRITE);
fwrite($fp, "register me");
rewind($fp);
echo $ok ? "registered" : "failed", PHP_EOL;
echo stream_get_contents($fp), PHP_EOL;
fclose($fp); How It Works
- The class extends php_user_filter and uppercases each bucket.
- stream_filter_register() publishes the name tutorial. upper.
- stream_filter_append() attaches that name to the memory stream.
- Writing and reading shows REGISTER ME.

