stream_filter_append
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
stream_filter_append - 将过滤器附加到流中
描述
resource stream_filter_append ( resource $stream , string $filtername [, int $read_write [, mixed $params ]] )添加filtername到附加的过滤器列表中stream。
参数
stream
目标流。
filtername
过滤器名称。
read_write
默认情况下，如果打开文件（即文件模式：r和/或+），stream_filter_append()会将过滤器附加到读取过滤器链。如果文件被打开进行写入（即文件模式：w，a和/或+），则过滤器也将附加到写入过滤器链中。，和/或也可以传递给参数以覆盖此行为。STREAM_FILTER_READSTREAM_FILTER_WRITESTREAM_FILTER_ALLread_write
params
该过滤器将与指定的列表一起添加params到列表的末尾，因此将在流操作期间最后被调用。要将过滤器添加到列表的开头，请使用stream_filter_prepend()。
返回值
返回成功或FALSE失败时的资源。在调用stream_filter_remove()期间，资源可用于引用此过滤器实例。
如果stream不是资源或者filtername不能定位，则返回FALSE。
Changelog
版本 | 描述 |
|---|---|
5.1.0 | 在PHP 5.1.0之前，此函数在成功返回TRUE或失败时返回FALSE。 |
例子
示例＃1控制应用过滤器的位置
<?php
/*?Open?a?test?file?for?reading?and?writing?*/
$fp?=?fopen('test.txt',?'w+');
/*?Apply?the?ROT13?filter?to?the
?*?write?filter?chain,?but?not?the
?*?read?filter?chain?*/
stream_filter_append($fp,?"string.rot13",?STREAM_FILTER_WRITE);
/*?Write?a?simple?string?to?the?file
?*?it?will?be?ROT13?transformed?on?the
?*?way?out?*/
fwrite($fp,?"This?is?a?test\n");
/*?Back?up?to?the?beginning?of?the?file?*/
rewind($fp);
/*?Read?the?contents?of?the?file?back?out.
?*?Had?the?filter?been?applied?to?the
?*?read?filter?chain?as?well,?we?would?see
?*?the?text?ROT13ed?back?to?its?original?state?*/
fpassthru($fp);
fclose($fp);
/*?Expected?Output
???---------------
Guvf?vf?n?grfg
?*/
?>注意
注意：使用自定义（用户）过滤器时， 必须首先调用stream_filter_register()，以便将所需的用户过滤器注册为
filtername。
注意：流数据是从资源（包括本地和远程）中以块读取的，任何未使用的数据保存在内部缓冲区中。当一个新的过滤器被附加到流中时，内部缓冲区中的数据将在那个时候通过新的过滤器进行处理。这与stream_filter_prepend()的行为不同。
注意：添加过滤器进行读取和写入时，会创建两个过滤器实例。stream_filter_append()必须被调用两次，
STREAM_FILTER_READ并STREAM_FILTER_WRITE获取两个过滤器资源。
另请参阅
- stream_filter_register() - 注册一个用户定义的流过滤器
- stream_filter_prepend() - 将过滤器附加到流中
- stream_get_filters() - 检索已注册过滤器的列表
← stream_encoding
stream_filter_prepend →
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
