# stream_bucket_prepend

(PHP 5, PHP 7, PHP 8)

stream_bucket_prepend — Ajout initial d'un bucket dans une brigade

### Description

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

Cette fonction peut être appelée pour ajouter un bucket dans une bucket brigade. Elle est typiquement appelée depuis la méthode php_user_filter::filter().

### Liste de paramètres

`brigade`

  `brigade` est une ressource pointant vers une `bucket brigade` qui contient un ou plusieurs objets `bucket`.

`bucket`

  Un objet bucket.

### Valeurs de retour

Aucune valeur n'est retournée.

### Historique

Version | Description
--- | ---
8.4.0 | `bucket` attend désormais une instance de StreamBucket ; auparavant, une stdClass était attendue.

### Exemples

Exemple #1 Exemple avec 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) {
// Ce bucket va apparaître avant tout autre 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');
?>`