使用者名稱通常限制為:英文字母(大小寫)、數字、底線,長度 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 屬性:
<?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
?>
<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。前後端同步驗證,資料庫加唯一索引,即可構建健全的帳號系統。