萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 整合 JavaScript 表單驗證完整實作:前後端雙重驗證架構

架構概覽

本文展示一套完整的表單驗證方案:前端 JavaScript 即時驗證(提升用戶體驗)+ 後端 PHP 同邏輯驗證(確保資料安全)。兩端共用驗證規則定義,減少維護成本。

前端:HTML 表單結構與規則定義

透過隱藏欄位定義驗證規則(`form_validation_rules`)與行為(`form_validation_behaviours`):

<form method="post" action="sample1.php">
  <input type="hidden" name="form_validation_rules" value="
    username password year month day details : empty;
    username password : len >= 3;
    username password : chnum_;
    e-mail: email;
    membership : select 0;
    year : > 1900;
    year month day : date;
    sex : radio;
    details: len <= 20;
    categories[] newsletters[] : cnt >= 2;
    agree : terms;
  " />
  
  <input type="hidden" name="form_validation_behaviours" value="
    details : count details_count 20 black red;
    year : next 4;
    month day : next 2;
    month day : prev;
  " />
  
  <!-- 表單欄位:username, password, e-mail, membership, 年/月/日, sex, details, categories[], newsletters[], agree -->
</form>

規則語法說明

規則說明範例
empty必填username : empty
len >= n長度至少 npassword : len >= 6
len <= n長度至多 ndetails : len <= 200
chnum_僅英數字底線username : chnum_
emailEmail 格式e-mail : email
select 0下拉選單不可選預設值 0membership : select 0
> 1900數值大於year : > 1900
date合法日期(需年月日三欄)year month day : date
radio單選按鈕必選一sex : radio
cnt >= 2多選至少 2 項categories[] : cnt >= 2
terms核取方塊必勾選agree : terms

前端 JavaScript 核心邏輯

完整程式碼較長,核心模組包括:

  • form_validation_alert():統一錯誤訊息格式化(支援 `%%name%%`、`%%num%%` 佔位符)
  • form_validation_validate():核心驗證邏輯,支援比較、字元、長度、計數、日期、Email、必填、單選、下拉、條款等規則
  • form_validation_behave():即時行為(字數計數、自動跳下一欄、Backspace 上一欄)
  • form_validation_register():掛載 `onsubmit`、`onchange`、`onkeypress`、`onkeyup` 事件

後端 PHP 對應驗證實作

PHP 端復用相同規則字串,提供伺服器端二次驗證:

<?php
$form_validation_alerts = array(
    '>'       => "%%name%% should be more than %%num%%!",
    '<'       => "%%name%% should be less than %%num%%!",
    '>='      => "%%name%% should be more or equal to %%num%%!",
    '<='      => "%%name%% should be less or equal to %%num%%!",
    'ch'      => "%%name%% contains invalid characters!",
    'chnum_'  => "%%name%% contains invalid characters!",
    'cnt >'   => "you should select more than %%num%% %%name%%!",
    'cnt <'   => "you should select less than %%num%% %%name%%!",
    'cnt >='  => "you should select at least %%num%% %%name%%!",
    'cnt <='  => "you should select at most %%num%% %%name%%!",
    'cnt =='  => "you should select %%num%% %%name%%!",
    'date'    => "please, enter a valid %%name%%!",
    'email'   => "please, enter a valid e-mail address!",
    'empty'   => "please, enter %%name%%!",
    'len >'   => "%%name%% should contain more than %%num%% characters!",
    'len <'   => "%%name%% should contain less than %%num%% characters!",
    'len >='  => "%%name%% should contain at least %%num%% characters!",
    'len <='  => "%%name%% should contain at most %%num%% characters!",
    'len =='  => "%%name%% should contain %%num%% characters!",
    'num'     => "%%name%% is not a valid number!",
    'radio'   => "please, select %%name%%!",
    'select'  => "please, select %%name%%!",
    'terms'   => "you must agree to the terms first!",
);

function form_validation_alert($type, $name, $num) {
    global $form_validation_alerts;
    $name = preg_replace('/^\W*(\w*)\W*$/', '$1', $name);
    $msg = $form_validation_alerts[$type];
    $msg = str_replace('%%name%%', ucfirst(strtolower($name)), $msg);
    $msg = str_replace('%%name%%', strtolower($name), $msg);
    $msg = str_replace('%%num%%', $num, $msg);
    return $msg;
}

function form_validation_isnan($value) {
    return (string)(int)$value !== (string)$value;
}

function form_validation_validate($data, $rules) {
    $rules = preg_replace('/^\s*(\s.*)/', '$2', $rules);
    $rules = preg_split('/\s*;\s*/', $rules);
    
    foreach ($rules as $rule) {
        $rule = preg_split('/\s*:\s*/', $rule);
        if (count($rule) < 2) continue;
        
        $fields = preg_split('/\s+/', $rule[0]);
        $params = preg_split('/\s+/', $rule[1]);
        $action = $params[0];
        
        foreach ($fields as $field) {
            $field = str_replace('[]', '', $field);
            
            // 非 cnt/radio/terms 必須存在
            if (!in_array($action, array('cnt', 'radio', 'terms'))) {
                if (!isset($data[$field])) return 'invalid form!';
            }
            // 非 cnt 不可為陣列
            if (!in_array($action, array('cnt'))) {
                if (isset($data[$field]) && is_array($data[$field])) return 'invalid form!';
            }
            
            switch ($action) {
                case '>':
                case '<':
                case '>=':
                case '<=':
                    if (form_validation_isnan($data[$field])) 
                        return form_validation_alert('num', $field, 0);
                    // ... 比較邏輯
                    break;
                case 'ch':
                    if (!preg_match('/^[a-zA-Z]+$/', $data[$field]))
                        return form_validation_alert('ch', $field, 0);
                    break;
                case 'chnum_':
                    if (!preg_match('/^\w+$/', $data[$field]))
                        return form_validation_alert('chnum_', $field, 0);
                    break;
                case 'cnt':
                    $cnt = isset($data[$field]) ? (is_array($data[$field]) ? count($data[$field]) : 1) : 0;
                    // ... 計數邏輯
                    break;
                case 'email':
                    if (!preg_match('/^(\w+\.)*\w+@(\w+\.)+\w+$/', $data[$field]))
                        return form_validation_alert('email', $field, 0);
                    break;
                case 'empty':
                    if ($data[$field] == '')
                        return form_validation_alert('empty', $field, 0);
                    break;
                case 'len':
                    // ... 長度邏輯
                    break;
                case 'num':
                    if (form_validation_isnan($data[$field]))
                        return form_validation_alert('num', $field, 0);
                    break;
                case 'radio':
                case 'select':
                case 'terms':
                    if (!isset($data[$field]))
                        return form_validation_alert($action, $field, 0);
                    break;
            }
        }
        
        // date 規則特殊處理(需三欄位)
        if ($params[0] == 'date') {
            $fields = preg_split('/\s+/', $rule[0]);
            if (count($fields) == 3) {
                list($year, $month, $day) = $fields;
                if (form_validation_isnan($data[$year])) return form_validation_alert('date', $year, 0);
                if (form_validation_isnan($data[$month]) || $data[$month] < 1 || $data[$month] > 12)
                    return form_validation_alert('date', $month, 0);
                if (form_validation_isnan($data[$day]) || $data[$day] < 1 || $data[$day] > 31 
                    || !checkdate($data[$month], $data[$day], $data[$year]))
                    return form_validation_alert('date', $day, 0);
            }
        }
    }
    return true;
}

// 使用範例
if ($_POST) {
    $rules = $_POST['form_validation_rules'];
    $result = form_validation_validate($_POST, $rules);
    if ($result !== true) {
        die('驗證失敗: ' . $result);
    }
    // 驗證通過,處理業務邏輯
}
?>

現代化改進建議

  1. 規則定義改用 JSON:結構化、易維護、前後端共用同一份規則檔
  2. 前端改用 HTML5 原生驗證:`required`、`pattern`、`minlength`、`type="email/number/date"` 等,JS 僅作補充
  3. 後端使用成熟驗證庫:Laravel Validator、Symfony Validator、Respect\Validation 等
  4. CSRF 保護:表單必須包含 CSRF Token
  5. 錯誤訊息國際化:支援多語系
copyright © 萬盛學電腦網 all rights reserved