【応用その2】FX.php を使ったアンケートフォーム作成 --- 従来のファイルメーカー Pro データベースで Web アプリケーション作成

　サンプルデータベースと PHP ソースコードはこちらからダウンロードできます。（本アーカイブは、不定期に差し替えが行われる可能性があります。あらかじめご了承ください。）

　*FileMaker API for PHP を使ったアンケートフォーム作成をお読みになっていない方は、先にこちらをご覧ください。
　
　さて前回の FX.php 解説に引き続き、今回は FX.php を使って従来の FileMaker データベースにアクセスする方法について触れてみることにします。今回もまた、今まで使ってきたアンケートフォームにちょっと修正を入れるだけです。アンケートフォーム作成のおさらいが必要な方は、こちらを先にご覧ください。

　FileMaker API for PHP を利用するためには、FileMaker Pro 9 と FileMaker Server 9 がインストールされていることが条件となるため、従来に比べるとコスト的に敷居が高くなってきています。安定したデータサーバ運用を目指すのなら、もちろんこれらを導入するのが確実ですが、FileMaker Pro 5.x/6 で機能的に十分に満足している方には、ちょっと手が出にくいパッケージであることも確かでしょう。

　そこで、FX.php と FileMaker Pro 5.x/6 の Web コンパニオンプラグインを組み合わせてもデータベースへの書き込みを実現できるため、既存のシステムをそのまま Web 公開データベースとして活かすことも可能となります。
　ただし、通常版は 10 アクセスユーザ数（10 IP アドレス）という制限が伴うため、現実的な運用にあたっては FileMaker Pro 5.x/6 Unlimited が必要になることは注記しておきたいと思います。

　それでは実際に既存のサンプルコードを修正していくことにしましょう。
　処理は前回の FX.php 接続とほぼ同じですが、今回はそれに加え、文字コードの変換が必要となります。
　FileMaker Pro 9 では内部コードを UTF-8 で処理しているため、ソースが UTF-8 で記述されていれば問題はなかったのですが、FileMaker Pro 5.x/6 では内部コードを Shift-JIS で扱うため、このままデータを送るとエラーが起こったり、文字化けが発生してしまいます。

　そこで、今までの処理に文字コード処理を追加します。

1. FX を使用することを宣言する（FX インスタンスを作成する）。


2. 使用するデータベース名とレイアウト名を指定する。


3. 使用するユーザ名とパスワードを指定する。


4. データ送信時の文字コードを Shift-JIS に変換する。


5. 追加するフィールドと、そのデータを指定する。


6. レコード追加を実行する。
   

　上記を FX.php の記述規則に従って置き換えると、次のようになります。

　赤線を引いた部分と、赤で囲った部分が前回と異なってはいますが、その他はすべて同じです。
　指定の通り、FX インスタンス作成時に、使用するデータソース（データベース）が FileMaker Pro5.x/6 であることを知らせます。
　そして、データ送信前に文字コードセットを UTF-8 から Shift-JIS(SJIS) に置き換えます。

　ただし、FMP7/8/8.5/9 に対してこの文字コード変換を行うとデータ書き込みに失敗してしまうため、必要に応じて、データソースが FMPro5/6 のときだけ文字コード変換を行うという条件を追加する必要があります。
　この条件を追加するとこのようになります。

　変数 $databaseType には、コードの最初の方で予め "FMPro9" もしくは "FMPro5/6" のいずれかを設定しておきます。こうしておくことによって、使用するデータソースに応じて処理を切り替えられるので便利です。
　ソースの詳細は、サンプルコードをご覧になってみてください。

　先に PHP ソースについて解説しましたが、最後に FileMaker Pro 5.x/6 データベースファイルの作成と設定方法について説明します。

1.　データベースファイルを作成します。FileMaker Pro 5.x/6 を起動し、Comment.fp5 というファイルを作成し、以下のフィールドを作成します。

　[RecID]、[作成日]、[作成アカウント]、[修正日]、[修正アカウント]は管理用のフィールドですが、作成しておくと便利でしょう。

2.　レイアウト名を cgi に変更します。
3.　「アプリケーション環境設定」ダイアログを出し、プラグイン一覧より、Web コンパニオンにチェックを付けて「設定」ダイアログを開きます。

　セキュリティに「ファイルメーカー Pro アクセス権」を指定し、TCP/IP ポート番号に 80、もしくは 591 を指定します。

4.　ファイルの共有設定で、以下のようにチェックを付けることによって Web コンパニオンを公開します。


5. パスワードを指定します。図のように、web というパスワードを作成し、web で公開させる最低限のアクセス権を決めます。

　この他にフルアクセスを許可するパスワードが必要となりますので、ここでは Admin を作成してあります。

　以上で準備が整いました。
　FMPro5/6 用の設定を施した comment_fp5.php というファイルをサンプルに用意してありますので、参照してみてください。

参考: FX.php vs FileMaker API Benchmarks Discussion（英文）

【応用その1】FX.php を使ったアンケートフォーム作成

　本記事は2008年に FileMaker 9 の環境下で執筆されました。2016年11月現在、FileMaker の最新バージョンは 15 となっていますが、15 においても本記事の内容はなお有効と思われます。
　一方Ver 15 では WebDirect と呼ばれる 機能があり、これにより PHP などで Webプログラミングを行うことなく、 FileMaker デスクトップアプリとほぼ同様の操作がブラウザ上でも可能となります。WebDirect は開発が非常に楽になる半面、ライセンス費用やブラウザとの互換性等に問題があります。　したがって、高速開発性（RAD）を重視し、ブラウザ互換性をある程度無視できる環境では WebDirect は FX.php の代替となる可能性があります。

 参考： アンケートシステム・プロトタイプ

　*FileMaker API for PHP を使ったアンケートフォーム作成をお読みになっていない方は、先にこちらをご覧ください。

　さて、前回まで 4 回にわたって FileMaker API for PHP によるアンケートフォームの作成方法を解説してきましたが、今回はさらに FX.php による FileMaker データベースアクセス機能も実装してみることにします。

　FX.php はiViking.org によって無償で提供されている FileMaker アクセスクラス群で、FileMaker Pro 5～ 9 に幅広く対応しているため、FileMaker API for PHP が実現できない環境のユーザでも FX.php を使うことによって php からのアクセスが可能となります。

　インストール方法も簡単で、ダウンロードして解凍した FX フォルダを Web サーバの適当な場所に配置するだけです。

　それでは実際にやってみましょう。
　Comment.fp7 を開き、「アカウントとアクセス権の管理」ダイアログを出し、そこからすでに登録済の Webuser を選択して「アクセス権セット...」を選択して以下のダイアログを開きます。

　FX.php は xml によるデータアクセスを行いますので、反転部分のように、「XML Web 公開でのアクセス- FMS のみ(fmxml)」にチェックを付けて保存します。

　これで FileMaker の FX.php 向け Web 公開の準備が整いました。

　さて、次は FX.php 向けのコードを追加していきます。
　まずは、コードの最初の方で FX.php をロードします。今ある Comment.php から FX.php が辿れるように設定してください。

　require_once '../../FX/FX.php';

　そしていつものように、日本語で手順を考えてみます。

1. FX を使用することを宣言する（FX インスタンスを作成する）。


2. 使用するデータベース名とレイアウト名を指定する。


3. 使用するユーザ名とパスワードを指定する。


4. 追加するフィールドと、そのデータを指定する。


5. レコード追加を実行する。

　
　こうして見てみると、前回のデータベース書込手順とほとんど変わらないことがわかりますね。
　あとは上記の内容を FX.php 向けに書き換えていくだけです。

　一行目のデータベース接続にサーバ名、ポート番号、データソース名（FMpro9）を明示的に指定する必要がありますが、その他メソッド名に差異はあるものの、前回の FileMaker API for PHP のコードとさほど形式が変わらないことがおわかりいただけるでしょう。

　サンプルコードの方に FX.php と FileMaker API for PHP の切り替え操作も盛り込んでありますので、併せて確認してみてください。


※サンプルコード
サンプルデータベースと PHP ソースコードはこちらからダウンロードできます。（本アーカイブは、不定期に差し替えが行われる可能性があります。あらかじめご了承ください。）

FileMaker API for PHP を使ったアンケートフォーム作成 (4/4)

　本記事は2008年に FileMaker 9 の環境下で執筆されました。2016年11月現在、FileMaker の最新バージョンは 15 となっていますが、15 においても本記事の内容はなお有効と思われます。
　一方Ver 15 では WebDirect と呼ばれる 機能があり、これにより PHP などで Webプログラミングを行うことなく、 FileMaker デスクトップアプリとほぼ同様の操作がブラウザ上でも可能となります。WebDirect は開発が非常に楽になる半面、ライセンス費用やブラウザとの互換性等に問題があります。　したがって、高速開発性（RAD）を重視し、ブラウザ互換性をある程度無視できる環境では WebDirect は FileMaker API for PHP の代替となる可能性があります。

 参考： アンケートシステム・プロトタイプ

ブラウザとの互換性等に問題があります。　したがって、高速開発性（RAD）を重視し。ブラウザ互換性をある程度無視できる環境では WebDirect は FileMaker API for PHP の代替となる可能性があります。
　サンプルデータベースと PHP ソースコードはこちらからダウンロードできます。（本アーカイブは、不定期に差し替えが行われる可能性があります。あらかじめご了承ください。）

　さて、今回がアンケートフォーム作成の最終回となります。
　ステップ 1 から渡ってきたユーザ入力データをここでデータベースに登録し、続いてその内容をメール送信します。

　コードの記述に入る前に、FileMaker データベースを用意する必要があります。
　以下の手順に従ってください。

1.　FileMaker Pro 9 よりComment.fp7 という名前のファイルを新規作成します。
2.　以下の図を参考にしながらフィールドを作成します。

　アンケート入力ページで実際に使用するのは、[氏名]、[email]、[回答]、[その他回答]、[意見など]の5 つだけですが、残りのフィールドはデータベースを管理する際に作っておくと便利ですので、最初の段階で用意しておきます。
3.　「アカウントとアクセス権」ダイアログを開き、webuser というユーザを追加します。
　パスワードを入力（サンプルデータベースでは web となっています）し、[アクセス権セット]では、「新規アクセス権セット...」を選択します。以下のように入力していきます。

　ここで最も重要なのは、ダイアログの一番下に表示されている[PHP Web 公開でのアクセス - FMS のみ (fmphp)]にチェックが付いていることです。これによって、FileMaker Server 9 への PHP によるアクセスを有効にします。
　また、[レコード]の欄で「カスタムアクセス権...」を選択することによって、レコードへのアクセス範囲を設定することもできます（任意）。
4.　デフォルトのレイアウト名が Comment になっていますので、cgi に変更します。
5.　ここまで終わったら、このデータベースファイルを FMS9 の Databases フォルダに入れて公開します。

　これでデータベースの準備が整いましたので、今度はアンケート入力の PHP コードの方に Comment データベース書き込みの処理を追加していきます。

まずは、コードの最初の方で FileMaker.php をロードします。

　require_once 'FileMaker.php';

　API for PHP による FileMaker データベースへのデータ書き込み手順を日本語で書くと、次のようになります。

1. FileMaker を使用することを宣言する（FileMaker インスタンスを作成する）。


2. 使用するデータベース名、レイアウト名、ユーザ名、パスワードを指定する。


3. レコード追加をこれから行うことを宣言する。


4. 追加するフィールドと、そのデータを指定する。


5. レコード追加を実行する。

　このように日本語で書いてみると、操作は思ったより単純であることがわかりますね。
　あとは上記の内容を PHP の記述規則に従って置き換えるだけです。

　日本語で何をやっているかが理解できれば、この PHP ソースも容易に理解できるでしょう。
　$databaseName、$layoutName、$userName、$passWord というように変数を用意しておくことで、後でデータベース名や、ユーザ名、パスワードが変更になったときにも柔軟に対応できるようになっています。
　一番最後の行の $newrec->execute(); で実際に FileMaker データベースの方にレコードを新規追加します。

　最後にメール送信機能を追加します。
　すでにご存じのように、メールは差出人（From）、宛先(To)、件名(Subject)、本文(Body)、ヘッダ情報で成り立っています。これと同様の指定をコーディングの中でも行います。後でいつでも変更できるように、以下のように変数に入れておくと便利です。
　


　宛先(To)はアンケートに回答してくれた人のメールアドレスになりますので、ここでは指定しません。
　アンケート回答者にメールを送信すると同時にそのコピーをサーバ管理者に送るようにするには、上記のように $bcc 変数を用意して、そこにコピーを送るメールアドレスを設定しておきます。

　それでは実際にメールを送信するための手順を日本語で書いてみます。

1. メールヘッダを組み立てる。


2. アンケートに対するユーザ回答を使って本文を組み立てる。


3. メール送信時に発生する文字化け対策を施す。


4. 上記の内容を使ってメールを送信する。

　上記を PHP で置き換えると、次のようになります。


　$_POST の中にユーザ入力の内容が納められていますので、その中から該当するものを取り出しながら本文を組み立て、mb_sendmail() 関数の To の部分に回答者のメールアドレス $_POST['email']を設定します。

　上記を踏まえながら、サンプルコードを確認し、Comment.fp7 データベースをお使いの FMS9 環境に配置して、動作を確認してみてください。

　これで、FileMaker API for PHP による FileMaker データベースへの書き込み操作がひととおりできるようになりました。

　あとは、ステップ 1 のときと同様に、渡ってきたデータをお礼ページに表示するだけです。
　詳細は、サンプルコードを参照してみてください。

*サンプルデータベースの Admin パスワードは「admin」、webuser パスワードは「web」となっております。必要に応じて変更してお使いください。

●まとめ
　FileMaker データベースへのデータ書込の理解
　メール送信の理解