php_user_filter::onCreate

(PHP 5, PHP 7, PHP 8)

php_user_filter::onCreateフィルタを作成するときにコールされる

説明

public php_user_filter::onCreate(): bool

このメソッドがコールされるのは、フィルタクラスのオブジェクトのインスタンスを生成するときです。 他のリソース (バッファなど) を確保したり初期化したりする場合は、このメソッドで行います。

フィルタのインスタンスを作成して yourfilter->onCreate() をコールすると、 以下の表に示すさまざまなプロパティが使えるようになります。

プロパティ 内容
FilterClass->filtername フィルタのインスタンスを作成するときの名前を表す文字列。 フィルタを登録するときには、複数の名前を使ったりワイルドカードを使ったりできます。 このプロパティを使って、どの名前が用いられたのかを判断します。
FilterClass->params stream_filter_append() あるいは stream_filter_prepend() に渡された params パラメータの内容。
FilterClass->stream フィルタの対象となるストリームリソース。 closing パラメータが false の状態で filter() がコールされている間だけ存在します。

パラメータ

この関数にはパラメータはありません。

戻り値

このメソッドを実装は、成功した場合に true そして失敗した場合に false を返す必要があります。

関連キーワード:  フィルタ, コール, 作成, filter, user, パラメータ, onCreate, インスタンス, stream, 名前