Shoeisha Technology Media

CodeZine(コードジン)

記事種別から探す

PHPでのストリーム処理の実装

PHPエクステンションの作り方 第6回

  • LINEで送る
  • このエントリーをはてなブックマークに追加
2014/01/21 14:00

 本連載では、PHPエクステンションの作成方法を紹介します。前回は、ネイティブライブラリを組み込みPHPエクステンションから利用する方法を紹介しました。今回もそのネイティブライブラリを利用し、さらにそこで取得できるリソースをfreadやfopen関数で利用できるようにストリームとして提供する方法を紹介します。

目次

対象読者

 PHPでの基本構文を理解している方で、PHPエクステンションに興味がある方、さらに深くPHPを知りたい方で、C言語の基本的な構文を理解している方を対象としています。

必要な環境

 この記事では、PHP 5.4を使用し、Linux環境で確認を行っています。インストール方法は初回を参照してください。

 また、前回使用したlibzipも必要ですので、そちらも前回を参照してインストールしてください。

PHPストリームとは

 PHPではデータの読み書きをする際に、通常のファイルの読み書きをする関数を使ってアクセスできる機能があり、このようなリソースの提供方法をストリームと呼びます。例えば、HTTP上のコンテンツを以下のようにアクセスできることは多くの方が知っているのではないかと思います。

HTTP上のリソースをストリームとして取得する方法
$fp = fopen("http://www.coltware.com/","r");

 同様に、今回のサンプルコードの元になっているZipでも以下のようにアクセスできます。

Zipファイルのエントリファイルをストリームとして取得する方法
$fp = fopen("zip:///home/webadmin/sample/file1.zip#file1.txt","r");

 このように取得するリソースの種類を問わず同じ方法でリソース上のコンテンツデータを取得できる方法が提供されています。上記以外にも、PHPではサポートされているプロトコルがPHPのマニュアルに記述がありますので、参考にしてください。

 また、このストリームは関数やクラスのメソッドから返すこともできますので、関数の戻り値をストリームにすれば、より自由な形で取得しやすくすることも可能です。

メソッドからのPHPストリームの作成

 最初は、PZipFileクラス上のメソッドからZipファイルの中の一つのデータをストリームとして取得する方法を紹介します。

 前回までのサンプルではZipファイル内のエントリ情報にアクセスする実装をしておりましたので、そこで取得した情報を元にそのままデータにアクセスできるようになるというメリットがあります。実際に、サンプルコードのPZipFile::getStream()でストリームを戻すように実装します。

PHPストリームを作成する手順

 PHPストリームを作成するには、以下の手順で作成します。

  1. ストリームの状態を管理する構造体を用意する
  2. ストリームの読み込み(read)、書き込み(write)、クローズ(close)などを行うための関数を作成する
  3. 2で作成した関数をハンドラとして登録する構造体を用意する
  4. 3で作成した構造体を用いてファイルをオープンする関数を作成する

ストリームの状態を管理する構造体を作成する

 ストリームとしてデータを読みこんだ際にどのリソース(1)から、どの程度のバイト数(2)を読みこんだかを管理するための構造体を用意します。最低限、これらの情報があれば読込のみであれば十分です。また、この構造体は自由に定義できます。

pzip_stream.cの抜粋
struct php_pzip_stream_data_t {
    struct zip_file *zf;  // ……(1)
    size_t cursor;        // ……(2)
};

  • LINEで送る
  • このエントリーをはてなブックマークに追加

著者プロフィール

  • WINGSプロジェクト 小林 昌弘(コバヤシ マサヒロ)

    <WINGSプロジェクトについて> 有限会社 WINGSプロジェクトが運営する、テクニカル執筆コミュニティ(代表 山田祥寛)。主にWeb開発分野の書籍/記事執筆、翻訳、講演等を幅広く手がける。2012年2月時点での登録メンバは37名で、現在も執筆メンバを募集中。興味のある方は、どしどし応募頂きたい...

  • 山田 祥寛(ヤマダ ヨシヒロ)

    静岡県榛原町生まれ。一橋大学経済学部卒業後、NECにてシステム企画業務に携わるが、2003年4月に念願かなってフリーライターに転身。Microsoft MVP for ASP/ASP.NET。執筆コミュニティ「WINGSプロジェクト」代表。 主な著書に「入門シリーズ(サーバサイドAjax/XMLD...

バックナンバー

連載:PHPエクステンションの作り方
All contents copyright © 2006-2017 Shoeisha Co., Ltd. All rights reserved. ver.1.5