EC-CUBE フォームの入力チェックにおけるパラメータまとめ
EC-CUBEでは、フォーム関連のクラスに書かれている
$objFormParam->addParam('お電話番号1', $prefix . 'tel01', TEL_ITEM_LEN, 'n', array('EXIST_CHECK', 'SPTAB_CHECK', 'NUM_CHECK', 'MAX_LENGTH_CHECK'));
$objFormParam->addParam('お電話番号2', $prefix . 'tel02', TEL_ITEM_LEN, 'n', array('EXIST_CHECK', 'SPTAB_CHECK', 'NUM_CHECK', 'MAX_LENGTH_CHECK'));
$objFormParam->addParam('お電話番号3', $prefix . 'tel03', TEL_ITEM_LEN, 'n', array('EXIST_CHECK', 'SPTAB_CHECK', 'NUM_CHECK', 'MAX_LENGTH_CHECK'));
のEXIST_CHECKやNUM_CHECKなどで、フォームに入力された内容のチェックをコントロールしている。
その具体的な内容についてまとめた。
| 定数名 | チェック項目 | エラー条件 |
|---|---|---|
| EXIST_CHECK | 必須入力の判定 | 値の受け取りがない場合エラーを返す |
| NUM_CHECK | 数字の判定 | 入力文字が数字以外ならエラーを返す |
| EMAIL_CHECK | メールアドレス形式の判定 | メールアドレス形式でないならエラーを返す |
| EMAIL_CHAR_CHECK | メールアドレスに使用できる文字の判定 | メールアドレスに使用できない文字が含まれていたらエラーを返す |
| MOBILE_EMAIL_CHECK | 携帯メールアドレスの判定 | SC_Helper_Mobile_Ex::gfIsMobileMailAddress()による判定結果でエラーを返す |
| ALPHA_CHECK | 英字の判定 | 入力文字が半角英字以外ならエラーを返す |
| ALNUM_CHECK | 英数字の判定 | 入力文字が英数字以外ならエラーを返す |
| GRAPH_CHECK | 英数記号の判定 | 入力文字が英数記号以外ならエラーを返す |
| KANA_CHECK | カタカナの判定 | 入力文字がカナ以外ならエラーを返す |
| KANABLANK_CHECK | カタカナの判定2 | 入力文字がカナ以外ならエラーを返す (タブ、スペースは許可する) |
| URL_CHECK | URL形式の判定 | URLを正規表現で判定する。デフォルトでhttp://があってもOK |
| IP_CHECK | IPアドレスの判定 | IPアドレスでない場合エラーを返す。改行コードが含まれている場合には配列に変換 |
| DOMAIN_CHECK | ドメインチェック | ドメインの形式が正しくなければエラーを返す |
| SPTAB_CHECK | スペース、タブのみの判定 | スペース、タブ、改行のみの入力の場合エラーを返す |
| NO_SPTAB | スペース、タブの判定 | 入力文字がスペース、タブ、改行を含んでいたらエラーを返す |
| ZERO_CHECK | 数字（非ゼロ）の判定 | 数値入力値で0が入力された場合エラーを返す |
| ZERO_START | ゼロで開始されている数値の判定 | 0で始まる数値が入力されていたらエラーを返す |
| FILE_EXISTS | ファイルの存在チェック | 入力パスのファイルが見つからなければエラーを返す |
| FIND_FILE | ディレクトリ内のファイル存在チェック | 指定ディレクトリ内に入力パスのファイルが見つからなければエラーを返す（デフォルトIMAGE_SAVE_REALDIR） |
| DIR_CHECK | ディレクトリ存在チェック | 入力されたパス文字のディレクトリが見つからなければエラーを返す |
| FILE_NAME_CHECK | ファイル名の判定 | 入力文字が英数字,’_’,’-‘以外ならエラーを返す |
| FILE_NAME_CHECK_BY_NOUPLOAD | ファイル名の判定(アップロード以外の時) | 入力文字が英数字,’_’,’-‘以外ならエラーを返す |
| MAX_LENGTH_CHECK | 最大文字数制限の判定 | 入力が指定文字数より大きいならエラーを返す |
| MIN_LENGTH_CHECK | 最小文字数制限の判定 | 入力が指定文字数未満ならエラーを返す |
| NUM_COUNT_CHECK | 桁数の判定 | 入力文字の桁数が指定の桁数でなければエラーを返す |
| SELECT_CHECK | 必須選択の判定 | プルダウンなどで選択されていない場合エラーを返す |
| CHANGE_LOWER | 小文字に変換 | 入力文字を小文字に変換する |
| DOWN_FILE_EXISTS | ダウンロード用ファイルの存在チェック | DOWN_SAVE_REALDIR内に入力パスのファイルが見つからなければエラーを返す |
なお、具体的な内容については、
/data/class/SC_CheckError.php
に書かれている。
文責：牧秀樹
この記事へのコメントはありません。