PHP 8.3.4 Released!

stream_bucket_prepend

(PHP 5, PHP 7, PHP 8)

stream_bucket_prepend Prepend bucket to brigade

Description

stream_bucket_prepend(resource $brigade, object $bucket): void

This function can be called to prepend a bucket to a bucket brigade. It is typically called from php_user_filter::filter().

Parameters

brigade

brigade is a resource pointing to a bucket brigade which contains one or more bucket objects.

bucket

A bucket object.

Return Values

No value is returned.

Examples

Example #1 stream_bucket_prepend() examples

<?php

class foo extends php_user_filter {
protected
$calls = 0;
public function
filter($in, $out, &$consumed, $closing) {
while (
$bucket = stream_bucket_make_writeable($in)) {
$consumed += $bucket->datalen;
if (
$this->calls++ == 2) {
// This bucket will appear again before any other bucket.
stream_bucket_prepend($in, $bucket);
}
}
return
PSFS_FEED_ME;
}
}
stream_filter_register('test', 'foo');
print
file_get_contents('php://filter/read=test/resource=foo');
?>

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top