在线文档教程
PHP
流 | Streams

php_user_filter::filter

php_user_filter::filter

(PHP 5, PHP 7)

php_user_filter::filter - 应用过滤器时调用

描述

public int php_user_filter::filter ( resource $in , resource $out , int &$consumed , bool $closing )

每当从附加流读取数据或将数据写入附加流时(例如使用fread()或fwrite()),都会调用此方法。

参数

in

in是指向包含一个或多个包含待过滤数据的对象的桶旅的资源。

out

out是指向第二个桶旅的资源,应该在其中放置修改后的桶。

consumed

consumed,它必须始终由引用来声明,应该增加过滤器读入和修改的数据的长度。在大多数情况下,这意味着你将增加consumed由$ bucket-> DATALEN每个$桶。

closing

如果流正在关闭(因此这是最后一次通过过滤链),closing参数将被设置为TRUE

返回值

所述filter()方法必须返回完成后三个值中的一个。

返回值含义
PSFS_PASS_ON过滤器成功地处理了桶外旅中可用的数据。
PSFS_FEED_ME过滤器已成功处理,但没有可用的数据返回。流或过滤器需要更多数据。
PSFS_ERR_FATAL(默认)过滤器遇到不可恢复的错误,无法继续。

← php_user_filter

php_user_filter::onClose →