SV::string() - 文字列型
テキスト入力に使う基本型。長さ・フォーマット・正規表現の制約をチェーンで付与できます。
SV::string()JSON Schema 出力:
{ "type": "string" }.min(n)
最小文字数を設定します。
SV::string()->min(int $n)| パラメータ | 型 | 説明 |
|---|---|---|
$n | int | 許容する最小文字数（以上） |
JSON Schema キーワード: minLength
用途: 必須入力の空文字を防ぐ、本文に最低文字数を設ける。
// 1文字以上（実質 required 相当）
SV::string()->min(1)
// 10文字以上の本文
SV::string()->min(10){ "type": "string", "minLength": 10 }.max(n)
最大文字数を設定します。
SV::string()->max(int $n)| パラメータ | 型 | 説明 |
|---|---|---|
$n | int | 許容する最大文字数（以下） |
JSON Schema キーワード: maxLength
用途: DB カラム長に合わせる、表示領域に収める。
// 100文字以内の名前
SV::string()->min(1)->max(100)
// 255文字以内のタイトル
SV::string()->max(255){ "type": "string", "minLength": 1, "maxLength": 100 }.email()
メールアドレス形式を検証します。
SV::string()->email()JSON Schema キーワード: format: "email"
用途: 問い合わせフォームのメールアドレス欄。
SV::string()->email(){ "type": "string", "format": "email" }クライアントの
checkFormatは^[^\s@]+@[^\s@]+\.[^\s@]+$で事前検証する。より厳密な検証はサーバー側（Respectv::email()）で行われる。
.url()
URL 形式（https:// または http:// から始まる）を検証します。
SV::string()->url()JSON Schema キーワード: format: "uri"
用途: ウェブサイト URL、SNS プロフィール URL の入力欄。
SV::string()->url()->optional(){ "type": "string", "format": "uri" }.pattern(p)
正規表現によるフォーマット検証。
SV::string()->pattern(string $p)| パラメータ | 型 | 説明 |
|---|---|---|
$p | string | 正規表現パターン（区切り文字なし） |
JSON Schema キーワード: pattern
用途: 電話番号・郵便番号・ユーザー名など、既定のフォーマットが存在する入力。
// 日本の電話番号
SV::string()->pattern('^(0\d{9,10}|0\d{1,4}-\d{1,4}-\d{3,4})$')->optional()
// 半角英数字とアンダースコア（ユーザー名）
SV::string()->min(3)->max(20)->pattern('^[a-zA-Z0-9_]+$')
// 日本の郵便番号
SV::string()->pattern('^\d{3}-\d{4}$'){ "type": "string", "pattern": "^[a-zA-Z0-9_]+$", "minLength": 3, "maxLength": 20 }パターンは区切り文字（
/）なしで渡す。JSON Schema ではuフラグが適用される。
ReDoS（正規表現 DoS）防止ガイドライン
クライアント側バリデーターは入力のキーストロークごとにパターンを評価します。カタストロフィックなバックトラッキングを持つパターンはブラウザを長時間ブロックします（ReDoS）。
避けるべきパターン例:
| 危険なパターン | 問題 |
|---|---|
(a+)+b | 量指定子の入れ子（指数的バックトラック） |
| `(x | x)+y` |
(\w+\s)+\w+ | 可変長グループの連鎖 |
.*foo.*bar.* | .* の多重連鎖 |
安全な書き方:
# NG: 入れ子の繰り返し
(a+)+$
# OK: 文字クラスで代替
[a]+$
# NG: 重複選択肢
(\w|\d)+
# OK: 一つにまとめる
[\w\d]+クライアント側の安全ネット: クライアント実装は入力が PATTERN_MAX_INPUT_LENGTH（デフォルト 500 文字）を超えた場合、パターン評価をスキップしてサーバーに委ねます。この閾値を下げたい場合は checkPattern(pattern, limit) を直接呼び出すか、PATTERN_MAX_INPUT_LENGTH を参照してください。
サーバーサイドバリデーションは常に権威側です。クライアントバリデーションは UX 補助に過ぎません。
.date()
日付（YYYY-MM-DD 形式）を検証します。
SV::string()->date()JSON Schema キーワード: format: "date"
用途: 生年月日、予約日、期限日など。
{ "type": "string", "format": "date" }.dateTime()
日時（RFC 3339: YYYY-MM-DDTHH:mm:ssZ 形式）を検証します。
SV::string()->dateTime()JSON Schema キーワード: format: "date-time"
用途: イベント開始日時、タイムスタンプ入力。
{ "type": "string", "format": "date-time" }.time()
時刻（HH:mm:ss 形式）を検証します。
SV::string()->time()JSON Schema キーワード: format: "time"
用途: 営業時間、予約時刻など。
{ "type": "string", "format": "time" }.uuid()
UUID 形式（xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）を検証します。
SV::string()->uuid()JSON Schema キーワード: format: "uuid"
用途: ID フィールド、外部キーの受け取り口。
{ "type": "string", "format": "uuid" }.ipv4()
IPv4 アドレスを検証します。
SV::string()->ipv4()JSON Schema キーワード: format: "ipv4"
用途: IP アドレス入力、アクセス制限設定など。
{ "type": "string", "format": "ipv4" }.ipv6()
IPv6 アドレスを検証します。
SV::string()->ipv6()JSON Schema キーワード: format: "ipv6"
{ "type": "string", "format": "ipv6" }.slug()
URL スラッグ（小文字英数字とハイフンのみ）を検証します。
SV::string()->slug()JSON Schema キーワード: pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$"
用途: パーマリンク、カテゴリスラッグの入力。
{ "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }.domain()
ドメイン名（example.com 形式）を検証します。
SV::string()->domain()JSON Schema キーワード: format: "hostname"
用途: 許可ドメインの登録フォーム、サブドメイン設定など。
{ "type": "string", "format": "hostname" }組み合わせ例
$schema = SV::object([
// 名前: 1〜100文字
'name' => SV::string()->min(1)->max(100),
// メールアドレス
'email' => SV::string()->email(),
// 電話番号: 任意入力
'tel' => SV::string()->pattern('^(0\d{9,10}|0\d{1,4}-\d{1,4}-\d{3,4})$')->optional(),
// ウェブサイト: null 許容
'website' => SV::string()->url()->nullable()->optional(),
// 本文: 10〜1000文字
'body' => SV::string()->min(10)->max(1000),
]);