composer命令未识别需检查全局安装和path路径；引入respect/validation时需按php版本选v2或v3并正确加载autoload.php；调用方式、错误处理及空值校验需对应版本特性。
Composer 安装失败或命令未识别怎么办
如果执行 composer 报错“command not found”，说明 Composer 没有全局安装或不在 $PATH 中。Windows 用户直接下载 Composer-Setup.exe 安装即可；Linux/macOS 推荐用脚本安装并软链到系统路径：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer
验证是否成功：composer --version 应输出版本号。若仍报错，检查 /usr/local/bin 是否在 $PATH 中（macOS/Linux）或系统环境变量（Windows）。
用 Composer 引入 Respect/Validation 到现有 PHP 项目
Respect/Validation 是轻量、可组合的数据验证库，不依赖框架，适合任何 PHP 项目。它已从 respect/validation 迁移至 respect/validation（v3+ 使用命名空间 Respect\Validation），但 v2 仍广泛使用，注意版本差异。
- v2（PHP 7.2+）：推荐老项目或需
Validatable接口的场景，安装命令为composer require respect/validation:^2.2 - v3（PHP 8.0+）：默认使用函数式 API，无自动类型提示注入，安装命令为
composer require respect/validation:^3.0
安装后，Composer 会自动生成 vendor/autoload.php，项目中必须引入它才能使用类库：
立即学习“PHP免费学习笔记（深入）”；
require __DIR__ . '/vendor/autoload.php';
在 PHP 脚本中调用 Respect/Validation 验证数据
v2 和 v3 的调用方式不同，容易混淆。v2 主要通过静态工厂方法（如 Validator::int()），v3 改为函数式入口（如 intVal()），且规则对象不可链式调用 setName() 等方法。
- v2 示例（验证邮箱并设错误名）：
use Respect\Validation\Validator; $email = 'test@example.com'; $result = Validator::email()->setName('email')->validate($email); if (!$result) { echo Validator::email()->setName('email')->assert($email); // 抛出异常含字段名 } - v3 示例（更简洁，但错误信息不含字段名，需手动包装）：
use function Respect\Validation\v3\Rules\intVal; use function Respect\Validation\v3\Rules\email; $email = 'test@example.com'; if (!email()->validate($email)) { throw new InvalidArgumentException('email 字段格式不合法'); }
v3 不再内置 setName()，也不自动捕获字段上下文，实际业务中建议封装一层验证器类来统一处理字段名与错误映射。
常见报错与兼容性注意点
最常遇到的是 Class 'Respect\Validation\Validator' not found，本质是自动加载失败，原因包括：
- 没执行
composer install或composer update（尤其克隆项目后） -
vendor/autoload.php路径写错（如少写__DIR__或相对路径跳转错误） - 用了 v3 但代码还按 v2 写法调用（如
Validator::string()在 v3 中不存在） - PHP 版本不匹配：v3 要求 PHP ≥ 8.0，用 PHP 7.4 运行会直接 fatal error
另外，Respect/Validation 默认不校验空字符串（''）是否为有效邮箱或数字，需显式加 notEmpty() 规则。这点容易被忽略，导致空提交绕过验证。
