goddess-gate.com

■見つけたサンプル

以下のサイトのサンプルコードと解説のとおりに作ってみたところ、iCloud同期が実際に確認できた。すごく良い記事である。

→ iOS How-To : Using Core Data with iCloud

なお、上記の記事にあるように Provisioning Profileが必要なので当然だが、iOSシミュレータではiCloudは使えない。実機が必要。

Entitlement

■Entitlementの書き方

上記の記事のように、まず AppIDを取得し、iCloudを Enable にして、Provisioning Profileを作りXCode4にインストールする。

次の手順、XCode4でEntitlementを有効にすると、Entitlementの iCloud-Key-Value や iCloud Containers の値には project bundle identifierだけが自動で追加される。上記のgoddess-gate.comの記事のスクリーンショットでは Individual IDである GBBYECND9 も含めているが、Xcode 4.2.1のデフォルトで生成される設定では、 Individual IDを記述せずbundle identifierだけ書くのでよいようだ。

Xcode 4.2.1 では .entitlements ファイルを見てみると、com.apple.developer.ubiquity-kvstore-identifier は $(TeamIdentifierPrefix)com.xxxxx.AppName のようになっていて$(TeamIdentifierPrefix)が自動で入るようになっているからだ。
これにあわせて

- (NSPersistentStoreCoordinator *)persistentStoreCoordinator

の中の、cloudURLの値には、

NSURL *cloudURL = [fileManager URLForUbiquityContainerIdentifier:@"GBBYECND9.com.xxxx.AppName"];

のように設定することになる。

なお、 $(TeamIdentifierPrefix)com.xxxxx.AppName の$(TeamIdentifierPrefix)とcom.xxxxx.AppName の間にはピリオドがないから、 @”GBBYECND9com.xxxx.AppName”ではないの？と思ったが、ピリオドは勝手に入るらしい。実はこの誤解で多分30分くらいは無駄にした僕。

■iCloud対応はstoreURLの指すデータのoptionなのだなあ

ここに書かれている、

- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {}

の中身を改めて読むと、iCloud対応はstoreURLのoptionなのだなあと気づく。

options = [NSDictionary dictionaryWithObjectsAndKeys:
[NSNumber numberWithBool:YES],
NSMigratePersistentStoresAutomaticallyOption,
[NSNumber numberWithBool:YES], NSInferMappingModelAutomaticallyOption,
@”AppName.store”, NSPersistentStoreUbiquitousContentNameKey,
cloudURL, NSPersistentStoreUbiquitousContentURLKey,
nil];
if (![psc addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:options error:&error]) {}

というのはつまり、僕は最初誤解していて、iCloudではiCloud用のsqliteファイルをiCloud上に別途作ってそれはそれで自分で管理するものと思っていたのだが、そうではなく storeURLというローカル（iPhone本体）に作ったsqliteファイルがあくまで主体としてあって、そのオプション設定としてiCloudがあるということが、コードから分かる。

このことが何を意味するかというと、iCloudに通信でつながらないときでも、storeURLが指すローカルのデータベースをガシガシ変更できて、そして後で通信がつながったときに、iOS5 が iCloud側のデータ同期を自動でしてくれるらしいということだ。実際に実験してみたらそのようになっていた。すごい！

■CoreDataの設計を変えたり、やり直しをしたい場合

cloudURLにはどんな値がはいっているのだろう。デバッガでトレースして見てみると、

file://localhost/private/var/mobile/Library/Mobile%20Documents/GBBYECND9~com~xxxxx~AppName…

みたいな値が入っている。

iCloud用にローカルにファイルを作っているみたいだ。一時ファイルのようなものだろうか。
CoreDataの設計を変えたり、やり直しをしたい場合にこれを消さなくてもいいのだろうか？というのが真っ先に起こる疑問だ。

実際、やり直しをするときにpersistentStoreCoordinatorの中でクラッシュしてしまうことがあった。そのような場合は、

1. アプリをiPhoneから削除
2. iOS設定のiCloud設定の「ストレージとバックアップ」＞「ストレージを管理」で「書類およびデータ」のところにある自分の生成されたファイルを削除

設定＞ストレージ管理

というのをするのに加えて、

[[NSFileManager defaultManager] removeItemAtURL:cloudURL error:&error];

というのをしておいた方がいいのかも知れない。この削除に関しては以下のページに書かれていた。

→ Crash when adding persistent store (iCloud enabled) in app delegate

■2台のデバイスで試してみる（つづく）

2台のデバイスで試してみた。
両方でこの同じアプリを開いて、一方で更新してみると、数秒後にはそれがもう一方に反映される。感動的。

次に、一方を「機内モード」にして通信を遮断し、データを追加してみる。追加はこの上で問題なくできる。「機内モード」を解除して、しばらく待つと、それらのたまった変更が一気にもう一方に反映される。すごい。

しかし、何らかの原因で、双方のデータに矛盾が生じると、とたんに同期が止まる。多分どちらかはiCloudとは同期しているのだろう。iCloudと矛盾のある方が同期しなくなる。

上記のソースコードでは、こういう状況に対して何のエラーメッセージも用意されていない。これが次なる課題。矛盾があるとき、何らかのエラーメッセージを出してユーザーに解消方法を選んでもらうような処理を追加する必要があると思われる。

この課題について「その２」を書く予定です。

さて、まず Documentsフォルダ以外に置くならどこに置けばよいのか。
Core Data and iTunes File Sharing – Move/hide the .sqlite file on app update?
の議論によると、そのアプリのフォルダ下の NSApplicationSupportDirectory すなわち /Library/Application Support フォルダがよいようだ。

次に、この変更をプログラムのどこで指定すればいいのか。MyAppというプロダクトなら、最初に動く、MyAppAppDelegate.m があって、この中に storeに関する以下のmethodがある。
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator { … }
この中で、デフォルトでは以下のようにsqliteファイルのURLが設定されている。

NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@”MyApp.sqlite”];

これの[self applicationDocumentsDirectory] がDocumentsフォルダへのパスを返しているのだとわかる。これを/Library/Application Support フォルダを返すものに変えればいいわけだ。

重要なヒントは以下のサイトに書かれていた。
Where to Store Persistent Files in iOS 4?

NSApplicationSupportDirectoryを取得するメソッド applicationSupportDirectoryを作って、上記のデフォルトの [self applicationDocumentsDirectory] を[self applicationSupportDirectory] に差し替えればよいと書かれているのだとわかる(実際はNSStringをNSURLにも変えなければならない：後述）。

ここに書かれているサンプルコードでは、親切にも/Library/Application Support フォルダがまだない場合は生成する処理も書いてある。ところが惜しいことに、ここに書かれているcreateDirectoryAtPathの記述は少しだけ間違っている。また、NSStringもNSURLにしなければならない。

以下のページを参考にさせていただくと下のコードのようになるようだ。
Persistent store migration failed missing source managed object model

ここでは applicationSupportDirectory というメソッドを作らずに直接書く形にした。

NSString *applicationSupportDirectory = [NSSearchPathForDirectoriesInDomains(NSApplicationSupportDirectory, NSUserDomainMask, YES) lastObject];
NSError *error = nil;
if ( ![[NSFileManager defaultManager] fileExistsAtPath:applicationSupportDirectory isDirectory:NULL] ) {
  if (![[NSFileManager defaultManager]
        createDirectoryAtPath:applicationSupportDirectory
        withIntermediateDirectories:NO
        attributes:nil
        error:&error]) {
    NSAssert(NO, ([NSString stringWithFormat:@"Failed to create App Support directory %@ : %@", applicationSupportDirectory,error]));
    NSLog(@”Error creating application support directory at %@ : %@”,applicationSupportDirectory,error);
    return nil;
  }
}
NSURL *storeURL = [NSURL fileURLWithPath: [applicationSupportDirectory stringByAppendingPathComponent: @"MyApp.sqlite"]];

もともとあった

NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@”MyApp.sqlite”];

を、上記の数行に置き換えることで、/Library/Application Support フォルダにsqliteファイルを置くようにすることができる。

蛇足：NSApplicationSupportDirectoryでのフォルダ生成について調べていたら、以下のようなツールを提供しているサイトを見つけた。
Finding or creating the application support directory
とても便利なツールで、このサイトから
NSFileManager+DirectoryLocations.h
NSFileManager+DirectoryLocations.m
をダウンロードして、自分のプロジェクトに組み込み、
#import “NSFileManager+DirectoryLocations.h”
して、後は、
NSString *path = [[NSFileManager defaultManager] applicationSupportDirectory];
とやるだけで、必要なフォルダのパスが返ってくるだけでなく、もしフォルダがなければ自動生成してくれる。ただし、これはどうもマックのアプリ用だと思う。と言うのも、返ってくるのは/Library/Application Supportにさらにアプリの名前を付けたフォルダ名、例えば/Library/Application Support/MyApp フォルダとなるようにできているからだ。
いつか使う日が来るかも知れないのでここにメモっておく。

davemeehan.com

インスタンス変数とプロパティの名付け方

ここではコード内で変数の名付け方について書いたよ。君のプロジェクトやObjective-Cの理解に役立てば幸甚。このとは僕はあちこち見てまわったたり、アップルのドキュメントも見てみたんだけどぴんとこなかったんだ。だから、サンプルコードとか見ても、どういうことなのか分かるのに時間がかかったことなんだよ。

インスタンス変数にはアンダースコアを付ける

クラスでインスタンス変数にプレフィックスとしてアンダースコアを付けるのは
・まず、インスタンス変数はデフォルトでprotectedだから、それはそのクラスとサブクラスからしかアクセスできないものだということ。
・で、インスタンス変数へは、そのクラス（あるいは親クラス）から self. を付けなくても直接参照できることになっているから、見分けがつくのが、面倒くさいことにならなくていいよね。

@interface MyObject : NSObject {
    NSArray *_arrayOfThings;
}

-(void) myMethod;
@end

@implementation MyObject

-(void) myMethod {
    for (id item in _arrayOfThings) {
        // do something ...
    }
}
@end

上の例で、インスタンス変数に直接アクセスしてるでしょ。アンダースコアがあるおかげで、これが、このインスタンスに属しているもので、メソッドのパラメータでもローカル変数でもないことがわかるわけだ。もちろん、ほかの方法でインスタンス変数と分かるようにしたってかまわないね。例えば ‘member variables’ の頭文字を取って、 mArrayOfThings ってやる人もいるだろう。

‘Local Declaration of <var> Hides Instance Variable’というコンパイラ警告の回避方法

さて、僕が気づいた問題になる状況というのは、デリゲート・メソッドとの競合がある場合だ。SDKのサンプルは明確にしてくれてないので、だいぶ手こずったよ。以下のような場合だ。

@interface MyTableViewController : UIViewController  {
    UITableView *tableView;
}

@property (nonatomic,retain) IBOutlet UITableView *tableView;

@end

@implementation MyTableViewController

@synthesize tableView;

-(UITableViewCell *) tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    // パラメータの 'tableView' がここではインスタンス変数の 'tableView' をマスクしてしまう

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier: @"ident"];

    // だもので、上の行はコンパイラの警告がでる行になってしまうね

    //...
}

@end

上のはごく普通にあるコードで、インスタンス変数とインターフェース・ビルダーのオブジェクトとしてプロパティを定義している。インスタンス変数の名付け方がデリゲートメソッドのパラメータをマスクしてしまって問題になるのははっきりしてるね。

プロパティ名とインスタンス変数名は違うものにしたほうがいいんだ

そこで、インスタンス変数にアクセスするときは、プロパティを使ってドット演算子で記述すればいいじゃんって君は思うだろう（例えば self.myInstanceVariable って感じで）。そのためにドット演算子はあるのさ。普通に @synthesize を使えばmyInstanceVariableとかsetMyInstanceVariableといったgetter/setterメソッドを自動生成できることだし。

そう、@synthesize を使えば getter/setter は生成される。でも、それは普通はインスタンス変数名と同じ名前するものだと思ってたんじゃないかい。実は、君は、@synthesize の名前をリダイレクトするように書くこともできるんだよ。つまり、

@synthesize myInstanceVariable = _myInstanceVariable;

って感じ。これで、アンダースコア付きのものはインスタンス変数で、付いてないのはプロパティってことになるわけ！そうすると以下のようにできるんだね。（★印のコメントのところに注目）

@interface MyTableViewController : UIViewController  {
    UITableView *_tableView;
}

@property (nonatomic,retain) IBOutlet UITableView *tableView;

@end

@implementation MyTableViewController

@synthesize tableView = _tableView;

-(UITableViewCell *) tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

    // ★以下はメソッドのパラメータである 'tableView' への参照

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier: @"ident"];

    // ★以下はクラスのプロパティである 'tableView' への参照（間接的にインスタンス変数になる）

    UITableViewCell *cell = [self.tableView dequeueReusableCellWithIdentifier: @"ident"];

    // ★以下は、インスタンス変数である '_tableView' への直接参照

    UITableViewCell *cell = [_tableView dequeueReusableCellWithIdentifier: @"ident"];

    //...
}

@end

さて、光悦と宗達による金銀泥下絵の和歌巻にはいくつかのシリーズ作品があります。畠山記念館では「金銀泥薄下絵古今和歌巻」を見ることができました。この下絵は宗達本人なのか弟子のものかどうかは不明ですが、本阿弥光悦の書で、彼のディレクションのもとに作成された、とてもシンプルなしゃれた作品です。

他にも、畠山記念館には「金銀泥四季草花下絵古今集和歌巻 」（重要文化財）があり、出光美術館には「蓮下絵百人一首和歌巻」の断簡（後の世の人が掛け軸などにするために長い巻物の部分を切り取ってしまったもの）や、「月に萩・蔦下絵古今和歌巻」「花卉摺絵(かきすりえ)古今和歌巻」といったものがあると図録には載っていました。これらは実際には見ることはできませんでした。
既に見ていたのは、前のログにも書いた神戸市博物館に来た「鹿下絵和歌巻」（シアトル美術館蔵）と京都国立博物館の「日蓮展」で展示されていた「鶴下絵三十六歌仙和歌巻」（京都国立博物館蔵）の一部分でした。

いずれも、一種のグラフィックデザイン的であるという点でとても面白いと僕は感じます。例えば、同じように装飾絵画としての主流であった狩野派の作品とは明らかに違っています。その違いとはなにかというと、例えば、画面構成におけるリズム感であり、リズムを作り出すために空間の切り出し方や物体の抽象化（デフォルメ）についてあえて思い切ったことをしています。そこが絵画というよりグラフィックデザイン的であるゆえんだと思います。

下絵和歌巻ではないですが、それを端的に示しているのが、宗達の「蔦の細道図屏風」だと思います。画面の背景は緑の丘のように見えるのですが、その手前で画面の左上から右下に掛けて空間が裂けて開けているようになって、その中に蔦が向こう側の空間を垣間見るような感じで垂れ下がっている、みたいな構成になっています。もはやSFチックですらあります。

でもそもそも、グラフィックデザインというものは現代的な発想であると僕は思い込んでしまっているのかもしれません。だから、あの時代にこんなものが！と思って面白いと感じてしまうのですが、実際には、人間のデザイン発想は近代的な部分では少なくとも数百年前とはそれほど変わっていないのかもしれません。変わったのは、それを表現する技術（例えばコンピュータ）やそれを生み出す組織力（これも一種の技術ですが）に過ぎないというわけです。そして、例えばこれから千年もすれば、僕らは江戸時代前期、あるいは中世くらいの時代の人間と同じくくりの中で分類されるのかもしれません。ここら辺の人間はほぼ同時代人というわけです。

「金銀泥四季草花下絵古今集和歌巻 」と「月に萩・蔦下絵古今和歌巻」を図録でみると、前者はその冒頭がすごい竹の幹のクローズアップで始まっており、後者は、満月を表すすごく大きな銀の円が冒頭でいきなりどーんと現れ、そして四季の草木や月に照らされた萩へと巻物の絵がまるでカメラがパンしていくかのような構成になっています。現代の映画やアニメーションででもありそうな構成だと感心します。でも、それは現代的であるというより、実際には、ひとつのデザイン的なあるいは音楽的な物語構成について近代人（もしかすると中世も含む）が持つ原型みたいなものなのかもしれないと思うのでした。逆にいうと、宗達の作品にはそういうことを見いだせる要素がいくつもあるように思います。そういうところが宗達を興味深いと思えるひとつの要因なのかもしれません。

プログラム構成

以下の3つのクラスファイルとユーティリティで構成されています。
- xmlbulletin.class.php : いわゆるコントローラにあたります
- xmlbulletin.model.php : XMLへの入出力を担います
- xmlbulletin.view.php : 一覧や入力フォームの表示を担います
- utility.php : 翻訳機能やバリデーションのヘルパー機能を提供します

以下は、同梱されているサンプルです。
- xmlbulletin.php : 利用ページのサンプルです
- xmlbulletin.css : CSSサンプルです
- local.ja : 日本語への翻訳テーブルのサンプルです
- bbs.php : 電子掲示板を拡張する「拡張クラス」のサンプルです
- atom.php : ATOMフォーマットを扱う「拡張クラス」のサンプルです
- rss20.php : RSS2.0フォーマットを扱う「拡張クラス」のサンプルです

起動方法

上記サンプル xmlbulletin.php を使う場合、以下のように普通にブラウザでURL指定すると、デフォルトの掲示板になります。

http://www.example.com/xmlbulletin.php

　
いろいろなパタンのXMLに対応させるために「拡張クラス」を使えますが、「拡張クラス」をソースの中でインクルードする必要はありません。下記のように / (スラッシュ）で区切って呼び出せば、インクルードされるようになっています。「拡張クラス」の作り方は後半で詳しく説明します。

bbs.phpを使う→ http://www.example.com/xmlbulletin.php/bbs/
atom.phpを使う→ http://www.example.com/xmlbulletin.php/atom/
rss20.phpを使う→ http://www.example.com/xmlbulletin.php/rss20/

サンプル表示例

下図がサンプル「拡張クラス」のbbs.php での表示例です。CSSはデフォルトのxmlbulletin.css を使った表示例を下に示します。（なお、xmlbulletin.cssは ‘display:inline-block’ を使っているためIE6, IE7では表示は崩れます。またIE8ではボタンが角丸ボタンになりません）各図はクリックで拡大表示します。

カラム一覧表示例

ページ下部のページ移動ボタン

リスト表示

新規および編集

翻訳機能の役割

サンプルには local.ja というファイルがあります。xmlbulletinは基本的に表示は英語で作成されています。クラスファイルと同一ディレクトリにlocal.jaという名前のファイルを置くと、この中に記述されている翻訳テーブルに基づいて自動的に日本語表示になります。試しに、ファイルlocal.jaを削除して起動すると以下のようにボタンなどが英語表示の画面になります。

locale.jaを外した表示

例えば、locale.ja内には以下のような記述があります。

“OK” = “実行”
“Cancel” = “キャンセル”
“Submit” = “登録”
“INDEX” = “一覧へ”
“Are you sure?” = “続行しますか？”
“ERROR” = “エラー”
“EDIT” = “編集”
“VIEW” = “詳細”
“DELETE” = “削除”
“UP” = “△”
“DOWN” = “▽”
“ADD” = “新規”
“LIST MODE” = “リスト表示”
“COLUMN MODE” = “カラム一覧表示”
“|&lt;TOP” = “|≪トップ”
“&lt;PREV” = “≪前へ”
“NEXT&gt;” = “次へ≫”
“LAST&gt;|” = “最後≫|”
“[%d/%d]” = “%dページ/全%dページ”

逆に言えば、これらのボタンなどの表示名を変更したり、何かのスタイルを付加したい場合にはプログラムソースの変更は必要なく、locale.jaを変更していただければよいことになります。
また、locale.ja の .ja はブラウザの言語環境に対応しています。 具体的には、$_SERVER['HTTP_ACCEPT_LANGUAGE']で取得される文字列の最初の2文字に対応させています。日本語環境ではsafariなどでは ‘ja’ そのものが、FireFoxなどでは ‘ja_JP’ が取得されますので、これらに関して ‘locale.ja’ が採用されます。英語環境なら ‘en’ あるいは ‘en-us’ などが取得されるので、 ‘locale.en’ を作れば、英語表示の変更にも使えます。locale.ja と locale.en の両方を設置しておけば、それぞれの環境で違った表示にすることができます。
なお、locale.ja については現状試験的な機能です。将来的にファイルの記述フォーマットや設置位置の仕様変更の可能性があります（WordPressなどで使っているgettext.phpを検討中）。

自分のPHPへのxmlbulletinの組み込み方法

添付の xmlbulletine.php は、組み込み方のもっともシンプルな一例です。現実問題としては、サイドバーのあるページや、その他いろいろな要素を持つページの中に掲示板を組み込みたいところだと思います。以下のようにPHPコードを挿入すれば、基本的にどんなPHPにもこのシステムを組み込むことができます。
１）ファイルの冒頭に記述
以下のコードを必ず冒頭で行ってください。

<?php
  include_once(“utility.php”);
  include_once(“xmlbulletin.class.php”);
  $xb = new Xmlbulletin;
?>

２）タイトルの記述
必須というわけではないですが<title>タグに以下のように記述すれば、「拡張クラス」毎に設定したタイトルになります。

<title><?php echo $xb->error ? __(‘ERROR’) : __($xb->model->title); ?></title>

３）<head>内に記述
以下を<head>内に記述することで、デフォルトまたはカスタマイズしたCSSファイルへのlinkを挿入することができます。

<?php echo $xb->html_head; ?>

４）掲示板の表示
掲示板を表示する場所に以下のコードを挿入してください。

<?php
  if($xb->error) {
    echo __($xb->error);
  } else {
    $xb->display();
  }
?>

以上のコード挿入を行ってください。
xmlbulletineのセットのファイル群をそのPHPファイルと同じディレクトリにおいて、そのPHPファイルをブラウザで呼び出します。「拡張クラス」を作った場合は / (スラッシュ)で区切って指定します（※「起動方法」参照）

「拡張クラス」の作り方

さて、いよいよいろいろなXMLフォーマットに対応させるための「拡張クラス」の作り方です。「拡張クラス」を適切に記述することで、XMLの構造の指定やアイテムへの属性の付加、入力バリデーション設定、および表示フォームのタイプやオプション項目の指定などを行うことができます。
「拡張クラス」ファイルには2つclassのextendsを記述します。XMLファイルへの入出力を行うclass XmlbulletinModel のextendsクラスの部分と、一覧や入力フォームの表示を行うclass XmlbulletinView の extendsクラス部分です。
bbs.php の全容を見るとざっと下図のような構成です。各変数にいろいろな決まりがある（後述）のですが、要素としてはコレで全部ですので、それほどややこしくはないと思います。

「拡張クラス」構成例概観（クリックで拡大）

拡張クラス model の書き方

class XmlbulletinModel の拡張クラスとしてclass modelを作ります。class名は modelでなければなりません。
以下の既定の変数を記述します。必須でないものは省略しても結構です。各変数について、後に詳述します。

$title

ページのタイトルとなる文字列を記述します。翻訳機能の対象になっています。もちろん翻訳機能を使わない場合は日本語でそのまま記述しても結構です。

public $title = "Bulletine Board System";

$fore

XMLにはたいていの場合、データ本体となる繰り返しのアイテムの前に親または同レベルのノードとしてタイトルなどを記述します。その部分の構造を配列で記述します。配列は階層構造になっても大丈夫です。その構造がそのままXMLの構造として反映されます。これは必須です。
配列のkey名がタグに、valueがそのタグの内容になります。
value側にはXML生成時に設定されるデフォルトの文字列を記述できます。
この文字列には、｛｝（中カッコ）でくくってPHPの何か値を返すファンクションを含めることができます。例えば{date(“Y-m-d”)}とすれば、このXMLの生成時の日付が入ります。

public $fore = array(
	'bbs' => array(
		'title' => 'Bulletine Board System',
		'subtitle' => '',
		'updated' => '{date("Y-m-d H:i:s")}',
		'id' => 'tag:smallmake.com,{date("Y-m-d")},{uniqid()}',
		'generator' => 'xmlbulletine'
	)
);

$fore_attributes

$foreで記述したノードにXML生成時にXML属性を付加することができます。ここでは構造を表すのには配列を使わず、パス記述でノードを指定します。例えば、ルートであるbbsの下のsubtitleのノードのパスは ‘/bbs/subtitle’ となります。このパスをキーとして、その下に配列をつくり、その配列のkeyで属性名、valueで属性値を指定します。

public $fore_attributes = array (
	'/bbs/subtitle' => array('type' => 'html')
);

$item_parent

この後のアイテムノードの親ノードの名前を指定します。親ノードは$foreに記述されていて、それを指していなければなりません。これは必須です。

public $item_parent = "bbs";

$item

アイテムのノード構造を配列を使って記述します。$foreと同様、配列のkey名がタグに、value側にはアイテムの生成時に設定されるデフォルトの文字列を記述できます。｛｝（中カッコ）での記述は$foreと同様です。

public $item = array(
	'entry' => array (
			'title' => '',
			'id'		=> 'tag:smallmake.com,{date("Y-m-d")},{uniqid()}',
			'published' => '{date("Y-m-d H:i:s")}',
			'author' => array(
				'name' => '',
				'uri'  => '',
				'email' => '',
				'gender' => '',
				'age' => '',
				'pc' => ''
			),
			'content' => ''
		)
);

$item_attributes

$itemで記述したノードにアイテムの生成時にXML属性を付加することができます。ここでは構造を表すのには$fore_attributesと同様に配列を使わず、パス記述でノードを指定します。
“type”=”html”属性はこのシステムでは重要な役割をします。”type”=”html”属性のノードは、カラム一覧やリスト表示の時にHTML特殊文字をエスケープしないように出力されます。例えば、新規や編集フォームで
「<a href=”http://www.smallmake.com”>このサイト</a>」
と入力して登録すると、カラム一覧やリストでの表示は”type”=”html”属性のある項目の場合
「このサイト」
と表示され、この属性のないものはそのまま
「<a href=”http://www.smallmake.com”>このサイト</a>」
と表示されることになります。

public $item_attributes = array(
    'entry/content' => array('type' => 'html')
);

$item_validations

バリデートしたいノードをパスで指定します。バリデートしたいものだけ記述すればよいです。そのノードパスをkeyとする配列を作り、その下にさらに配列を作り、そのkeyとしてバリデートしたいルールを、そしてその　valueにバリデーションの結果エラーとなったな場合のメッセージを記述します。ただし、ルールに何らかの条件値を設定しなければならない場合（例えば最大値や最小値の比較バリデーション）は、valueをさらに配列にして’param’=>でその条件値、’message’=>でエラーメッセージを指定します。つまり以下の2パターンがあるということです。
１） ’ノードパス’ => array(‘ルール’=>’エラーメッセージ’);
２） ’ノードパス’ => array(‘ルール’=>array(‘param’=>’条件値’, message=>’エラーメッセージ’);
バリデーションで指定できるルールと条件値などの一覧は下図を見てください。

public $item_validations = array(
  'entry/title' =>         array('require'=>'Title is required.'),
  'entry/published' =>     array('date'=>array('param'=>'Y-m-d H:i:s',
                                'message'=>'Invalid Date format(need Y-m-d H:i:s)')),
  'entry/author/name' =>   array('require'=>'Your name is required.'),
  'entry/author/uri' =>   array('url'=>'Invalid Site URL format.'),
  'entry/author/email' => array('require'=>'Your E-Mail is required.',
                                'email'=>'Invalid E-Mail format.'),
  'entry/author/gender' =>   array('require'=>'Select your gender.'),
  'entry/content' =>      array('require'=>'Comment is required.')
);

拡張クラス view の書き方

class XmlbulletinView の拡張クラスとしてclass viewを作ります。class名は viewでなければなりません。
以下の既定の変数を記述します。全て省略可です。省略した場合、デフォルトもしくは無設定になります。各変数について、後に詳述します。

$edit_mode

これは編集用のボタンを表示するかどうかの指定です。閲覧だけする人たちのために用意したページでは「新規」「編集」「削除」といったボタンは不要です。そのような場合、FALSEにすると表示しません。
TRUE : 編集用のボタン等を表示
FALSE : 編集用のボタン等を隠す

public $edit_mode = true;

$sort_mode

カラム一覧やリスト表示の表示順の指定です。
ascending : アイテムを入力した順に表示（古いものから順に表示）
descending : アイテムを入力した順の逆順に表示（新しいものが上）

public $sort_mode = "descending";

$line_per_page と $column_per_page

カラム一覧およびリスト表示のページングをします。1ページに表示する件数を指定できます。
$line_per_page : リスト表示の場合の1ページの件数
$column_per_page : カラム一覧表示の場合の1ページの件数

public $line_per_page = 10;
public $column_per_page = 5;

$item_styles

フォームの要素のタイプ、ラベル、オプション値の一覧などの指定ができます。配列のkeyでノードパスで指定し、そのvalueを配列にして、keyで設定内容、valueで設定値を記述します。

public $item_styles = array(

 'entry/title' =>     array('type'=>'text',   'label'=>'TITLE', 'list'=>true),

 'entry/id' =>      array('type'=>'hidden'),

 'entry/published' =>   array('type'=>'text',   'label'=>'DATE', 'list'=>true,

                'readonly'=>'readonly'),

 'entry/author/name' =>  array('type'=>'text',   'label'=>'NAME', 'list'=>true),

 'entry/author/uri' =>  array('type'=>'text',   'label'=>'SITE'),

 'entry/author/email' => array('type'=>'text',   'label'=>'E-MAIL'),

 'entry/author/gender'  => array('type'=>'radio',  'label'=>'GENDER', 'list'=>true,

                'options'=> array('1'=>'Male', '2'=>'Female', '3'=>'Other')),

 'entry/author/age'  => array('type'=>'select',  'label'=>'AGE',

                'options'=> array('0'=>'--', '10'=>'10´s',

                '20'=>'20´s','30'=>'30´s','40'=>'40´s',

                '50'=>'50´s','60'=>'60´s','70'=>'70´s',

                '80'=>'80´s','90'=>'90´s')),

 'entry/author/pc'  => array('type'=>'checkbox',  'label'=>'PC', 'list'=>true,

                'options'=> array('Win'=>'Windows', 'Mac'=>'Machintosh',

                'Lnx'=>'Linux', 'Oth'=>'Others')),

 'entry/content' =>   array('type'=>'textarea', 'label'=>'COMMENT')

);

CSS作成情報

CSSに関しては、「拡張クラス」のファイル名と同じファイル名のCSSを設置すればそちらを優先します。例えば、「拡張クラス」bbs.phpを使う場合、bbs.cssというファイルを作って設置すれば、これを優先します。
生成されるHTMLのスタイルclass名には一定の規則がありますので、それを元にCSSを作れば自由にレイアウトをカスタマイズできると思います。スタイルclass名の生成ルールを以下のようになります。 > は 上下関係、| は並列設定です。
カラム一覧： columns > column
リスト表示： columns > table.list
ボタン表示： actions > ul > li > a
フォーム表示： input | text,radio,checkbox,select,textarea | [各アイテムタグ名]
フォーム表示の時、各フォーム要素を囲む divの class名に要素に応じて text,radio,checkbox,select,textarea およびアイテムのタグ名そのものを付けています。CSSでタグ毎の設定することで細かな設定ができるのではないかと思います。

今後の予定

XMLの構造や属性を「拡張クラス」としてではなく、DTDのようなもので記述できないかと最初模索していたのですが、DTDに関する勉強が追いつかず、後回しにすることにしました。どなたかが実現してくださるとよいのですが。
次期バージョンの予定としては添付ファイルの機能のようなものを考えています。

ここからダウンロードできます

>> github : eijin/xmlbulletin

リリース履歴

version 1.0.0 / 2011.05.09

最初のリリース

<?php echo $this->Form->create(‘Model’,array(‘onsubmit’=>’return false;’)); ?>
  <div id=”upfields”>
    <?php echo $this->Form->hidden(‘upload_id’,array(‘id’=>’upload_id’, ‘value’ => $this->data['Model']['id'])); ?>
    <?php echo $this->Form->input(‘upload_file’,array(‘type’=>’file’,'id’=>’upload_file’)); ?>
    <?php echo $this->Form->button(‘アップロード’,array(‘id’=>’upload_button’)); ?>
  </div>
<?php echo $this->Form->end(); ?>
<div id=”upload_msg”></div>

２）上記のフォームと同じビュー内に記述（僕の場合、上記のformの直前に書きました。’inline’=>falseしているのでブラウザ上はヘッダに入ってくれます。）

<?php
  echo $this->Html->script(‘jquery.upload’,array(‘inline’=>false));
  $action_url = $this->Html->url(‘attach_upload’);
  $script =<<< EOL
    $(function() {
        $(‘#upload_button’).click(function() {
            $(‘#upload_msg’).html(‘処理中…’);
            $(‘#upfields’).upload(‘{$action_url}’, function(res) {
              $(‘#upload_msg’).html(res);
            }, ‘html’);
        });
    });
EOL;
  echo $this->Html->scriptBlock($script, array(‘inline’=>false, ‘safe’=>true));
?>

３）コントローラでのアクション

function attach_upload() {
  if (!$this->data['Model']['upload_file']['name']) {
      $error = ‘アップロードするファイルを選択してください’;
      $this->set(‘error’,$error);
  } else {
    if($this->data['Model']['upload_file']['type'] == ‘application/pdf’) {
        $error = ‘アップロードできるのは PDF のみです’;
        $this->set(‘error’,$error);
    } else {
      …. $target_path は予めり、ここで $fname をつくる …..
      rename($this->data['Model']['upload_file']['tmp_name'], $target_path . DS . $filename);
      $this->set(‘filename’,$filename);
    }
  }
  $this->render(‘attach_upload’,'ajax’);
}

４）ビューに追加するattach_upload.ctp (「CakePHP jQuery を使用した Ajax ファイルアップロード」サイトのものを例としてそのまままねさせていただきました）

<?php if (!empty($error)): ?>
<p><?php echo $error;?></p>
<?php else: ?>
<p>Upload successful</p>
<?php //echo $html->image($filename); ?>
<?php echo $filename; ?>
<?php endif; ?>

返す値をjsonに変更するものわりと簡単でした。jsonにする場合は、コントローラ上のアクションで最後にjson文字列をecho すれば、ちゃんとfunction(res) のresに返ってきます。

■構成

サーバは2台とします。データベース作成時は2台それぞれに同じグローバル名ORCL.WORLDですが、これを alter database rename global_name to でそれぞれORCL1.WORLDとORCL2.WORLDに変更ています（手順は後述）。

図１: レプリケーションの構成

■Windows2000Serverにおける問題

更新可能スナップショット設定手順の説明に入る前に、Windows2000Serverにおける問題と対処を列記しておきます。

１）ターミナル・サービス経由ではDatabase Configuration Assistantは使えない
　サーバにはモニタを付けずにリモートからいろいろやりたいものですが、そのためのターミナル・サービス経由ではDatabase Configuration Assistantは使えません。Oracle8iの標準インストーラでインストールする時の最後のプロセスでサンプルORCLを生成する場合も同様で、ターミナル・サービス経由だとフリーズしてしまいます。僕の知る限り対処方法はありません。あきらめてサーバのところでモニタを付けて作業するか、もしくは何かほかのVNCを導入するしかありません。

２）システム起動時にOracleServiceORCLを自動起動できない
　Windows2000独自の問題のようです。対処方法はオラクル・サポート知識ベース「文書番号：17714」に記載があります。この文書に書かれている orastart.bat に関しては、僕は環境変数の設定を追加しました（下記参照）。またグループ・ポリシーではなく単純にコントロールパネルの「タスク」で「システム起動時」にこのバッチが走るようにしました。（僕の場合、データベースを複数起動したかったので、このバッチを各データベース毎に作り、それぞれ「タスク」スケジュールに追加）
orastart.bat

@Echo off
net start OracleServiceORCL
set oracle_sid=ORCL
svrmgrl @f:\startup.sql
exit

■実際の設定で引っかかったこと

もう一点、更新可能スナップショット設定手順の説明に入る前に、この設定でぶつかった問題を先に以下に列挙しておこうと思います。

１）スナップショット・グループへのオブジェクトの追加がうまく行かない
手順の中でスナップショット側でスナップショット・グループへのオブジェクトの追加するところがある。これはあるドキュメントでは、ユーザー snapadmin で行うかのように記述していた。しかし、僕の場合うまく行かなかった。それで、scottでおこなった。なぜなら、オブジェクト追加ではなく、単純にCREATE SNAPSHOT を実行した場合、scottではエラーにならないがsnapadminだとFOR UPDATE AS を指定した時点でエラーになってしうからだ。 最終的にはscottでオブジェクト追加してレプリケーションは正常に動いている。なお、scottにデータベース・リンクも追加している。詳細は下記手順に。

２）LONG型はスナップショットでは使うことができない
LONG型はスナップショットでは使うことができない。代わりにオラクルではLOB型というものが用意されている。オラクルはLONG型の使用は推奨していないとのこと。しかし、oo4oがLOB型に対応していない。以下の説明で使うOracle8iのサンプルORCL.WORLDにはLONG型はないので問題はないが、僕が今回設定をしなければならなかった実際のシステムではこの矛盾にぶつかってしまった。

■更新可能スナップショット設定手順

まず、まだグローバル名は同じですが、TNS名はそれぞれORCL1.WORLD, ORCL2.WORLDとして tnsnames.ora に記述します。サービス名は変わらないので、これで接続できます。
tnsnames.ora

ORCL1.WORLD =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = Server1)(PORT = 1521))
      )
    (CONNECT_DATA = (SERVICE_NAME = ORCL.WORLD)
  )
ORCL2.WORLD =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = Server2)(PORT = 1521))
    )
    (CONNECT_DATA =(SERVICE_NAME = ORCL.WORLD))
  )

以下、各サーバへのコネクションで区切って説明します。

【補足】テーブルの削除
ORCL2.WORLD のテーブルは一旦全部削除する。
実は、これはやるべきかどうか曖昧なままである。やらなくてもいいのかも知れないが、僕はdrop tableで全て削除した。例え削除したとしても、最後まで設定を終えると結果的には自動的に生成されているので削除してよいのだと思っている。

【補足】上記テーブル削除の前に主キーを作っておく？
削除するのだから必要なさそうなものだが、それでも僕は上記の削除前にORCL1.WORLDでやったのと同様に、ORCL2.WORLDでも主キーがないものに主キーの追加を行った。
ALTER TABLE scott.bonus ADD (CONSTRAINT bonus_pk PRIMARY KEY(ename));
ALTER TABLE scott.salgrade ADD (CONSTRAINT salgrade_pk PRIMARY KEY(grade));
ヘンだが、一応書いておく。

【補足】もしテーブル削除した場合はインデックスの再作成も注意
drop table ****** CASCADE CONSTRAINTS; で削除した場合、インテックス（索引）も削除されているので、これらを改めて再作成することも忘れてはならない。
create index インデックス名 on テーブル名(カラム名) tablespace テーブルスペース名;

■リフレッシュ・グループにオブジェクト追加
BEGIN
DBMS_REFRESH.ADD (
NAME => ‘snapadmin.scott_mg’,
LIST => ‘scott.bonus’,
LAX => TRUE);
END;
/
BEGIN
DBMS_REFRESH.ADD (
NAME => ‘snapadmin.scott_mg’,
LIST => ‘scott.dept’,
LAX => TRUE);
END;
/
BEGIN
DBMS_REFRESH.ADD (
NAME => ‘snapadmin.scott_mg’,
LIST => ‘scott.emp’,
LAX => TRUE);
END;
/
BEGIN
DBMS_REFRESH.ADD (
NAME => ‘snapadmin.scott_mg’,
LIST => ‘scott.salgrade’,
LAX => TRUE);
END;
/

【補足】作成ジョブを確認したい場合
select job,last_date,last_sec,next_date,next_sec,total_time,broken,what from dba_jobs;
※NEXT時刻が時間が経っても更新されない場合は要注意。設定がうまく行っていない可能性がある。

【補足】設定後リフレッシュがうまく行っていない場合
一旦、scott/tiger で
execute dbms_refresh.destroy(‘snapadmin.scott_mg’);
してから、上記リフレッシュ・グループを再作成するとうまく行くことがあった。

以上で設定完了。

日本画風

主な使用素材集：
『和 japanese style (design parts collection)』 田村 嘉章 (著) 技術評論社
『四季の和風素材CD‐ROM』　夏木 一美 (著)　マール社
『名画クラシック素材―花鳥風月 』マール社編集部 (編集)　マール社

※以下いずれもクリックで実寸に拡大

金屏風

日本画風

浮世絵風

桂離宮風

偽宗達風

日本画風

偽光琳風

概観：スタンドアロンで使用するということは…

図１

図２

セットアップ手順

1. リポジトリ用フォルダを作る

図３

svnadmin create /Users/eiji/projects/_EijiSubversionRepository

このフォルダ内にデータベースファイルなどを生成するためのコマンドのようだ。

2. リポジトリのフォルダをXcodeのSCMに登録

画面１（※クリックで拡大）

3. プロジェクトのフォルダ構成をSCM用に変更

ひとつのプロジェクトのフォルダ直下にbranches, tags, trunkの3つのフォルダを作る。これはSubversionのお約束のようなもの。
Xcodeで新規にプロジェクトを作るとフォルダ直下にできるファイルやフォルダをtrunkに入れる。

図４

4. リポジトリに読み込む

図５

画面２（※クリックで拡大）

図６

5. 開発作業用フォルダとチェックアウト

図５

6. プロジェクトのリポジトリを構成をする

チェックアウトしたファイルをXcodeで最初に開いたときに、「プロジェクトのリポジトリを構成」の設定を必ず行う。
　
Xcodeでチェックアウトしたプロジェクトのファイルを開く。
Xcodeのメニュー「SCM」 >「 このプロジェクトのリポジトリを構成…」を選択。
開いたプロジェクト設定ウィンドウで、右上の「ルートとSCMを構成」ボタンをクリック。
　

画面４

コミットと履歴

運用中は変更の一区切り毎に「プロジェクト全体をコミット…」すればよい。
コミットしていった履歴はメニュー「SCM」>「SCMの情報を見る」で確認できる（画面５）。

画面５（※クリックで拡大）

その他、基本的な運用は下記が参考になった（コマンドをXcodeのメニューに置き換えて読む）。
「Subversionの基礎練習」
ファイルやフォルダを追加したときは、「リポジトリに追加」を忘れないこと。
　
実際にはSCMの使い方よりも、管理の方針をきちんと定め、のっとることの方が重要だと感じる。それもひとつの技術としての方法論みたいなものがあるだろうが、それは今後の課題。

参考にさせていただいたサイト：

• Me and Mark Publishing’s Blog: Xcode 3 Feature: Version Control Repository Access
• XcodeとSCM « Hiroki Ishiura Online
• Subversionの基礎練習

1. データ送信：HTMLフォームで入力されたデータを指定のメールアドレスへ送信します。
2. 入力検証：指定された検証条件に基づきHTMLフォームで入力されたデータを検証させることができます。
   検証条件例：郵便番号、電話番号、メールアドレス、日付、数字、最大文字数など
3. 確認ページ：入力内容の確認ページを表示させることができます。
4. テンプレート：HTMLで作成した検証エラーや確認、送信完了のページのテンプレートを読み込んで表示させることができます。
5. 自動応答：利用者がフォームに入力したメールアドレスに、自動応答メーセージを送信させることができます。
6. 応答編集：自動応答メッセージ（および完了ページ）に、フォームで入力された任意の項目を挿入させることができます。
7. CSV保存：フォームに入力された内容をCSV形式ファイルにしてサーバ上に保存することができます。
8. ファイルアップロード：ファイルアップロードしてデータメールの添付として送信します。なお、ファイルアップロード機能を使う場合は「確認ページ」機能は使うことができません。

遷移図

プログラム構成

このソフトウェアは3つのファイルで構成されています。

1. formmailer.php
   フォームのHTMLからactionで呼び出す実行ファイルです。
2. formmail.class.php
   formmailer.php で使用しています。
   フォームメールの機能を実現するデータとメソッドのクラスです。
3. formitem.class.php
   formmail.class.php で使用しています。
   フォームの入力データを保持し検証する機能を提供します。

フォームメール設定ファイル

フォームメールに必要な設定をXMLファイルで記述しておくことができます。
記述できるのは、例えばデータ送信先、データ件名、確認ページ用テンプレートファイル名、自動応答件名、自動応答内容などです。
なお、設定内容はフォームHTML上でオーバーライドすることもできます。
詳細は後述します。

使い方

[１] プログラムファイル配置場所とその記述

[1-1] ３つのプログラムファイルの配置場所を決めて設置してください。
3つともフォームのHTMLと同じディレクトリに置いてもよいですが、僕はクラスのみサイトのルートの外にclassというディレクトリを作って以下のように配置しています。

配置例：
/home/smallmake/www/class/formmail.class.php
/home/smallmake/www/class/formitem.class.php
※formmail.class.phpとformitem.class.phpは必ず同じディレクトリに置いてください。

[1-2] このクラスファイルへのパスをformmailer.phpに記述してください。
例えば下記のような形です。

require_once(“/home/smallmake/www/class/formmail.class.php”);

[1-3]formmailer.phpでのオプション設定
[1-3-1]ホスト名設定
指定ホスト以外から実行されないようセキュリティのためにホスト名を設定します。ホスト名のチェックをしなくてよい場合は空欄としてください。

define(“HOST_NAME”,”www.xxxxxxxxx.com”)

[1-3-2]オプション設定
いくつかの設定をオプションで行うことができます。オプションは $options 配列で設定します。そのキー名および内容は下表のとおり。

設定例：

$options = array(
    ”config_dir” => “”,
    ”data_email_header” => “—–\nDate: “.date(‘Y-m-d H:i:s’).”\nIP: “.$_SERVER['REMOTE_ADDR'].”\nAgent: “.$_SERVER['HTTP_USER_AGENT'].”\n—–\n”
);

[２] フォームHTMLファイルの作成

まず普通にフォームを作成し、アクションとして formmailer.php を指定してください。そして、それに加えて、以下の情報をフォームの中に記述していただく必要があります。
なお、これらの情報は全て <input type=”hidden” … を使って記述します。

[2-1]フォームメール設定ファイルのファイル名の記述

<input id=”config_xml” name=”config_xml” type=”hidden” value=”フォームメール設定ファイルのファイル名” />

[2-2]入力内容確認ページ表示の有無の記述
入力内容確認ページを表示したい場合は以下の記述を加えてください。

<input id=”confirm_mode” name=”confirm_mode” type=”hidden” value=”on” />

[2-3]入力項目設定の記述
入力項目となる要素の全ての要素名をitems[要素名]という形にして、これを要素名とするinput(hidden)を作ってください。これを「入力項目設定」と呼ぶことにします。このitems[要素名] の value には、要素のラベルと検証用の条件を設定できます。

例えば以下のようなフォームを最初に以下のように作成したとします。

[入力項目設定を記述する前の単純なフォーム]

<form action=”formmailer.php” method=”post”>
  氏名：<input id=”pname” name=”pname” type=”text” value=”" />
  性別：<input id=”gender” name=”gender” type=”radio” value=”女” />
  <input id=”gender” name=”gender” type=”radio” value=”男” />
  メールアドレス：<input id=”email” name=”email” type=”text” value=”" />
  コメント：<textarea id=”comment” name=”comment”></textarea>
  <input type=”submit” value=”確認” />
</form>

↓formmailer用に記述を追加

[上記のフォームに入力項目設定を追加したものー赤と緑の部分]

<form action=”formmailer.php” method=”post”>
  <input name=”config_xml” type=”hidden” value=”contact.xml” />
  <input name=”confirm_mode” type=”hidden” value=”on” />
  <input name=”items[pname]” type=”hidden” value=”氏名,require” />
  <input name=”items[gender]” type=”hidden” value=”性別,” />
  <input name=”items[email]” type=”hidden” value=”メールアドレス,require&email” />
  <input name=”items[comment]” type=”hidden” value=”コメント,require” />
  氏名：<input id=”pname” name=”pname” type=”text” value=”" />
  性別：<input id=”gender” name=”gender” type=”radio” value=”女” />
  <input id=”gender” name=”gender” type=”radio” value=”男” />
   メールアドレス：<input id=”email” name=”email” type=”text” value=”" />
  コメント：<textarea id=”comment” name=”comment”></textarea>
  <input type=”submit” value=”確認” />
</form>

このプログラムは、この items[]に設定されているvalueの内容を使って、送信するデータのラベルと入力されたデータの検証を行います。valueはカンマ(,)で2つに区切り、1つめがラベル、2つめが検証設定です。
検証設定については後で詳述します（【５】参照）。

[2-4]特別な要素名“email”
email と名付けた要素は自動応答メールの送り先となります。emailという要素名は、そういう意味で特別な要素名であるということにご注意ください。

[2-5]チェックボックス等の作り方
PHPの利用の時にはよく行われることなので書くまでもないかもしれませんが、フォームにチェックボックスなど複数の選択ができる要素を作るときの注意点を書いておきます。
チェックボックス等はPHPでは、配列として扱いたいので、一般に以下のように記述します。例えば利用OSを問うチェックボックス。

<input type=”checkbox” name=”useos[]” id=”useos[]” value=”WindowsXP” />
<input type=”checkbox” name=”useos[]” id=”useos[]” value=”WindowsVista” />
<input type=”checkbox” name=”useos[]” id=”useos[]” value=”Windows7″ />

上記のように要素名の末尾に[]という記号を付け加えます。これでPHPはこの一連の要素を配列として扱うことができます。
なお、この場合でも「入力項目設定」は

<input type=”hidden” name=”items[useos]” id=”items[useos]” value=”利用OS,require” />

で大丈夫です。name=”items[useos[]]” とする必要はありません。

[2-6]ファイルアップロード指定
ファイルアップロードしてこれをデータメールに添付で送信させることができます。ファイルアップロードの項目は複数作ることもできます。
利用するには、まず<form>タグに　enctype=”multipart/form-data”　を追加してください。

<form class=”myform” method=”post” action=”formmailer.php” enctype=”multipart/form-data”>

次に、普通に <input type=”file” …/> を追加すればよいだけです。
さらに、これらのファイル名をデータメールの項目として表示したい場合や、ファイルアップロードを必須としたい場合は、既述の　<input type=”hidden” name=”items[...] … /> 設定をすることも可能です。例えば下記のように記述します。

<input type=”hidden” name=”items[atch1]” id=”items[atch1]” value=”添付ファイル1,require” />
<input type=”hidden” name=”items[atch2]” id=”items[atch2]” value=”添付ファイル2,require” />

注意点１: ファイルアップロードを利用する場合は「確認ページ」を使うことができません。confirm_mode は off としてください。onにした場合はエラーとなります。
注意点２: アップロードファイルに日本語ファイル名を使う場合は、フォームのHTMLエンコードをUTF-8にすることをお勧めします（シフトJISの場合、日本語ファイル名が文字化けすることがあります）。
注意点３: php.ini の設定のupload_max_filesize および post_max_size はアップロードするサイズより大きくなければなりません。.htaccessファイルにて変更可能な場合は自己責任で設定してください。

[３] フォームメール設定ファイルの配置場所とその記述

[3-1] フォームメール設定ファイルを作成します。
このファイルはXML形式になっています。
[フォームメール設定ファイルの例]

<?xml version=”1.0″ encoding=”UTF-8″?>
<formmail>
    <channel>
      <title>問い合わせフォーム</title>
      <link>http://www.smallmake.com</link>
      <description></description>
      <language></language>
      <pubDate>12 Jan 2010 13:33:58 +0900</pubDate>
      <params>
        <dataFrom>nakai@smallmake.com</dataFrom>
        <dataTo>nakai@smallmake.com</dataTo>
        <dataSubject>[問い合わせフォームより]</dataSubject>
         <dataComment>このメールはサイトの問い合わせフォームから送信しています。</dataComment>
        <dataCsvPath>/home/smallmake/www/html/form/contact.csv</dataCsvPath>
        <dataCsvEncode>sjis-win</dataCsvEncode>
        <htmlValidate>contact_validation.html</htmlValidate>
         <htmlConfirm>contact_confirm.html</htmlConfirm>
        <htmlThanks>contact_thanks.html</htmlThanks>
         <returnUrl>http://www.smallmake.com/form/contact.html</returnUrl>
        <autoReplyFrom>eiji@smallmake.com</autoReplyFrom>
        <autoReplyBcc>eiji@smallmake.com</autoReplyBcc>
        <autoReplySubject>[www.smallmake.com] Thank you for comment.</autoReplySubject>
       <autoReplyMessage>Thank you for your comment to www.smallmake.com.
This is auto reply mail.
Your comment is following …
——
__%comment%__
</autoReplyMessage>
      </params>
    </channel>
</formmail>

各項目の意味は下記です。

↓(省略可)項目の省略時の動作

• htmlValidate, htmlConfirm, htmlThanks : これらが省略されるとデフォルトの簡易HTMLで表示をします。
• returnUrl：戻り先なしとなります。
• autoReplyFromなど：自動返信をしたくない場合はこの一連の自動返信のための設定を省略してください。

　
[3-2] この設定ファイルのファイル名をフォームのHTMLの中に記述します。

<input id=”config_xml” name=”config_xml” type=”hidden” value=”フォームメール設定ファイル名” />

という記述をフォーム (<form>) の中に追加してください。

なお、このフォームメール設定ファイルの指定をせずに、フォームのHTML上で全てを設定することも可能です。あるいは、このファイルを指定した上で、全てまたは一部をHTML上でオーバーライドできます。例えば以下のようにHTML上に記述できます。

<input id=”dataFrom” name=”dataFrom” type=”hidden” value=”info@smallamake.com” />
<input id=”dataTo” name=”dataTo” type=”hidden” value=”info@smallamake.com” />
<input id=”dataSubject” name=”dataSubject” type=”hidden” value=”【問い合わせ】” />
…以下省略…

[3-3]自動応答メールのメッセージに利用者の入力した内容を差し込むことができます。
利用者がフォームに入力した内容は、__% （アンダーバー２つとパーセント記号）と %__ （パーセント記号とアンダーバー２つ）の間に要素名（inputのname）を記述した部分に個々に差し込まれます。上の設定ファイルの例で言うと、__%comment%__ の部分にコメントとして入力した内容が差し込まれます。

[４] テンプレートの配置場所とその記述

[4-1]テンプレートとなるHTMLファイルを作成してください。
前述の[遷移図]の中の下記3つのページをHTMLで作成して、プログラムからのメッセージやデータ内容を「差し込み印刷」式に挿入して表示させることができます。各テンプレート「差し込み部分」には規定のマークアップを記述してください。

[4-1-1]入力検証エラー表示ページのHTMLテンプレート
HTML内に以下のマークアップ文字を記述してください。そこに入力検証エラーメッセージを表示します。

__%ValidationAlert%__

なお、入力検証エラー表示ページには、その前のページであるフォームへ「戻る」ボタンやリンクを設けることをお勧めします。
以下のテンプレート例を参考にしてください。

入力に下記の誤りがあります。フォームに戻って修正してください。
__%ValidationAlert%__
<form><input onclick=”history.back();” type=”button” value=”戻る” /></form>

[4-1-2]入力内容確認ページのHTMLテンプレート
入力確認用ページのHTMLテンプレートには必ず<form> タグを設置してください。action には __%PhpSelf%__ と記述すれば、元のフォームと同じactionが使われます（echo $_SERVER['PHP_SELF']; と同等）。

<form class=”myform” method=”post” action=”__%PhpSelf%__”>

そしてそのタグの開始直後くらいに以下のマークアップを記述ください。

__%HiddenData%__

プログラムがデータ送信や設定に必要なデータをすべてこのマークアップ位置に自動的に差し込みます。
次に、入力したものを利用者に確認してもらうための表示を記述してください。利用者がフォームに入力した内容は、__% （アンダーバー２つとパーセント記号）と %__ （パーセント記号とアンダーバー２つ）の間に要素名（inputのname）を記述した部分に個々に差し込まれます。
そして最後に送信ボタンとなる submit も設置してください。
以下のテンプレート例を参考にしてください。

入力内容をご確認ください。
<form name=“f” method=“post” action=“__%PhpSelf%__”>
  __%HiddenData%__
  氏名： __%pname%__
  性別： __%gender%__
  メールアドレス： __%email%__
  コメント： __%comment%___
  <input type=”submit” value=”送信” />
  <input onclick=”history.back();” type=”button” value=”戻る” />
</form>

[4-1-3]送信完了ページのHTMLテンプレート
送信完了ページもHTMLファイルで作成してテンプレートとすることができます。
この時、入力内容確認ページと同じように、__% と %__ の間に要素名を記述したものを用いて、入力内容からの差し込みができます。例えば以下のようなHTMLテンプレートが考えられます。

__%pname%__ 様
送信いたしました。ありがとうございます。
__%email%__ 宛に当方で受信したことをお知らせする自動応答メールをお送りいたしました。
詳細は、個別に改めてご連絡させていただきます。
よろしくお願いいたします。

[５] 入力項目設定の記述の詳細

「【２】フォームHTMLファイルの作成」で既に述べたように、入力項目となる要素の全ての要素名をitems[要素名]という形にして、これを要素名とするinput(hidden)を作ってください。そして、このitems[要素名] の value には、要素のラベルと検証用の条件を設定します。

<input id=”items[要素名]” name=”items[要素名]” value=”ラベル,検証条件” />

となります。「要素名」とは、すでに述べたようにフォーム入力する実際のinputやtextarea, selectなどの要素の名前です。
以下に、ラベルと検証条件について詳述します。

[5-1]ラベル
ラベルは、送られてくるデータメールでの各入力項目のラベルとなります。
[5-2]検証条件
ラベルと検証条件は半角のカンマで区切ります。
検証条件は半角アンド記号（&）で区切って複数指定することができます。
例えば以下のように記述します。

<input name=”items[pname]” type=”hidden” value=”氏名,require” />
<input name=”items[gender]” type=”hidden” value=”性別,” />
<input name=”items[email]” type=”hidden” value=”メールアドレス,require&email” />
<input name=”items[tel]” type=”hidden” value=”電話番号,phone=jp” />

上記は、氏名は必須入力、性別は検証しない、メールアドレスは必須入力で、かつメールアドレスに必要な書式（半角英数字であること、＠マークで区切られていること、ドメイン名にはドットを含むなど）であること、電話番号は必須ではないが書式はハイフン区切りの日本の電話番号の書式であることが設定されています。
条件に含まれるイコール記号（=）は、その条件におけるパラメータを指定しています。上記の場合は日本の電話番号の書式を指定しています。phoneの場合は=usの指定もできます。
イコール記号を使うものはそのほかに、最大値（例：max=100）、最小値（例：min=3)、最大文字数（例：maxLength=25)などがあります。
以下に指定できる検証条件の一覧を掲載します。

ダウンロード・ファイルの構成

▼プログラム・ファイル（構成は既述）
formmailer.php
formmail.class.php
formitem.class.php

▼サンプル・ファイル

ここからダウンロードできます

最新版：
  githubよりダウンロードできます。下記のリンクです。

> github : eijin/formmailer

旧版：
  version 0.4.1
  version 0.3.0
  version 0.2.x
  version 0.1.x

リリース履歴

version 0.4.1 / 2010.07.19

修正：
・formitem.class.php でzip, phone, dateチェックにバグがあり修正
追加：
・options にデータメールヘッダ付加、データラベルにprefix,suffix変更、アップロード最大サイズ指定追加
・ファイルアップロード機能追加
変更ファイル：
・formmail.class.php
・formitem.class.php
・contact_attach.html (サンプルファイル)
　
　

version 0.3.0 / 2010.05.24

追加：
・frommail.class.php に putItemValue($key, $value) という関数を追加。
　formmailer.phpなど外部からitemsの値を変えられるようにした。
変更ファイル：
・formmail.class.php
　
　

version 0.2.0 / 2010.05.08

修正：
・「入力内容確認ページ」で生成している hiddenのinput タグ閉じを ” />”に修正。
・上記hidden生成でvalueに htmlspecialchars をかけるようにした。
・メール送信でメッセージに htmlspecialchars をかけていたのを取りやめ。
追加：
・自動返信メールのコピーを指定アドレス(CC: BCC:)にも送信できるようにした。
・submitした内容をCSVファイルに保存できるようにした。
変更ファイル：
・formmail.class.php
・contact.xml (サンプルファイル)
　
　

version 0.1.0 / 2010.01.19

最初のリリース