# stream_bucket_prepend

(PHP 5, PHP 7, PHP 8)

stream_bucket_prepend — Prepend bucket to brigade

### 说明

stream_bucket_prepend(resource `$brigade`, StreamBucket `$bucket`): void

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

### 参数

`brigade`

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

`bucket`

  A bucket object.

### 返回值

没有返回值。

### 更新日志

版本 | 说明
--- | ---
8.4.0 | `bucket` 现在期望 StreamBucket 实例；之前期望 stdClass。

### 示例

示例 #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');
?>`
`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open