stream_filter_register()

(PHP 5, PHP 7)

Register a user defined stream filter

说明

stream_filter_register()allows you to implement your own filter on any registered stream used with all the other filesystem functions (such asfopen(),fread()etc.).

参数

The filter name to be registered.

To implement a filter, you need to define a class as an extension ofphp_user_filterwith a number of member functions. When performing read/write operations on the stream to which your filter is attached, PHP will pass the data through your filter (and any other filters attached to that stream) so that the data may be modified as desired. You must implement the methods exactly as described inphp_user_filter- doing otherwise will lead to undefined behaviour.

返回值

成功时返回TRUE，或者在失败时返回FALSE。

stream_filter_register()will returnFALSEif the$filternameis already defined.

范例

Filter for capitalizing characters onfoo-bar.txtstream

The example below implements a filter namedstrtoupperon thefoo-bar.txtstream which will capitalize all letter characters written to/read from that stream.

以上例程会输出：

LINE1
WORD - 2
EASY AS 123

Registering a generic filter class to match multiple filter names.

以上例程会输出：

LINE1
WORD - 2
EASY AS 123

参见

• stream_wrapper_register() 注册一个用 PHP 类实现的 URL 封装协议
• stream_filter_append()Attach a filter to a stream
• stream_filter_prepend()Attach a filter to a stream

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com