どんなWebアプリケーションでもエラー処理は重要だ。データベース側の処理をおこなう場合、かならず例外処理のことを考えてコードを書く。データベースにFileMakerを採用し、FX.phpを使用しているWebアプリケーションの場合はfoundCountやerrorCode、fxError、lastErrorCodeといった返り値をもとにエラー処理を実装することになる。

Webアプリケーションの開発中、このエラー処理を記述しているときに思わぬところでバグがでやすい。ご存知のとおり、FileMakerでは「レイアウト」や「テーブルオカレンス(TO)」といった独特の考え方がある。たとえばあるテーブルのあるフィールドにたいして-edit処理をおこないたいという場合「変更したいフィールドが指定したレイアウトに配置されていること」が条件になる。なにを今さら、な内容だが基礎中の基礎だけにトラブルのときに見過ごしやすい箇所のひとつだ。

FileMaker Webアプリの開発中、とくに発現しやすいFileMakerエラーとその対応策をまとめた。デバッグ時の参考にしてほしい。

とくに注意しておきたいのは100番台、401、500エラーだ。POSTされた内容をforeachでAddDBParam()で格納していたり、AddDBParamArray()で格納しているとこれらのエラーはなかなか切り分けができなくなる。返り値のURLやlastURLを解析しつつ、今回紹介したエラーコード早見表を参考にしてほしい。

ほんの数行で強力デバッグ! トラブル時のおともに - FX_Fuzzy_Debugger

FX.phpにはバージョン4.5以降、FX_Fuzzy_Debuggerと呼ばれる機能が用意されている。FXによるFileMakerへのリクエストが実行される前にDEBUG_FUZZYを定義しておくだけで、デバッグ用のメッセージが格納・表示されるという優れものだ。トラブル時にも迅速な切り分け処理ができるようになるため、ぜひ使いこなせるようになっておきたい。FX_Fuzzy_Debuggerの活用例は次のとおり。

PHPファイル - fm_fuzzydebug.php

<?php

define('DEBUG_FUZZY', true);

include_once('./fx/FX.php');
include_once('./fx/server_data.php');

$data = new FX($serverIP, $webCompanionPort, $dataSourceType, $scheme);
$data->SetDBData($databaseFileName,'fuzzyTest', 1);
$data->SetDBUserPass($webUN,$webPW);
$data->SetCharacterEncoding('utf8');
$data->SetDataParamsEncoding('utf8');
// 正しいフィールド名は「type」
$data->AddDBParam('typo', 'FX_Fuzzy_Debugger Test');
$data->SetRecordID(1);
$dataSet = $data->DoFXAction('update');

// DEBUG_FUZZYがtrueの場合は、デバッグメッセージを表示
if ( true === DEBUG_FUZZY )
{
    echo $data->lastDebugMessage;
}

// エラーコードの表示
echo '<p>' . $data->fxError . '</p>';

PHPの先頭側でdefine('DEBUG_FUZZY', true);とし、FileMakerエラーコードの表示前にデバッグメッセージを表示するようにしている。typeフィールドに文字列「FX_Fuzzy_Debugger Test」を格納するように記述しているが、スペリングミスで102エラーが返る。DEBUG_FUZZYを無効・有効にした場合の実行結果は次のとおり。

DEBUG_FUZZYをfalseとしている場合。FileMakerエラーコードが表示されているのみ	DEBUG_FUZZYをtrueとしている場合。FileMakerエラーコードの表示前に、FX_Fuzzy_Debuggerによって各種デバッグメッセージとエラーの対応策が表示されている

たった数行加えるだけでデバッグ/トラブルの原因切分時に有用なメッセージが表示されるのは心づよい。今回の例の場合だと、わざわざフィールド名の訂正までデバッグメッセージに含めてくれる。トラブル時に行き詰る前に、FX_Fuzzy_Debuggerの使い勝手をひととおり確認しておこう。