SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

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

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

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

  • X ポスト
  • このエントリーをはてなブックマークに追加

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

  • X ポスト
  • このエントリーをはてなブックマークに追加

対象読者

 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)
};

次のページ
ストリームの読み込みとクローズ処理をするための関数の作成

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
PHPエクステンションの作り方連載記事一覧

もっと読む

この記事の著者

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

静岡県榛原町生まれ。一橋大学経済学部卒業後、NECにてシステム企画業務に携わるが、2003年4月に念願かなってフリーライターに転身。Microsoft MVP for Visual Studio and Development Technologies。執筆コミュニティ「WINGSプロジェクト」代表。主な著書に「独習シリーズ(Java・C#・Python・PHP・Ruby・JSP&サーブレットなど)」「速習シリーズ(ASP.NET Core・Vue.js・React・TypeScript・ECMAScript、Laravelなど)」「改訂3版JavaScript本格入門」「これからはじめるReact実践入門」「はじめてのAndroidアプリ開発 Kotlin編 」他、著書多数

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

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

WINGSプロジェクトについて>有限会社 WINGSプロジェクトが運営する、テクニカル執筆コミュニティ(代表 山田祥寛...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/7576 2014/01/21 14:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング