PHP Ctype 函數族詳解：高效字符串類型檢測的原生利器

PHP 內建的 **Ctype 擴展** 提供一組極快的字符串字元類型檢測函數，底層調用 C 標準庫 ``，**無正則開銷、無多字節編碼陷阱**，是驗證「純數字、純字母、可打印字元」等場景的首選。本文全面解析 12 個核心函數、常見陷阱與最佳實踐。

12 大核心函數速查表

核心用法範例

<?php
// 1. 基礎用法
$username = 'JohnDoe123';
if (ctype_alnum($username)) {
    echo "用戶名合法";
}

// 2. 關鍵陷阱：整數傳入會返回 false (因被當作 ASCII 碼值處理)
$id = 12345;
var_dump(ctype_digit($id));        // false (檢測字元碼 12345)
var_dump(ctype_digit((string)$id)); // true  **必須強制轉字符串**

// 3. 空字符串行為 (PHP 5.1+ 統一返回 false)
var_dump(ctype_alnum('')); // false

// 4. 組合驗證：密碼必須含字母+數字+標點 (8-20位)
function strongPassword(string $pwd): bool {
    if (strlen($pwd) < 8 || strlen($pwd) > 20) return false;
    $hasAlpha = false; $hasDigit = false; $hasPunct = false;
    for ($i = 0; $i < strlen($pwd); $i++) {
        $ch = $pwd[$i];
        if (ctype_alpha($ch)) $hasAlpha = true;
        elseif (ctype_digit($ch)) $hasDigit = true;
        elseif (ctype_punct($ch)) $hasPunct = true;
    }
    return $hasAlpha && $hasDigit && $hasPunct;
}
?>

Ctype vs `is_*` vs 正則 vs `filter_var` 選型指南

效能基準 (參考)

<?php
$str = str_repeat('a', 1000) . '1'; // 1001 字元
$iter = 100000;

$t = microtime(true);
for ($i=0;$i<$iter;$i++) ctype_alpha($str);
echo "ctype_alpha: " . (microtime(true)-$t) . "s\n"; // ~0.04s

$t = microtime(true);
for ($i=0;$i<$iter;$i++) preg_match('/^[a-zA-Z]+$/', $str);
echo "preg_match: " . (microtime(true)-$t) . "s\n";  // ~0.18s (慢 4-5 倍)

$t = microtime(true);
for ($i=0;$i<$iter;$i++) is_string($str) && !preg_match('/[^a-zA-Z]/', $str);
echo "is_string+preg: " . (microtime(true)-$t) . "s\n";
?>

**結論：單字節字元類別檢測，Ctype 完勝正則 3-5 倍效能。**

常見錯誤與避坑指南

1. 傳入整數/浮點數：`ctype_digit(123) === false`。**永遠 `(string)$val`**。
2. 檢測中文/多字節**：`ctype_alpha('中文') === false` (因每個字節非字母)。**嚴禁用於多字節字符串**。
3. 空字符串**：PHP 5.1+ 返回 `false`，舊版本可能 `true`。代碼中顯式判斷 `if ($str !== '' && ctype_xxx($str))`。
4. 混合編碼環境**：確保腳本編碼與輸入編碼一致，避免 `ctype_print` 因編碼錯誤誤判控制字元。

實戰封裝：通用字符串驗證器

<?php
class StringValidator
{
    public static function alnum(string $str): bool { return $str !== '' && ctype_alnum($str); }
    public static function alpha(string $str): bool { return $str !== '' && ctype_alpha($str); }
    public static function digit(string $str): bool { return $str !== '' && ctype_digit($str); }
    public static function xdigit(string $str): bool { return $str !== '' && ctype_xdigit($str); }

    // 組合規則
    public static function username(string $str): bool {
        return self::alnum($str) && strlen($str) >= 4 && strlen($str) <= 20;
    }

    public static function hexColor(string $str): bool {
        return (strlen($str) === 6 || strlen($str) === 3) && self::xdigit($str);
    }
}

// 使用
if (StringValidator::digit($_POST['age'] ?? '')) { /* ... */ }
if (StringValidator::hexColor($_POST['color'] ?? '')) { /* ... */ }
?>

總結

• Ctype 是 **單字節 ASCII 字元類別檢測的黃金標準**：快、簡、準。
• **三大鐵律**：轉字符串、`禁用於多字節`、空串顯式判斷。
• 驗證工具箱分層：Ctype (基礎字元類別) → `filter_var` (標準格式) → 正則 (複雜業務) → 專用庫 (身份證、銀行卡)。

善用 Ctype，讓輸入驗證又快又穩。