feat(core): 最小可运行版本发布

Author: 苏青安

.gitignore

@@ -0,0 +1,2 @@
+/vendor
+/test.php

composer.json

@@ -0,0 +1,20 @@
+{
+  "name": "hejunjie/schema-validator",
+  "description": "基于规则类实现的 PHP 类型验证组件，支持字符串、整数、布尔值等常用类型验证 | A lightweight and extensible PHP type validation library based on rule classes.",
+  "type": "library",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Hejunjie\\SchemaValidator\\": "src/"
+    }
+  },
+  "authors": [
+    {
+      "name": "何俊杰",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {
+    "php": ">=8.1"
+  }
+}

src/Contracts/RuleInterface.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Contracts;
+
+interface RuleInterface
+{
+    /**
+     * 验证字段值
+     *
+     * @param string $field 字段名（例：user.email）
+     * @param mixed  $value 传入值
+     * @param mixed|null $params 规则附加参数（如 min:3 中的 3）
+     *
+     * @throws \Hejunjie\SchemaValidator\Exceptions\ValidationException
+     * @return void
+     */
+    public function validate(string $field, $value, $params = null): void;
+
+    /**
+     * 规则名称（用于注册）
+     */
+    public function getName(): string;
+}

src/Exceptions/ValidationException.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Exceptions;
+
+use Exception;
+
+class ValidationException extends \Exception
+{
+    protected array $errors;
+
+    public function __construct(array $errors)
+    {
+        parent::__construct("Validation failed");
+        $this->errors = $errors;
+    }
+
+    /**
+     * 获取所有验证错误
+     */
+    public function getErrors(): array
+    {
+        return $this->errors;
+    }
+}

src/Helpers.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Hejunjie\SchemaValidator;
+
+class Helpers
+{
+    /**
+     * 从数组中获取字段值（支持点语法，如 user.email）
+     */
+    public static function getValue(array $data, string $field)
+    {
+        if (strpos($field, '.') === false) {
+            return $data[$field] ?? null;
+        }
+
+        $segments = explode('.', $field);
+        foreach ($segments as $segment) {
+            if (!is_array($data) || !array_key_exists($segment, $data)) {
+                return null;
+            }
+            $data = $data[$segment];
+        }
+        return $data;
+    }
+
+    /**
+     * 将字符串转换为驼峰命名法（如 "user_name" 转为 "UserName"）
+     */
+    public static function studly_case(string $string): string
+    {
+        return str_replace(' ', '', ucwords(str_replace(['-', '_'], ' ', $string)));
+    }
+}

src/Rules/AcceptedRule.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Rules;
+
+use Hejunjie\SchemaValidator\Exceptions\ValidationException;
+use Hejunjie\SchemaValidator\Contracts\RuleInterface;
+
+/**
+ * 验证：内容只能为 yes、on、1、true
+ * @package Hejunjie\SchemaValidator\Rules
+ */
+class AcceptedRule implements RuleInterface
+{
+    private string $name = 'accepted';
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function validate(string $field, $value, $params = null): void
+    {
+        $validValues = ['yes', 'on', '1', 'true'];
+        if (!in_array(strtolower($value), $validValues, true)) {
+            throw new ValidationException([$field => [$this->name]]);
+        }
+    }
+}

src/Rules/AlphaDashRule.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Rules;
+
+use Hejunjie\SchemaValidator\Exceptions\ValidationException;
+use Hejunjie\SchemaValidator\Contracts\RuleInterface;
+
+/**
+ * 验证：内容只能包含字母、数字、破折号、下划线
+ * @package Hejunjie\SchemaValidator\Rules
+ */
+class AlphaDashRule implements RuleInterface
+{
+    private string $name = 'alpha_dash';
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function validate(string $field, $value, $params = null): void
+    {
+        if (!preg_match('/^[a-zA-Z0-9_-]+$/', $value)) {
+            throw new ValidationException([$field => [$this->name]]);
+        }
+    }
+}

src/Rules/AlphaNumRule.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Rules;
+
+use Hejunjie\SchemaValidator\Exceptions\ValidationException;
+use Hejunjie\SchemaValidator\Contracts\RuleInterface;
+
+/**
+ * 验证：内容只能包含字母和数字
+ * @package Hejunjie\SchemaValidator\Rules
+ */
+class AlphaNumRule implements RuleInterface
+{
+    private string $name = 'alpha_num';
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function validate(string $field, $value, $params = null): void
+    {
+        if (!preg_match('/^[a-zA-Z0-9]+$/', $value)) {
+            throw new ValidationException([$field => [$this->name]]);
+        }
+    }
+}

src/Rules/AlphaRule.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Rules;
+
+use Hejunjie\SchemaValidator\Exceptions\ValidationException;
+use Hejunjie\SchemaValidator\Contracts\RuleInterface;
+
+/**
+ * 验证：内容只能包含字母
+ * @package Hejunjie\SchemaValidator\Rules
+ */
+class AlphaRule implements RuleInterface
+{
+    private string $name = 'alpha';
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function validate(string $field, $value, $params = null): void
+    {
+        if (!preg_match('/^[a-zA-Z]+$/', $value)) {
+            throw new ValidationException([$field => [$this->name]]);
+        }
+    }
+}

src/Rules/ArrayRule.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Hejunjie\SchemaValidator\Rules;
+
+use Hejunjie\SchemaValidator\Exceptions\ValidationException;
+use Hejunjie\SchemaValidator\Contracts\RuleInterface;
+
+/**
+ * 验证：内容必须为数组
+ * @package Hejunjie\SchemaValidator\Rules
+ */
+class ArrayRule implements RuleInterface
+{
+    private string $name = 'array';
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function validate(string $field, $value, $params = null): void
+    {
+        if (!is_array($value)) {
+            throw new ValidationException([$field => [$this->name]]);
+        }
+    }
+}