# stream_bucket_prepend

(PHP 5, PHP 7, PHP 8)

stream_bucket_prepend — Añade un recipiente al principio de una cadena de recipientes

### Descripción

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

Se puede invocar a esta función para añadir un recipiente al principio de una cadena de recipientes. Normalmente se llama desde php_user_filter::filter().

### Parámetros

`brigade`

  `brigade` es un recurso que apunta a una `bucjet brigade` (cadena de recipientes) que contiene uno o más objetos `bucket` (recipiente).

`bucket`

  Un objeto recipiente.

### Valores devueltos

No devuelve ningún valor.

### Ejemplos

Ejemplo #1 Ejemplos de stream_bucket_prepend()

`<?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) {
// Este recipiente aparecerá de nuevo antes que cualquier otro recipiente.
stream_bucket_prepend($in, $bucket);
}
}
return PSFS_FEED_ME;
}
}
stream_filter_register('test', 'foo');
print file_get_contents('php://filter/read=test/resource=foo');
?>`