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 →