萬盛學電腦網

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

PHP 用戶名合法性驗證:字母開頭、英數底線、長度限制、保留字檢查

驗證規則設計

  • **開頭**:必須為英文字母
  • **允許字元**:英文字母、數字、底線 `_`、點 `.`
  • **長度**:4~20 字元(含首字母)
  • **保留字**:admin, root, system, api, www, mail, ftp 等
  • **大小寫不敏感**:統一轉小寫比對

正則表達式

const USERNAME_REGEX = '/^[a-zA-Z][a-zA-Z0-9._]{3,19}$/';

完整驗證函式

<?php
function validateUsername(string $username): array {
    $reserved = ['admin', 'root', 'system', 'api', 'www', 'mail', 'ftp', 'administrator', 'support', 'help', 'info', 'no-reply', 'noreply'];
    $lower = strtolower($username);

    // 1. 格式
    if (!preg_match('/^[a-zA-Z][a-zA-Z0-9._]{3,19}$/', $username)) {
        return ['valid' => false, 'code' => 'FORMAT', 'message' => '必須字母開頭,4-20 字英數底線點'];
    }

    // 2. 保留字
    if (in_array($lower, $reserved, true)) {
        return ['valid' => false, 'code' => 'RESERVED', 'message' => '此用戶名不可使用'];
    }

    // 3. 連續特殊字元(選擇性)
    if (preg_match('/[._]{2,}/', $username)) {
        return ['valid' => false, 'code' => 'CONSECUTIVE_DOTS', 'message' => '不允許連續點或底線'];
    }

    // 4. 不能以點/底線結尾
    if (preg_match('/[._]$/', $username)) {
        return ['valid' => false, 'code' => 'ENDS_WITH_SPECIAL', 'message' => '不能以點或底線結尾'];
    }

    return ['valid' => true, 'code' => 'OK', 'message' => '用戶名可用'];
}

// 使用
print_r(validateUsername('john_doe'));     // OK
print_r(validateUsername('123abc'));       // FORMAT
print_r(validateUsername('admin'));        // RESERVED
print_r(validateUsername('john..doe'));    // CONSECUTIVE_DOTS
print_r(validateUsername('john_'));        // ENDS_WITH_SPECIAL

資料庫唯一性檢查

function isUsernameTaken(PDO $pdo, string $username): bool {
    $stmt = $pdo->prepare('SELECT 1 FROM users WHERE LOWER(username) = LOWER(?) LIMIT 1');
    $stmt->execute([$username]);
    return (bool)$stmt->fetchColumn();
}

前端即時檢查(AJAX + 防抖)

<input type="text" name="username" id="username" required
       pattern="[a-zA-Z][a-zA-Z0-9._]{3,19}"
       title="字母開頭,4-20 字英數底線點">
<div id="username-msg" class="msg"></div>

<script>
const input = document.getElementById('username');
const msg = document.getElementById('username-msg');
let timer = null;

input.addEventListener('input', () => {
    clearTimeout(timer);
    timer = setTimeout(async () => {
        const val = input.value.trim();
        if (val.length < 4) return;
        const res = await fetch(`/api/check-username?username=${encodeURIComponent(val)}`);
        const data = await res.json();
        input.classList.toggle('valid', data.available);
        input.classList.toggle('invalid', !data.available);
        msg.textContent = data.message;
        msg.classList.toggle('show', !data.available);
    }, 300); // 300ms 防抖
});
</script>

Unicode 使用者名稱支援(選擇性)

// 允許中文、日文等 Unicode 字母
const USERNAME_REGEX_UNICODE = '/^\p{L}[\p{L}\p{N}._]{3,19}$/u';

原始來源:www.111cn.net

copyright © 萬盛學電腦網 all rights reserved