利用できるフィルタのリスト

stream_filter_append() と stream_filter_prepend() のちょっとした違いについて説明します。すべての PHP ストリームはその内部に小さな読み込みバッファ を持っており、ファイルシステムもしくは他のリソースから読み込まれたデータはこのバッファに格納されます。このことで、データをより効率的に扱うことができるのです。リソースがストリームの内部バッファに取り込まれたら、アプリケーション側で準備ができているかどうかにかかわらずすぐにフィルタ処理が行われます。フィルタが append されていた場合、読み込みバッファにはいってきたデータはすぐにフィルタ処理されます。つまり、バッファの存在をまったく意識せずに扱えるということです。しかし、もしフィルタが prepend されていた場合、読み込みバッファにデータが入ってきた段階ではフィルタ処理されません。リソースから次のデータブロックが読み込まれるまで、フィルタ処理を待機するのです。

あなたが使っている PHP にどのようなフィルタが登録されているかを知るには、stream_get_filters() を利用します。

文字列フィルタ

これらのフィルタは、まさしくその名が示すとおりの働きをし、PHP 組み込みの文字列処理関数と同じように動作します。これらのフィルタについてのより詳しい情報は、対応する関数のマニュアルを参照してください。

string.rot13 (PHP 4.3.0 以降) このフィルタは、すべてのストリームデータに対して str_rot13() 関数を適用するのと同じ動作をします。

例1 string.rot13


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'string.rot13');
fwrite($fp, "This is a test.\n");
/* 出力:     Guvf vf n grfg.   */
?>

string.toupper (PHP 5.0.0 以降) このフィルタは、すべてのストリームデータに対して strtoupper() 関数を適用するのと同じ動作をします。

例2 string.toupper


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'string.toupper');
fwrite($fp, "This is a test.\n");
/* Outputs:  THIS IS A TEST.   */
?>

string.tolower (PHP 5.0.0 以降) このフィルタは、すべてのストリームデータに対して strtolower() 関数を適用するのと同じ動作をします。

例3 string.tolower


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'string.tolower');
fwrite($fp, "This is a test.\n");
/* 出力:     this is a test.   */
?>

string.strip_tags (PHP 5.0.0 以降) このフィルタは、すべてのストリームデータに対して strip_tags() 関数を適用するのと同じ動作をします。以下の２つのうちどちらかの形式でパラメータを渡すことができます。ひとつは、strip_tags() 関数の第２パラメータと同じ形式でタグを並べた文字列、もうひとつはタグ名の配列です。

例4 string.strip_tags


<?php
$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, "<b><i><u>");
fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n");
fclose($fp);
/* 出力:     <b>bolded text</b> enlarged to a level 1 heading   */

$fp = fopen('php://output', 'w');
stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, array('b','i','u'));
fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n");
fclose($fp);
/* 出力:     <b>bolded text</b> enlarged to a level 1 heading   */
?>

利用できるフィルタのリスト

目次

文字列フィルタ