萬盛學電腦網

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

PHP 使用者名稱驗證:只允許英數字、底線的正則實作

需求分析

使用者名稱通常限制為:英文字母(大小寫)、數字、底線,長度 3-20 字元,且不得以數字或底線開頭。本文提供可直接套用的驗證函數與正則解析。

推薦正則表達式

<?php
/**
 * 驗證使用者名稱
 * @param string $username 使用者名稱
 * @param int $min 最小長度(預設 3)
 * @param int $max 最大長度(預設 20)
 * @return bool
 */
function isValidUsername(string $username, int $min = 3, int $max = 20): bool
{
    // ^ 開頭:字母
    // [a-zA-Z0-9_]{min-1,max-1} 後續:英數底線
    // $ 結尾
    $pattern = sprintf('/^[a-zA-Z][a-zA-Z0-9_]{%d,%d}$/', $min - 1, $max - 1);
    return (bool) preg_match($pattern, $username);
}

// 測試
$tests = [
    'john_doe' => true,
    'JohnDoe123' => true,
    'a1' => false,           // 太短
    '1john' => false,        // 數字開頭
    '_john' => false,        // 底線開頭
    'john-doe' => false,     // 含連字號
    'john doe' => false,     // 含空白
    'john@doe' => false,     // 含特殊符號
    str_repeat('a', 21) => false, // 太長
];

foreach ($tests as $name => $expected) {
    $result = isValidUsername($name);
    echo "$name => " . ($result ? '✅' : '❌') . " (預期: " . ($expected ? '✅' : '❌') . ")" . PHP_EOL;
}
?>

正則細部解析

/^[a-zA-Z][a-zA-Z0-9_]{2,19}$/
│ │         │           │  │
│ │         │           │  └── 結尾錨點
│ │         │           └── 重複 2-19 次(配合首字母共 3-20 字元)
│ │         └── 字元類別:英大小寫、數字、底線
│ └── 首字元:必須為英文字母
└── 開頭錨點

進階:支援 Unicode 使用者名稱(中文、日文等)

若系統允許多語言帳號,可使用 Unicode 屬性:

<?php
function isValidUsernameUnicode(string $username, int $min = 3, int $max = 20): bool
{
    // \p{L} 任意語言字母,\p{N} 任意數字
    $pattern = sprintf('/^[\p{L}][\p{L}\p{N}_]{%d,%d}$/u', $min - 1, $max - 1);
    return (bool) preg_match($pattern, $username);
}

// 測試
var_dump(isValidUsernameUnicode('張三'));        // true (2 字元,若 min=2)
var_dump(isValidUsernameUnicode('ユーザー123')); // true
var_dump(isValidUsernameUnicode('user_名'));     // true
?>

前端整合:HTML5 pattern 屬性

<input type="text" name="username"
       pattern="[a-zA-Z][a-zA-Z0-9_]{2,19}"
       title="3-20 字元,以英文字母開頭,僅限英數字與底線"
       required>

資料庫層面防禦

  • 欄位型別:VARCHAR(20) 或 CHAR(20)
  • 加上 UNIQUE 索引防重複
  • 儲存前統一 trim()、strtolower()(視業務是否區分大小寫)

常見錯誤與修正

錯誤寫法問題修正
/^[a-zA-Z0-9_]+$/允許數字/底線開頭、無長度限制加上首字母限制與長度量詞
/^\w+$/\w 包含底線,且允許數字開頭同左
直接用 ctype_alnum()不支援底線、不支援 Unicode改用正則或逐字元檢查

總結

使用 /^[a-zA-Z][a-zA-Z0-9_]{2,19}$/ 即可滿足大多數「英數底線、字母開頭、3-20 字元」的使用者名稱驗證需求。若需多語言支援,改用 /^[\p{L}][\p{L}\p{N}_]{2,19}$/u。前後端同步驗證,資料庫加唯一索引,即可構建健全的帳號系統。

copyright © 萬盛學電腦網 all rights reserved