(PHP 5, PHP 7, PHP 8)
php_user_filter::filter — Süzgeç uygulanırken çağrılır
$giriş
,$çıkş
,&$tüketilen
,$kapanış
Bu yöntem, süzgecin ekli olduğu akım üzerinde yapılan her okuma veya yazma (fread() veya fwrite() gibi) işleminde çağrılır.
giriş
Süzgeç uygulanacak verileri içeren bir veya daha fazla bakla nesnesini içeren zincir.
çıkış
Değiştirilmiş baklalarınızın yerleştirileceği diğer zincir.
tüketilen
Daima gönderimli bildirilmesi gereken
tüketilen
bağımsız değişkeni, süzgecinizin okuduğu ve
değiştirdiği verilerin uzunluğu kadar artırılmalıdır. Çoğu durumda bu,
tüketilen
bağımsız değişkeninin değerini, her bir
$bakla
için $bakla->datalen
kadar
arttıracağınız anlamına gelir.
kapanış
Akım kapanış sürecindeyse (dolayısıyla bu, süzgeç zincirindeki son
geçiştir) kapanış
bağımsız değişkenine true
atanmalıdır.
filter() yöntemi işini bitirdiğinde aşağıdaki üç değerden birini döndürmelidir:
Dönen değer | Anlamı |
---|---|
PSFS_PASS_ON |
Süzgeç giriş zincirindeki kullanılabilir
veriyi başarıyla işledi ve çıkış zincirine
ekledi.
|
PSFS_FEED_ME |
Süzgeç işini tamamladı ancak, döndürülecek bir veri yok. Akımdan veya önceki süzgeçten daha fazla veri gerekiyor. |
PSFS_ERR_FATAL (öntanımlı) |
Süzgeç kurtarılamayacak bir hata tespit etti; devam edilemiyor. |