カテゴリー : ajaxzip2

CakePHPで、郵便番号から住所を自動入力したい

会員登録画面などで、郵便番号を入力すると、住所が自動入力されるというのはよく見かけます。
これをCakePHP上で実装したので、メモ。

自動入力には、ajaxzip2を使用します。
ajaxzip2のサイトから、ajaxZip2のアーカイブをダウンロードします。

解凍したajaxzip2をフォルダごとwebroot/js/におきます。
webroot/js/ajaxzip2/というフォルダ内に、
ajaxzip2.jsファイル、dataフォルダ、workフォルダが配置される形です。

viewファイルに、ajaxzip2を呼び出すように記載します。
jQueryを使用します。

<?php
echo $this->Html->script('jquery-1.9.1');
echo $this->Html->script('ajaxzip2/ajaxzip2');
?>

都道府県の選択肢を全て書いてもいいのですが、せっかくなのでDB化します。
prevesというテーブルを作成します。

CREATE TABLE IF NOT EXISTS `preves` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` text,
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`)
);

データを登録します。

INSERT INTO `preves` (`id`, `name`) VALUES
(1, '北海道'),
(2, '青森県'),
(3, '岩手県'),
(4, '宮城県'),
(5, '秋田県'),
(6, '山形県'),
(7, '福島県'),
(8, '茨城県'),
(9, '栃木県'),
(10, '群馬県'),
(11, '埼玉県'),
(12, '千葉県'),
(13, '東京都'),
(14, '神奈川県'),
(15, '新潟県'),
(16, '富山県'),
(17, '石川県'),
(18, '福井県'),
(19, '山梨県'),
(20, '長野県'),
(21, '岐阜県'),
(22, '静岡県'),
(23, '愛知県'),
(24, '三重県'),
(25, '滋賀県'),
(26, '京都府'),
(27, '大阪府'),
(28, '兵庫県'),
(29, '奈良県'),
(30, '和歌山県'),
(31, '鳥取県'),
(32, '島根県'),
(33, '岡山県'),
(34, '広島県'),
(35, '山口県'),
(36, '徳島県'),
(37, '香川県'),
(38, '愛媛県'),
(39, '高知県'),
(40, '福岡県'),
(41, '佐賀県'),
(42, '長崎県'),
(43, '熊本県'),
(44, '大分県'),
(45, '宮崎県'),
(46, '鹿児島県'),
(47, '沖縄県');

モデル(app/Model/Pref.php)を作成します。
クラスの定義だけです。

<?php
App::uses('AppModel', 'Model');

class Pref extends AppModel {
}
?>

コントローラーで、都道府県データを取得します。
Prefモデルを使用したいので、$usesにPrefを追加します。

var $uses = array('Pref');

コントローラー内で、以下のようにして都道府県データを取得します。

$pref_arr = $this->Pref->find('list', array('fields' => array( 'id', 'name')));
$this->set('pref_arr', $pref_arr);

Viewファイルで以下のように指定します。
Hogeはコントローラー名です。都道府県、市区町村のinputタグのnameがdata[Hoge][pref]となるので、
郵便番号の項目指定の箇所はこれに合わせます。

郵便番号: <?php echo $this->Form->input('zip', array('type'=>'text', 'div'=>false, 'label'=>false, 'size'=>"10", 'maxlength'=>"8", 'onKeyUp'=>"AjaxZip2.zip2addr(this,'data[Hoge][pref]','data[Hoge][address]',null,'strt');")); ?>
都道府県: <?php echo $this->Form->input('pref', array('type'=>'select', 'div'=>false, 'label'=>false, 'options'=>$pref_arr, 'empty'=>'選択してください')); ?>
住所: <?php echo $this->Form->input('address', array('type'=>'text', 'div'=>false, 'label'=>false, 'size'=>40)); ?>

最後に、ajaxzip2内のdataファイル呼び出しがパスの関係でうまくいっていなかったので修正。
js/ajaxzip2/ajaxzip2.jsの31行目を実際の環境にあわせて修正します(先頭にjsを追加)。

AjaxZip2.JSONDATA = 'js/ajaxzip2/data';

以上で使用できるようになると思います。