←FileMaker関連情報

FX.php日本語対応版／FX_charset

iVikingより配布しているFX.phpは、PHPからFileMaker Proのデータベースに接続するためのライブラリクラスです。FileMaker 7になってUnicode対応がWeb側にも行われ、FX.phpをそのまま使うことも可能で、その方法も紹介しましょう。しかしながら、FileMakerのデータベースから取り出した文字列をPHPで処理をしたい場合などに問題が発生します。そこで、非アスキーコード文字列対応のラッパークラスFX_charsetを利用することで問題は解決します。

基本的な使用方法

FX_charset（FX.php Ver.3.1対応）をダウンロードしてください。FX.php自体は再配布が可能なライセンスなので、この中に含めました。

PHPが稼働するWebサーバをご用意していただく必要があります。また、mb_stringが利用できるようになっている必要があります。なお、開発やテストは、Apache 1.3.33／PHP 4.3.2（Mac OS X v10.3.7）で行っています。

FX_charsetフォルダを、Webサーバのドキュメント内の適当な位置に配置すればOKです。

ライブラリの本体は、FX_charsetフォルダにあるFX_charset.phpです。これはラッパークラスで、FX.php自体は、FX_charset.phpと同じフォルダにあるFXフォルダに入っています。このフォルダ構成で稼働させるのが既定値ですが、もちろん、別ファイルの参照部分はPHPのプログラムソースを変更することで自由に変えて利用できます。

稼働環境について

• FileMaker 7シリーズでは、FileMaker Server 7 Advancedが必要です。FileMaker Pro 7ではFXは利用できません。
• FileMaker 6シリーズでは、ファイルメーカーPro 6あるいはファイルメーカーPro 6 Unlimitedで利用できます。
• PHPのバージョンについては、特に細かな規定はありませんが、Ver.4.3系列でチェックをしています。

Windows版でのmb_string

日本語文字変換では、mb_stringを使っています。LinuxなどUNIX系のみなさんは、ぜひとも、mb_stringをコンパイル時に指定するか、指定してビルドされたものを使ってください。もっとも、コード変換部分はiconvで置き換えは可能とは思います。

Windows版のPHPでは、mb_stringにネイティブのライブラリを使うようです。mb_stringの部分で「関数がない」というエラーが出る場合には、たとえば、次の点などをよく確認してください。

phpの設定が入っているphp.iniにある以下の行を有効に（行頭に;がない状態に）してみてください。php.iniファイルはphpinfo()コマンドで表示される情報に書き込まれていますが、たとえば、c:¥apache¥apache¥php.iniなどとなっているようです。

		extension_dir = "c:/php/extensions/"
		extension=php_mbstring.dll

サンプルの使用方法

サンプルとして、書籍のデータベースがあって、それを一覧表示したり、入力、検索、詳細表示ができるようなPHPのソースが付属しています。オリジナルのFX.phpにあったものを改良しましたが、FileMaker 7のみのデータベースです。必要なアクセス権設定をしています。ただし、[完全アクセス]が可能なadminアカウントにはパスワードをかけていませんし、ゲストも[完全アクセス]となりますので、実際の運用ではご注意ください。

データベースファイルのBook_List.fp7を、FileMaker Server 7で公開します。さらに、FileMaker Server 7 AdvancedのWeb公開エンジンを稼働させて、このデータベースへXMLアクセスが可能になるようにします。

/FX_charset/index-utf8.phpを開きます（もちろん、配置した場所に応じてホスト名やパス名を付けて正しいURLでアクセスをしてください）。書籍のリストが見えていればOKです。書籍名のリンクをクリックすると、書籍の詳細ページ（detail-utf8.php）に移動します。入力や検索も、通常とおり日本語についても可能なので、試してみてください。

ファイルメーカーPro 6で利用する場合

サンプルをファイルメーカーPro 6で使う場合、詳細表示の画面で画像がそのままでは出てきません。そこで、detail-*.phpファイルの一部を修正してください。以下のように、赤い文字のスラッシュを追加してください。「cover_art 」で検索すれば、その場所がすぐに分かると思います。（お知らせいただいた森さん、ありがとうございます。）

	<td align="center" valign="center" bgcolor="#FFFFFF" width="125" rowspan="4">
		<img src="<?php echo "http://$serverIP:$webCompanionPort/" . 
			$BookData['data'][$currentKey]['cover_art'][0]; ?>" 
			width="200">
	</td>

PHPのプログラムの作成方法

本当はFX.php自体の詳しい使い方を日本語でご紹介しないといけないのですが、とりあえず、オリジナルの英語の文書をご覧ください。その上で、FX_charset.phpの使い方を紹介します。

FX.phpとFX_charset.phpの違い

サンプルのデータベースを使って、FXとFX_charsetの違いが分かるようにしました。書籍の一覧から、書籍名をクリックして、詳細ページに移動します。そのとき、TitileフィールドのデータをPHPで1文字ずつに分割した結果を表の下に表示します。日本語の書籍名の「メールシステムの作り方大全」（手前味噌ですみません…）をクリックしてください。

detail-utf8.phpは、FX_charsetを使ってUTF-8ベースで稼働させています。そのため、データベースから得られた文字列は、UTF-8形式の文字列です。そのため、1文字目は「メ」、3文字目は「ル」などと、mb_substr関数で得られる1文字と、データベースに記録される文字列の1文字は対応しています。

一方、index-fx.phpから書籍名のリンクをクリックして表示されるdetail-fx.phpにおいても、とりあえずは日本語は文字化けしませんし、入力や検索もうまく行きます。しかしながら、Titleフィールドの文字列を1文字ずつ取り扱うと、以下の図のようになります。たとえば、「メ」は、Unicodeではコードポイントとしては12513（0x30E1）ですので、文字列参照（character reference）形式だと「メ」とソースコード上で展開されます。HTMLのソースに文字列参照が含まれている場合、ブラウザでレンダリングして正しく「メ」と表示されますので、単にブラウザ表示をする上では問題がありません。しかしながら、PHPで文字列として処理しようと思うとそのままではうまく行きません。もちろん、PHPで変換関数などを作る…という手段もあるかもしれませんが、FXのラッパーとして、普通に文字列が得られるようにしてみました。

FX.phpで日本語をきちんと処理する方法

FX_charsetではなくFXで日本語を利用する方法を説明しておきましょう。FileMaker Server 7 AdvancedではUnicode対応によりそれも可能です。一方、Ver.6までのファイルメーカーでの利用はできません。また、前記の問題がありますが、単にページ表示をしたいだけならFXでも問題はありません。

• HTTPのヘッダないしはHTMLのヘッドセクションで、必ずUTF-8を使うことを宣言します。なくても見えるブラウザもあるかもしれませんが、何からかの形で付けます。たとえば、ページの最初に、以下のようなヘッダ制御のステートメントを入れておくといいでしょう。

  <? header('Content-Type: text/html;charset=utf-8'); ?>

FX_charset.phpの使用方法の違い

FX_charsetはFXをもとにしているので、FXの機能はそのまま使えます。コンストラクタや、あるいはメソッドなどはすべてそのまま使えるはずです。加えて、外部仕様的には2つのメソッドを利用するようになっています。ただし、これらは常に使う訳ではありませんので、状況に合わせて設定をしてください。

追加メソッド	解説
SetCharacterEncoding($encoding)	データベースから得られたデータを、このメソッドの引数で指定した文字セット／エンコーディングの文字列に変換する。既定値はUTF-8。''を引数に指定すれば、FXと同様な動作になる。
SetDataParamsEncoding($encoding)	データベースへのリクエストに含める文字列の文字セット／エンコーディングを指定する。既定値はUTF-8。''を引数に指定すれば、FXと同様な動作になる。

• FX_charset.phpをincludeあるいはrequireして取り込みます。また、FX_charset.phpからFX.phpが参照できているかもきちんと管理をしてください。

FX_charsetを使ってUTF-8のページを作成する場合

作成するPHPのページがUTF-8で稼働する場合には、以下の点を注意します。

• HTTPのヘッダないしはHTMLのヘッドセクションで、必ずUTF-8を使うことを宣言します。たとえば、ページの最初に、以下のようなヘッダ制御のステートメントを入れておくといいでしょう。

  <? header('Content-Type: text/html;charset=utf-8'); ?>

• FXの生成しているところで、new FX( ... ) の代わりに new FX_charset( ... ) と書き換えるだけでかまいません。SetCharacterEncoding やSetDataParamsEncodingは呼び出す必要がありません（デフォルトでいいのです）。
• 文字列処理をする場合は、mb_stringライブラリの設定にも注意を払ってください。たとえば、以下のメソッドなどが必要になるかもしれませんし、場合によってはphp.iniファイル等での設定を行います。PHPで文字列処理するときにはmb_internal_encodingは必須と思われますが、mb_http_outputはなくてもいいようです。

  mb_internal_encoding('utf8');
  mb_http_output('utf8');

FX_charsetを使ってEUCのページを作成する場合

作成するPHPのページがEUCで稼働する場合には、以下の点を注意します。

• HTTPのヘッダないしはHTMLのヘッドセクションで、必ずEUCを使うことを宣言します。たとえば、ページの最初に、以下のようなヘッダ制御のステートメントを入れておくといいでしょう。

  <? header('Content-Type: text/html;charset=EUC-JP'); ?>

• FXの生成しているところで、new FX( ... ) の代わりに new FX_charset( ... ) と書き換えます。さらに、その直後に、クラス内で使う文字コードの設定を行います。一方は、EUC-JPですが、もう一方はutf8にしておく必要があります。

  $BookQuery = new FX_charset($serverIP, $webCompanionPort, 'FMPro7');
  $BookQuery->SetCharacterEncoding('EUC-JP');
  $BookQuery->SetDataParamsEncoding('utf8');

• 文字列処理をする場合は、mb_stringライブラリの設定にも注意を払ってください。たとえば、以下のメソッドなどが必要になるかもしれませんし、場合によってはphp.iniファイル等での設定を行います。PHPで文字列処理するときにはmb_internal_encodingは必須と思われますが、mb_http_outputはなくてもいいようです。

  mb_internal_encoding('EUC-JP');
  mb_http_output('EUC-JP');

ファイルメーカーPro Ver.6まででの利用

ファイルメーカーPro Ver.6まで、あるいはUnlimited版で、日本語をきちんと使うには、FX_charsetが必須です。FX.phpでは、データベースの内容の参照しかできず、入力や検索などは思った通りに動きません。もともと、そのことがあってFXを日本語化したのですが、FX_charsetでも従来のファイルメーカーPro Ver.6で稼働するようにソースは残してあります。

ファイルメーカーPro 6までで使う場合には、Webコンパニオンをオンにして、データベースを公開します。そして、PHPのソースでは以下の点に気をつけます。

• HTTPのヘッダないしはHTMLのヘッドセクションで、必ずEUCを使うことを宣言します。たとえば、ページの最初に、以下のようなヘッダ制御のステートメントを入れておくといいでしょう。

  <? header('Content-Type: text/html;charset=EUC-JP'); ?>

• FXの生成しているところで、new FX( ... ) の代わりに new FX_charset( ... ) と書き換えます。3つ目の引数は 'FMPro5/6' にします。さらに、その直後に、クラス内で使う文字コードの設定を行います。一方はEUC-JPですが、もう一方は、SJISです（ファイルメーカーProが日本語版の場合）。

  $fx = new FX_charset( ..., 'FMPro5/6' );
  $fx->SetCharacterEncoding('EUC-JP');
  $fx->SetDataParamsEncoding('SJIS');

なお、UTF-8で使う場合は、ヘッダとSetCharacterEncodingの引数を、'utf8' にすればいいでしょう。

ライセンスについての注意

なお、この方法を使うと、WebサーバとファイルメーカーProを同一マシンにすれば、つまりはファイルメーカーProへのアクセスは127.0.0.1のIPアドレスからの接続だけになります。従って、Webサーバへの接続がどこからでも、ファイルメーカーへは127.0.0.1経由の接続だけになり、結果的にUnlimited版を購入しなくても、多数のユーザがWeb経由で接続が可能です。しかしながら、こうした使い方は使用許諾上許されていませんので、10ユーザ以上の利用がある場合は、ファイルメーカーProはUnlimited版をご利用ください。

いろいろなお話

• 2005年1月30日に熊本で開催されたファイルメーカーPro 九州ユーザーズミーティング勉強会で、『FileMaker Web公開のもう1つの選択肢「FX.php」』として紹介をしました。プレゼンテーション資料
• FileMaker Server 7 Advanced対応のFX.phpがVer.3.1としてリリースされました。そこでは非アスキーコード文字列対応のソースはマージしてくれなかったので、非アスキーコード文字列対応のラッパークラスFX_charsetを作り、それを配布することにしました（2005/1/28）。
• 2005/1/28：FX_charsetを公開しました。これに伴って、ページの内容を一新しました。以前のページは、こちらに残してあります。
• 2004年8月末に、フェニックスでFileMaker Developer Conference 2004がありました。そこで、FX.phpの開発もとであるiViking.orgがブースを出展していたので、訪問してChris Hansenと記念写真をとりました。ブースはほとんど彼一人が3日間やっていたので、大変だったでしょう。
  DevCon 2004ではFileMaker 7シリーズ系列のしんがり登場となる「FileMaker Server 7 Advanced」がリリースとなりましたが、iViking.orgではさっそく、FX.php Ver.3.0として、FileMaker Server 7 Advanced対応版をリリースしています。どうやら、USAのFSAの一部には発売前にソフトがシードとして配布されるようなので、こうした対応ができますね。さっそく、Ver.3.0の日本語化を開始しています。仕組みは変わっていないので、すぐにできると思います。ちなみに、写真では顔を揃えていますが、彼は座っていて、私は立っています（笑）。アメリカ人の雑踏の中からでも首が出ているくらいChrisは背が高いのです。（2004/9/1）
  
• 2004/8/19に開催されたPHPカンファレンス2004で日本語版FX.phpをプレゼンしました。プレゼンテーションのPDFファイル
• 2004/8/19：8/13〜8/19 16:00に配布していたファイルにバグがありました。すみません。修正したものをアップしましたので、そちらをご利用ください。（お知らせいただいた堀さんに感謝します）
• 2004/8/13：日本語のフィールド名に対応しました。当初配布したもの（Release 1）は、ファイルメーカーProで日本語のフィールド名を指定できませんでしたが、新たにRelease 2にアップデートします。
• 2004/6/5：FileMaker Pro 7には、従来までのXMLベースのWeb機能がないため、FX.phpは使えません。また、フォーマットが違うとかにしてもWebコンパニオンの仕様が公開されていないため、おそらくPro 7での利用は無理でしょう。また、Server 7にはWebアクセス機能がないので、Server 7 AdvancedでしかVer.7系列ではFX.phpは使えないでしょう。また、その場合もソースは作り直すことになるでしょう。
• 2004/4/11：ファイルメーカー東京ミーティングで『PHPからファイルメーカーProを利用する　FX.phpを日本語化』として発表をしました。レポート／プレゼンテーションと素材
• 2004/4/2：ファイルメーカー東京ミーティングが2004/4/11に開催されますが、FX.phpの日本語化についての解説をするつもりです。
• 2004/3/31：FX.phpの作者のChris Hansenさんより、メールの返事をもらえました。日本語対応についての感謝をいただき、加えて、今後のリリースでクレジットしてくれるということです。すでにファイルメーカーPro 7がリリースされておりUnicodeベースになっていることから、今後についてはどうしようかという話にもなっています。
• 2004/3/29：１週間近く前にiVikingにメールで「日本語化可能になった」と伝達してファイルを送ったのですが、何の返答もないので、こちらでアナウンスすることにしました。
• 2004/3/29：ファイルメーカーPro 6、Mac OS X 10.3.3という環境でしかチェックをしていませんので、何か留意点があれば、教えていただければ助かります。
• 2004/3/29：他の言語にも果敢にチャレンジしてください。報告をいただければと思います。