PHPストリーム操作

/* reimplement fopen using stream */ZEND_FUNCTION(donie_stream_fopen){  php_stream *stream;  char *path, *mode;  int path_len, mode_len;  int options = ENFORCE_SAFE_MODE|REPORT_ERRORS;  if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss", &path, &path_len, &mode, &mode_len) == FAILURE)  {      return;  }  stream = php_stream_open_wrapper(path, mode, options, NULL);  if (!stream)  {      RETURN_FALSE;  }  php_stream_to_zval(stream, return_value);}

php_stream_open_wrapper() の実装は、ファイル タイプのリソースのストリームを作成するメソッドです。さらに、socket もあります。ベースのストリームとディレクトリ ストリームと特殊なストリームには 3 つの種類があります。 php_stream_to_zval() は、ストリーム インスタンスを zval 構造体に変換するために使用されます。

ファイル タイプのストリームを作成します

#define php_stream_open_wrapper(path, mode, options, opened)   _php_stream_open_wrapper_ex((path), (mode), (options), (opened), NULL STREAMS_CC TSRMLS_CC)#define php_stream_open_wrapper_ex(path, mode, options, opened, context) _php_stream_open_wrapper_ex((path), (mode), (options), (opened), (context) STREAMS_CC TSRMLS_CC)

パラメーターの path はファイル名または URL、mode はモード文字列、およびoptions はオプションの組み合わせです。 php_stream_open_wrapper_ex() を使用すると、ストリーム コンテキストを指定できます。

オプションには次のオプションが含まれます:

• USE_PATH: ini の include_path を相対パスに適用します。このオプションは、組み込みの fopen() の 3 番目のパラメータが True に設定されている場合に使用します。
• STREAM_USE_URL: %%file://、php://、compress.zlib://%% などのローカル URL のみを開くことができます。エラーが報告されます。
• ENFORCE_SAFE_MODE: Safe_mode は、このオプションが設定され、ini のsafe_mode がオンになっている場合にのみ有効になります。このオプションが設定されていない場合は、ini でオンになっているかどうかに関係なく、有効になりません。
• REPORT_ERRORS: ストリームを開くときにエラーが発生した場合、エラー メッセージが生成されます。
• STREAM_MUST_SEEK: すべてのストリームでシークが許可されるわけではなく、このオプションが設定されていてストリームがシークを許可しない場合、ラッパーはストリームを開きません。
• STREAM_WILL_CAST: このパラメータを設定するには、ストリームを posix または stdio タイプのファイル記述子に変換できる必要があります。ストリームを変換できない場合は、IO が開始される前に失敗する可能性があります。
• STREAM_ONLY_GET_HEADERS: このパラメーターは、コンテンツではなくリソースのメタデータのみを取得するために http ラッパーによって使用されます。
• STREAM_DISABLE_OPEN_BASEDIR: ini の open_basedir がオンになっている場合、open_basedir チェックをスキップするようにこのパラメーターを設定します。
• STREAM_OPEN_PERSISTENT: ストリームと関連リソースを永続データとして作成する必要があります。
• IGNORE_PATH: include_path から検索しません。
• IGNORE_URL: ローカル ファイルのみを開くことができます。

トランスポートタイプのストリームを作成します

php_stream *_php_stream_xport_create(const char *name, size_t namelen, int options, int flags, const char *persistent_id, struct timeval *timeout, php_stream_context *context, char **error_string, int *error_code)

パラメータ:

• 名前: URL 。
• オプション: パラメーター、php_stream_open_wrapper() と同じ。
• フラグ: STREAM_XPORT_CLIENT または STREAM_XPORT_SERVER と他の STREAM_XPORT_* 定数の組み合わせ。
• persistent_id: キーの値。このパラメータを設定すると、複数のリクエスト間でストリームが永続化されます。
• タイムアウト: NULL を設定すると、ini に設定された値が使用されます。
• errstr: エラー情報を外部に送信するために使用されます。エラー メッセージが送信された場合、呼び出し元はエラー メッセージによって占有されているメモリを解放する必要があります。
• errcode: エラーコード。

フラグ:

• STREAM_XPORT_CLIENT: クライアントとして機能し、リモートへの接続を開始します。
• STREAM_XPORT_SERVER: サーバーとして機能し、接続を受け入れます。
• STREAM_XPORT_CONNECT: 送信が確立されたときにリモート接続を開始します。それ以外の場合は、php_stream_xport_connect() を手動で呼び出す必要があります。
• STREAM_XPORT_CONNECT_ASYNC: 非同期リモート接続を開始します。
• STREAM_XPORT_BIND: トランスポート ストリームをローカル リソースにバインドします。これをサーバー側のトランスポート ストリームで使用すると、受け入れ接続されたトランスポート ストリームがポート、パス、特定のエンドポイント識別子などの情報を準備できるようになります。
• STREAM_XPORT_LISTEN: %%バインドされたトランスポート エンドポイントでの受信接続をリッスンします。これは通常、tcp://、ssl://、unix://%% などのストリームベースのトランスポートで使用されます。 🎜>

ディレクトリ タイプのストリームを作成します

php_stream php_stream_opendir(const char *path, int options, php_stream_context *context) 

特殊なタイプのストリームを作成します

php_stream *php_stream_fopen_tmpfile(void);php_stream *php_stream_fopen_temporary_file(const char *dir, const char *pfx, char **opened_path);php_stream *php_stream_fopen_from_fd(int fd, const char *mode, const char *persistent_id);php_stream *php_stream_fopen_from_file(FILE *file, const char *mode);php_stream *php_stream_fopen_from_pipe(FILE *file, const char *mode);

読み取りストリーム

// 讀一個字符int php_stream_getc(php_stream *stream);// 讀取指定數量的字符size_t php_stream_read(php_stream *stream, char *buf, size_t count);// 讀取直到行末、或流末、或最多maxlen個字符char *php_stream_get_line(php_stream *stream, char *buf, size_t maxlen, size_t *returned_len);char *php_stream_gets(php_stream *stream, char *buf, size_t maxlen);// 與php_stream_get_line相同，可指定截止標記char *php_stream_get_record(php_stream *stream, size_t maxlen, size_t *returned_len, char *delim, size_t delim_len TSRMLS_DC);// 讀取一個目錄項php_stream_dirent *php_stream_readdir(php_stream *dirstream, php_stream_dirent *entry);

書き込みストリーム

// 寫非阻塞流可能寫入的數據比傳入的短；_string要求傳入的字符串以NULL結尾size_t php_stream_write(php_stream *stream, char *buf, size_t count);size_t php_stream_write_string(php_stream *stream, char *stf);int php_stream_putc(php_stream *stream, int c);// 與_string不同的是會自動追加一個換行符到字符串末尾int php_stream_puts(php_string *stream, char *buf);size_t php_stream_printf(php_stream *stream TSRMLS_DC, const char *format, ...);

int php_stream_flush(php_stream *stream); 

ストリームを閉じると、フラッシュが自動的に呼び出されます。また、フィルターされていないストリームのほとんどは内部バッファリングがないためフラッシュを必要とせず、通常、別個のフラッシュは必要ありません。

アドレス指定

int php_stream_seek(php_stream *stream, off_t offset, int whence); int php_stream_rewind(php_stream *stream); int php_stream_rewinddir(php_stream *dirstream); off_t php_stream_tell(php_stream *stream); 

オフセットは wherece に対する相対的な変位であり、whence には以下が含まれます。

SEEK_SET: ファイルの先頭。オフセットを負の値に設定するとエラーとみなされ、予期しない動作が発生する可能性があります。ファイル範囲外のオフセットはエラーとなるか、ファイルサイズが大きくなります。
SEEK_CUR: 現在の場所。
SEEK_END: ファイルの終わり。オフセットは通常負の値ですが、正の値の場合の動作はストリームの実装によって異なります。

追加情報の取得

int php_stream_stat(php_stream *stream, php_stream_statbuf *ssb); 

ストリームを閉じる

#define php_stream_close(stream) php_stream_free((stream), PHP_STREAM_FREE_CLOSE) #define php_stream_pclose(stream) php_stream_free((stream), PHP_STREAM_FREE_CLOSE_PERSISTENT) 

次のオプションが含まれます:

• PHP_STREAM_FREE_CALL_DTOR: ストリームの破棄時に php_stream->ops->close が呼び出されます
• PHP_STREAM_FREE_RELEASE_STREAM: ストリームの破棄時に php_stream_wrapper->ops->stream_close が呼び出されます
• PHP_STR EAM_FREE_PRESERVE_HANDLE: php_stream->ops->close はハンドルを破棄しません
• PHP_STREAM_FREE_RSRC_DTOR: ストリームの内部リソース リストのガベージ コレクションに使用されます
• PHP_STREAM_FREE_PERSISTENT: 永続ストリームに使用されます。すべての操作の結果は複数のリクエスト間で維持されます 永続的に有効
• PHP_STREAM_FREE_CLOSE: CALL_DTOR と RELEASE_STREAM の組み合わせ、非永続ストリームの一般オプション
• PHP_STREAM_FREE_CLOSE_CASTED: CLOSE と PRESERVE_HANDLE の組み合わせ
• PHP_STREAM_FREE_CLOSE_ PERSISTENT: CLOSE と PERSISTENT の組み合わせ、永続ストリームの一般的なオプション