mcpField
B
bitrix-validation

bitrix-validation

github.com/bxmaximum開発47269 回インストール2 週間前に更新
リポジトリ

bitrix-validation について

Bitrix の検証機能で DTO やコントローラー入力を検証するためのスキルです。ルール、カスタムバリデーター、バージョン制約、検証エラーの伝達方法を説明します。

主な機能

  1. 01DTO の検証ルール定義
  2. 02コントローラーアクションパラメーターの検証
  3. 03ネストしたオブジェクトとコレクションの検証
  4. 04カスタムルールとバリデーターの作成
  5. 05Result を介したエラーの伝達

活用シーン

  1. 01サービス入力のネストした値を検証
  2. 02コントローラーパラメーターにルールを適用
  3. 03サービス結果を通じた検証エラーの返却

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-validation

インストール後、Claude Code で/bitrix-validationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
controller.md
custom.md
rules-dto.md

詳細

バリデーション

ベースライン:main 23.0+ · 検証済み:main 26.800.0

名前空間全体は main 24.300 以降です。それ以前では、サービス内で入力を手動で確認し、Result エラーを返してください(bitrix-result-and-errors)。

タスク参照先
ルール属性、DTO、ネストされたオブジェクト、コレクション、グループ、ValidationServicerules/rules-dto.md
コントローラーの入力:アクションパラメーターのルール、ValidationParameter DTOrules/controller.md
カスタムルール属性とバリデーター、エラーコードrules/custom.md

不変条件

  • サービス:ServiceLocator::getInstance()->get('main.validation.service') を使用するか、サービスのコンストラクターで ValidationService を型指定します(ステートレス)。
  • .settings.php に validation セクションはなく、#[ValidationParameter] 属性もありません。
  • 名前:RegExp(Regex ではありません)、errorMessage(message ではありません)。エラーには getField() がありません。プロパティパスは getCode()(email、items.0.name)に含まれます。
  • アクションパラメーターのルール、groups、#[Json]、#[OnlyOneOfPropertyRequired] は main 26.250 以降*です。25.x では、アクションパラメーターに指定したルールは無視されるため、代わりに DTO をバリデーションしてください。
  • ValidationResult は Result を継承します。エラーはサービスの Result 経由で渡し、例外をスローしないでください。

コメント