Skip to content

Validate

Validate email, URL, phone, IP, UUID, credit card, and JSON Schema.

7 modules

ModuleDescription
驗證信用卡使用 Luhn 演算法驗證信用卡號
驗證電子郵件驗證電子郵件地址格式
驗證 IP驗證 IPv4 或 IPv6 地址格式
驗證 JSON 架構根據 JSON 架構驗證 JSON 資料
驗證電話驗證電話號碼格式
驗證 URL驗證 URL 格式和結構
驗證 UUID驗證 UUID 格式和版本

Modules

驗證信用卡

validate.credit_card

使用 Luhn 演算法驗證信用卡號

Parameters:

NameTypeRequiredDefaultDescription
card_numberstringYes-要驗證的信用卡號

Output:

FieldTypeDescription
validboolean要驗證的信用卡號
card_typestring卡號是否有效
maskedstring卡號是否有效
luhn_validboolean遮蔽的卡號 (****1234)

驗證電子郵件

validate.email

驗證電子郵件地址格式

Parameters:

NameTypeRequiredDefaultDescription
emailstringYes-要驗證的電子郵件地址

Output:

FieldTypeDescription
validboolean要驗證的電子郵件地址
emailstring電子郵件是否有效
local_partstring電子郵件是否有效
domainstring已驗證的電子郵件

驗證 IP

validate.ip

驗證 IPv4 或 IPv6 地址格式

Parameters:

NameTypeRequiredDefaultDescription
ipstringYes-要驗證的 IP 地址
versionstringNoany要驗證的 IP 地址

Output:

FieldTypeDescription
validbooleanIP 地址是否有效
ipstringIP 地址是否有效
versionstringIP 地址是否有效
is_privateboolean已驗證的 IP 地址
is_loopbackboolean檢測到的 IP 版本 (v4 或 v6)

驗證 JSON 架構

validate.json_schema

根據 JSON 架構驗證 JSON 資料

Parameters:

NameTypeRequiredDefaultDescription
datatextYes-要驗證的 JSON 資料(字串或物件)
schematextYes-要驗證的 JSON 資料(字串或物件)

Output:

FieldTypeDescription
validboolean要驗證的 JSON 架構
errorsarray資料是否有效
error_countnumber資料是否有效

驗證電話

validate.phone

驗證電話號碼格式

Parameters:

NameTypeRequiredDefaultDescription
phonestringYes-要驗證的電話號碼
regionstringNointernational要驗證的電話號碼

Output:

FieldTypeDescription
validboolean電話號碼是否有效
phonestring電話號碼是否有效
normalizedstring電話號碼是否有效
regionstring已驗證的電話號碼

驗證 URL

validate.url

驗證 URL 格式和結構

Parameters:

NameTypeRequiredDefaultDescription
urlstringYes-要驗證的 URL
require_httpsbooleanNoFalse要驗證的 URL

Output:

FieldTypeDescription
validboolean僅接受 HTTPS URL
urlstringURL 是否有效
schemestringURL 是否有效
hoststring已驗證的 URL
portnumberURL 協定(http, https 等)
pathstring主機/網域名稱
querystring若有指定則為埠號

驗證 UUID

validate.uuid

驗證 UUID 格式和版本

Parameters:

NameTypeRequiredDefaultDescription
uuidstringYes-要驗證的 UUID
versionnumberNo0要驗證的 UUID

Output:

FieldTypeDescription
validboolean預期的 UUID 版本(1-5,或 0 表示任意)
uuidstringUUID 是否有效
versionnumberUUID 是否有效
variantstring已驗證的 UUID

Released under the Apache 2.0 License.