composer require webmozart/assert 不能直接使用，需手动引入 vendor/autoload.php 或确保 PSR-4 自动加载生效；否则报错 Class 'Webmozart\Assert\Assert' not found。
composer require webmozart/assert 能直接用吗
不能直接用，装完还得手动 require 或配合自动加载机制。Webmozart Assert 是纯 PHP 库，不带任何框架集成逻辑，composer require webmozart/assert 只是把它放进 vendor/ 并更新 autoload.php，但你得显式引入或确保 PSR-4 自动加载已生效。
- 常见错误现象：
Class 'WebmozartAssertAssert' not found—— 多数因为没引入vendor/autoload.php，或在 CLI 环境里忘了加载 - 使用场景：适合写函数入口校验，比如验证参数非空、类型匹配、数组键存在等
- 性能影响极小：所有断言方法都是静态调用，无对象实例化开销；生产环境可配合
assert.exception = 0（PHP 配置）或条件编译跳过，但 Webmozart 默认抛异常，不依赖 PHP 的assert()函数
Assert::string() 和 Assert::notEmpty() 组合怎么写才安全
别连用，Assert::string($value) 已隐含非空判断（它要求是 string 且 strlen > 0），再套一层 Assert::notEmpty($value) 属于冗余，还可能掩盖真实类型问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 容易踩的坑：传入
null时，Assert::string()报UnexpectedValueException，而Assert::notEmpty()对null也报错，但错误信息不同，调试时容易误判源头 - 参数差异：
Assert::string()拒绝null、false、数字、空字符串；Assert::notEmpty()接受字符串"0"、数字1，但拒绝null、[]、"" - 推荐组合示例：
Assert::string($name, 'User name must be a non-empty string');
就够了；若需允许空格但不允许全空白，单独加Assert::notWhitespaceOnly($name)
为什么在 Laravel 或 Symfony 项目里 assert() 不起作用
因为 Webmozart Assert 和 PHP 内置 assert() 函数无关。很多人搜 “PHP assert” 误以为是同一个东西，结果发现开了 zend.assertions=1 也没效果 —— 它压根没用到 PHP 的 assertion 系统。
- 常见错误现象：配置了
assert.exception = 0或assert.active = 0，以为能关掉 Webmozart 的检查，实际完全没影响 - 真正控制开关的方式只有两种：
try/catch包裹，或在部署时用 Composer 的 autoloader 替换策略（不推荐）；没有“全局禁用断言”的配置项 - 兼容性注意：Webmozart Assert v1.10+ 要求 PHP >= 7.2，Laravel 8+ 默认满足，但老项目升级时要注意
phpstan/phpstan等工具对它的类型推导支持有限
断言失败时抛的是什么异常，能统一捕获吗
统一抛 InvalidArgumentException 或其子类（如 UnexpectedValueException），所有方法最终都继承自 LogicException 或 InvalidArgumentException，不是杂乱的 RuntimeException。
- 可统一捕获：
try { Assert::integer($id); } catch (InvalidArgumentException $e) { // 所有参数类断言失败都会进这里 } - 但注意：
Assert::classExists()这类运行时检查抛的是RuntimeException，不属于参数前置校验范畴，别混在一起 catch - 容易被忽略的地方：异常消息里带参数名（如果传了第二个参数），但默认不带调用栈位置，调试时建议开启
debug_backtrace()手动打日志，或者用 Monolog + context 补充上下文
