ビュー

<div class="options form">
<div class="actions">
    <ul>
        <li><?php echo $html->link('メニューに戻る', array('action'=>'index'));?></li>
    </ul>
</div>
<?php echo $form->create('Options', array('action'=>'upload', 'type' => 'file'));?>
    <fieldset>
        <legend>データのアップロード</legend>
    <?php
        echo $form->file('result');
    ?>
    </fieldset>
<?php echo $form->end('アップロード');?>
</div>
 

$form->createでtypeをfileにする。するとSubmitするとファイルがtmpフォルダにアップロードされます。

コントローラ

    function upload(){
        if (!empty($this->data)) {
            $model =& $this->Result;
            /* @var $model result */
            $up_file = $this->data['Options']['result']['tmp_name'];
            $fileName = CSV_FILE_PATH."result.csv";
            if (is_uploaded_file($up_file)){
                move_uploaded_file($up_file, $fileName);
                $model->loadFromCSV($fileName);         
                $this->Session->setFlash('データをアップロードしました。');
                $this->redirect(array('action'=>'index'));
            }
        }
    }
 

コントローラでは，返された$this->dataの'tmp_name'の中にアップロードされたファイル名が入っています。上記のコードでは，それのファイルをmove_uploaded_file関数で，特定の場所に保存しています。その後，モデルに定義したloadFromCSVメソッドでDBに読み込んでいます。

モデル

    function loadFromCSV($fileName) {
        $this->begin();
        try{
            $this->deleteAll('1 = 1', false);
            $csvData = file($fileName, FILE_SKIP_EMPTY_LINES | FILE_IGNORE_NEW_LINES);
            foreach($csvData as $line){
                $record = split(",", $line);
                $data = array(
                    "field1" => $record[0],
                    "field2" => $record[1]
                );
                $this->create($data);
                $this->save();
            }
            $this->commit();
        } catch(Exception $e) {
            $this->rollback();
        }
    }
 

モデルに定義したloadFromCSVメソッドは上記の通りです。ファイルをfile関数で読み込み，各行をsplitで分割してフィールドにセットしています。MySQLにはファイルからデータをインポートするSQL文もあるので，それを使おうかとも思ったのですが，CakePHPの機能で実装しました。

大変な処理かと思ったのですが，わりと簡単に実現できました。

最初，うまく動かない。DBを作るの忘れてた・・・・作った。

やっぱりうまく動かない。phpの設定を見るとmysqlのモジュールが入っていない。PHPを再コンパイルした。

やっぱりうまく動かない。

普通にLamppが入っているとか，yumでインストールされたapache+mysql+phpではなく，ベンダーさんが必要な機能だけをインストールしたWebサーバなので，どこがわるいのかよくわからない。

どうもうまくmod_rewriteが動作していない模様。mod_rewriteが入っていないのかと思ったがちゃんと入っているし。

エラーログを見てみると。やっぱり

"RewriteRule directive is forbidden"

というのが残っています。これでググってみると，

日曜研究室さんの記事を発見。記事に従ってhttpd.confに

Options FollowSymLinks

を追加したら動作するようになりました。

文字化け

動いたはいいんですが，Windowsでの開発環境では全然文字化けしなかったのに，サーバに配置したらとたんに文字化けしました。(T-T)

そういえば，と自分が書いた過去のエントリを参照。config/database.phpに

'encoding' => 'utf8',

を追加したら化けなくなりました。自分のブログが役立った。

 

Options FollowSymLinksについてしらべてみました。

どうも，これが設定されていないと，rewriteをhttpd.confに指定している分にはいいですが，rewriteの設定を.htaccessで指定したときにうまく動かない。ということのようです。ということは，CakePHPの動作には必須な設定ではないのでしょうか。Apacheのバージョンによっても動作が違ったりしそうな気もします。もうちょっと調べてみます。

この件にはさらに後日談が....。Options None をOptions FollowSymLinksに変更したのではなくて，元々

Options ExecCGI

Options ExecCGI
Options FollowSymLinks

と追加したのですが，これがバカでした。Optionsを2行に分けて書いてしまうと1行目の設定は無視されてしまうのです。これで他のCGIが動かなくなってしまいました。（ごめんなさい）

Options ExecCGI FollowSymLinks

日付入力フォームの月表示

フォームで日付入力をする場合に

$form->dateTime('date');
とか，
$form->input('date');   // dateが日付項目の場合

を使いますが，月のコンボボックスがJuryなどと英字表記されてしまいます。これを数字表記に変更する対応策が，「徹底入門」にも「ポケットリファレンス」にも載っています。いずれも違う方法ですが，ウラワザ的なやり方をする必要があるように書かれています。RC3では，オプションにmonthNamesというのがあり，それをfalseにしてやると月の選択肢は数字になります。

echo $form->input('start_date', array('dateFormat'=>'YMD', 'timeFormat'=>24,'monthNames'=>false));

このようにするだけです。ちなみに「ポケットリファレンス」のFormHelperのところには，inputメソッドの記述がありません。ですがbakeの生成コードを見ていると基本的にはこれを使うのが1.2流な感じがします。その点「徹底入門」ではしっかりと解説されています。

Vendor()関数

どちらの本にもVendor関数を使って，Vendorsディレクトリのライブラリを読み込むと書いていますが，RC3ではこれは通用しないみたいです。App::importを使用するように変更になったようです。

[1.2において、vendor()が利用できなくなります]

参考サイト

http://www.j4f.jp/blog/archives/20071202/127

http://cricava.com/blogs/index.php?blog=6&title=using_configure_on_your_cakephp_applicat&more=1&c=1&tb=1&pb=1

Configureクラスの利用の仕方

appフォルダのconfigフォルダに任意の名前で設定ファイルを作成します。

<?php
    $config['Auth'] = array(
        'use_ldap' => true,
        'auto_regist' => false
    );
    $config['Network'] = array(
        'ip' => '192.168.1.1',
        'host' => 'server1.hogo.com'
    );
?>
 

こんな感じで連想配列で設定情報を書いていきます。これを例えばmyconf.phpという名前で保存します。

app/config/bootstrap.phpに，

Configure::load('myconf');
 

 という行を追加すると，設定ファイルを起動時に読み込んでくれます。コードの中で設定情報を参照するには，

$ldap_mode = Configure::read('Auth.use_ldap');
 

のようにします。

システム > 管理 > サービスで，「network」にチェックを入れたら，ちゃんど起動時にデバイスが起動するようになりました。やれやれ，変なところで躓いてしまいました。このサーバーにPHPやMySQLをインストールしてみようと思います。

まずはXAMPP for Linux

XAMPPのLinux版をインストールすれば，Windowsの時のように簡単に環境を構築できそうですので，それをやってみます。

xamppのLinux版(僕の場合はxampp-linux-1.6.5a.tar.gz)を入手し/optに展開します。

$ su -
# cd ~sunvisor
# tar xvfz xampp-linux-1.5.3a.tar.gz -C /opt

そしてサービスを起動する

# /opt/lampp/lampp start

とても簡単にLAMPP環境を構築できました。何もしていないのと同じなくらい簡単です。

個別にインストール

今回のはLinuxでの動作確認をするための動作確認サーバーなので，これでも良いのですが，本番サーバーでは，稼働しているApacheサーバーにPHPやMySQLを入れるということも考えられます。また，XAMPPだとFedoraのサービスの管理とは全く別な部分で動作しますので，Fedoraのサービス管理方法で管理できません。そこで次にFedoraにパッケージを入れてLAMPP環境を作ってみます。

まずは，LAMPPサービスを止めてアンインストールします。アンインストールはインストールしたフォルダを削除するだけです。

# /etc/lampp/lampp stop
Stopping XAMPP for Linux 1.6.5a...
XAMPP: Stopping Apache with SSL...
XAMPP: Stopping MySQL...
XAMPP: Stopping ProFTPD...
XAMPP stopped.
# rm -rf /opt/lampp

LiveCDからインストールしたFedora8にはapache 2.0がインストール済みですので，MySQLとPHPをインストールします。Linuxのセットアップをするのは数年ぶりですが，今はyumというツールを使うのですね。これはアップデートも管理できるとても便利なツールのようです。そのツールでmysql関連のパッケージにどんなものがあるかを表示させました。

# yum list "mysql*"
Available Packages
MySQL-python.i386                        1.2.2-4.fc8            fedora
mysql.i386                               5.0.45-6.fc8           updates
mysql++.i386                             2.3.2-2.fc8            fedora

（中略）

mysql-query-browser.i386                 5.0r12-4.fc8           updates
mysql-server.i386                        5.0.45-6.fc8           updates
mysql-test.i386                          5.0.45-6.fc8           updates

沢山あります。どれを入れればよいのでしょうか。特にmysql.i386とmysql-server.i386のどちら？どちらも？・・・しかしこれはとりあえずmysql-serverをインストールすればよいようです。

# yum -y install mysql-server

こうすると，yumは依存情報を調べて必要なパッケージをインストールしてくれるのです。インストール後に確認してみると次のようになっています。ちゃんと入っていそうですね。

# yum list installed "mysql*"
Installed Packages
mysql.i386                               5.0.45-6.fc8           installed
mysql-libs.i386                          5.0.45-6.fc8           installed
mysql-server.i386                        5.0.45-6.fc8           installed

こうしてパッケージでインストールすると，FedoraのGNOMEのサービスの画面にmysqldが表示される他，コマンドラインでのサービスの起動・再起動も他のサービスと同じようにserviceコマンドで行うことができます。

次にphpのインストールですが，さらにパッケージ数が多く何を入れたものやら・・・という感じです。とりあえず自分にとって必要そうなものを入れます。

# yum -y install php php-mbstring php-mysql php-mssql php-ldap phpMyAdmin

mysqlやmssql，ldapのモジュールに加えてついでにphpMyAdminも入れました。

phpMyAdminは，そのままでは外部からのアクセスができませんので，/etc/httpd/conf.d/phpMyAdmin.confを修正します。次の例では192.168.1.0/24のセグメントからのアクセスを許可しています。

<Directory /usr/share/phpMyAdmin/>
   order deny,allow
   deny from all
   allow from 192.168.1.0/24  <-- この行を追加
   allow from 127.0.0.1
</Directory>

uidではなくsAMAccountNameを使う

認証(authentication)の研究(1)で紹介したpsychicの記事にあるfindAll関数では$attribute引数の初期値に'uid'という値が使われています。。Linux+OpenLDAPで運用されているLDAPサーバーの場合は，アカウント名を示す属性はuidなのですが，ADのLDAPディレクトリの場合にはこの属性はありません。ADで同様な意味を持つ属性は，sAMAccountNameです。cnが使えそうに思うかもしれませんが，これは使えません。ADのサーバー上でウィザードを使ってユーザーを新規作成した場合には，cnには姓名がセットされてしまうからです。相手がADサーバーの場合はsAMAccountNameを使います。

パスワードが空だとldap_bindはtrueを返す

次に，これはちょっとハマったのですが，ldap_bind関数でADに接続するとき，パスワードが空欄の場合はldap_bindは一応成功してしまうという点に注意が必要です。そんな場合はldap_bindの戻り値にtrueが返ってきますが，それ以降のldapに対する処理ldap_searchなどは失敗します。ldap_bindを使ってユーザー名とパスワードの組み合わせが正しいかどうか認証をする場合には，ldap_bindで認証する前に空のパスワードの場合をはじいておかなければいけません。

AD認証の手順

ADは匿名bindを許しませんので，認証手順としては次のようになります。

1. ユーザー名とパスワードをチェックしていずれかが空欄の場合は認証失敗とします。
2. bind用のユーザー名とパスワードでADにbindします。ldap_bind
3. ADのsAMAccount属性を検索して与えられたユーザー名があるかどうか調べます。ldap_search
4. あった場合は，そのアカウントのdnを調べます。ldap_search, ldap_first_entry, ldap_getdn
5. dnとパスワードでldapにバインドしてみます。ldap_bind

これらの処理が通れば，ADにより認証されたということになります。

基本的な疑問

ここまでの実験をいろいろやっていまして，一つ疑問に思うことがあります。CakePHPではcore.phpで定義されているDEBUG定数の値，画面へのデバッグ情報の表示を制御していますが，ldap_bindで認証処理を行うと，認証できなかった場合にかならずエラーが表示されてしまうので，うまく認証できなかった場合の動作確認がちゃんとできないんですよね。DEBUG定数に優先するようなエラー処理を書くことってできないのでしょうか。これって基本的なことで，とても恥ずかしい諮問かもしれません。

現在のところ私たちは，ユーザ認証システムはアプリケーションごとに仕様が異なると考えています。あるものはハッシュでパスワードを暗号化，別のものは LDAP 認証などという具合，そしてほぼすべてのアプリケーションの User モデルについて，少しずつ違いがある，といったことがあります。それで今のところは，あなた次第，ということにしておきます。

とあります。そういろいろな仕様があると思います。僕の開発するアプリケーションで必要となる認証方法は，DBにユーザー情報を持っておいて，それでログインするというものと，LDAPサーバー（Windows Server 2003 のActive Directory）の認証とを組み合わせたものです。

1. ユーザー情報はMySQLのテーブルに持つ
2. DB認証のパスワードはハッシュで暗号化して保存する
3. DB認証のパスワードが空の場合はLDAPで認証する
4. DBにユーザー情報がない場合LDAPで認証できたらDBにユーザー情報を自動作成できる

このような仕様のユーザー認証を作成するのを目標にしたいと思います。

XAMPPでLDAPを利用できるようにする

最初に開発環境でLDAPが利用できるようにする必要があります。xamppでLDAPを利用できるようにするためには，php.iniの変更が必要です。コマンドラインのためには，c:\xampp\php\php.iniを，Apacheのためにはc:\xampp\apache\bin\php.iniを編集します。

;extension=php_ldap.dll

エディタで上記の行を検索して，この行のコメントを外して保存します。Apacheを再起動します。

LDAP Models in CakePHP

http://bakery.cakephp.org/articles/view/ldap-models-in-cakephp にpsychicことJohn David Anderson氏が書いている記事が大変参考になりましたのでその概要を日本語で書いてみます。

序

多くの組織では今日クライアントや従業員の情報を保存するのにLDAPを利用しています。このチュートリアルは，アプリケーションからCakePHPのModelとしてそのデータを利用する方法を紹介します。

L is for Lightweight

それほどLDAPに詳しくない場合でも，LDAPへの接続・問い合わせ・データの取得にはどうしたらようかを理解する助けになるいくつかのポイントがあります。LDAPは本当にかなり軽量です，そしてその動作の基本を理解することは，大いにためになるでしょう。
LDAPはツリー状の構造に保存されます。ツリーの中でノードを特定するには親ノードを特定する構文を使います。LDAPツリーのルートは，通常，，「cn=cakephp，cn=org」のように収容されるドメイン名にちなんで名付けられてます。次のような表現は

ou=People,cn=example,cn=com 

LDAPツリーのルートにある，"People"というOU(organizatinal unit)をあらわします。

LDAPには多くのタイプのエントリーがありますが，LDAPツリーの最も一般的な用途の一つは個人情報を保存することです。個人レコードをLDAPサーバに問い合わせたとき，そのレコードはツリー形式で返ります。PHPでは，ネストした配列で返ります。

D is for Down and Dirty

はじめにテーブルを使用しないCakePHPモデルを作成します。そのためにはModelクラスの$useTableプロパティを使います。また，LDAPの接続設定を定義するいくつかのクラス変数を宣言します。

<?php  
class LdapUser extends AppModel 
{ 
    var $name = 'LdapUser'; 
    var $useTable = false; 
 
    var $host       = 'ldap.example.com'; 
    var $port       = 389; 
    var $baseDn = 'dc=example,dc=com'; 
    var $user       = 'cn=admin,dc=example,dc=com'; 
    var $pass       = 'password'; 
 
    var $ds; 
} 
?>

LDAPに詳しくない人のために，これらのセッティングについて説明させてください。hostとportは，そのまんまです。baseDnは，LDAPツリーのルートがどこにあるかを指定します。baseDNを一般公開していないサーバーの場合は，管理者に確かめる必要があります。
$userと$passは，ログインに必要な認証情報です。$ds変数は，接続したLDAPサーバーへのリンクを保存します。

次に，ModelがCakePHPによってロードされるときにLDAPサーバーに接続するようにコンストラクタを修正する必要があります。

<?php  
//ldap_user.php (partial) 
 
function __construct() 
{ 
    parent::__construct(); 
    $this->ds = ldap_connect($this->host, $this->port); 
    ldap_set_option($this->ds, LDAP_OPT_PROTOCOL_VERSION, 3); 
    ldap_bind($this->ds, $this->user, $this->pass); 
} 
 
function __destruct() 
{ 
    ldap_close($this->ds); 
} 
?>

A is for Application

セットアップが完了した今，Modelに2，3のアプリケーションに役立つ関数を作成することができます。最初の業務予定は，多分，一定の条件によってデータを取ってくる関数を作成することでしょう。私が作成した最初のものは，ある属性の値に基づくレコードのセットを返すfindAll()関数でした。

<?php  
function findAll($attribute = 'uid', $value = '*', $baseDn = 'ou=People,dc=example,dc=com') 
{ 
    $r = ldap_search($this->ds, $baseDn, $attribute . '=' . $value); 
 
    if ($r) 
    { 
        //if the result contains entries with surnames, 
        //sort by surname: 
        ldap_sort($this->ds, $r, "sn"); 
 
        return ldap_get_entries($this->ds, $r); 
    } 
} 
?>

この関数はデフォルトでは与えられたユーザ名と値に基づくレコードセット("People"というOU下のLDAPツリー上にあるものすべて)をとって来ます。またレコードの姓(sn)によってソートされて返されます。
コントローラでは，多くのやり方で利用できます，:

<?php  
//Get all users: 
$this->LdapUser->findAll('uid', '*'); 
 
//Get users from a specific group inside the 'People' group: 
$this->LdapUser->findAll('uid', '*', 'ou=Client Company,ou=People,cn=example,cn=com'); 
 
//Get a specific user: 
$this->LdapUser->findAll('uid', 'jsmith'); 
?>

もう一つの使い勝手の良い関数は auth()関数です。
これは特にイントラネットアプリケーションで便利です。ユーザーはたぶん既にLDAPをメールなどのサービスの認証に使用しています。新しいCakePHPによるイントラネットアプリケーションを使うのにそれらと同じユーザ名とパスワードとを使わない手はありません。
この関数はコンポーネントかコントローラにあるべきかもしれませんが，ModelにはLDAP接続情報が既にありますので，私は認証関数をこのModelクラスに置くことにしました。

注：認証をする際には，セキュアな（SSL）LDAP接続をするために異なるポートで接続させたいかもしれません。

<?php  
function auth($uid, $password) 
{ 
    $result = $this->findAll('uid', $uid); 
 
    if($result[0]) 
    { 
        if (ldap_bind($this->ds, $result[0]['dn'], $password)) 
            { 
                return true; 
            } 
            else 
            { 
                return false; 
            } 
    } 
    else 
    { 
        return false; 
    } 
} 
?>

簡単ですね。ユーザーを見つけるのにfindAll()関数を使います。このユーザ情報はLDAPサーバがユーザを特定するのに使用するDN(またはdistinguished name)を含んでいます。このステップを取る理由は，Bobのログイン情報を'dn=Bob Smith,ou=MyCompany,dc=example,dc=com'と持つより'bobsmith'と持った方が簡単だからです。

コントローラでこれを利用するのは次のように簡単です。

$this->LdapUser->auth($u, $p);

Active Directoryの利用
 

psychicが提供してくれた情報で，CakePHPの中にうまくLDAPを取り込めそうだと言うことがわかりました。しかし僕のようにActive DirectoryをLDAPサーバーとして利用する場合には，このままではうまく動かない部分があります。その点については次回で研究します。