Pheanstalk 异常处理机制优化：解除基类异常的内部标记限制

在 Pheanstalk 5.0.7 版本中，项目团队对异常处理机制进行了一项重要改进：移除了 ClientException、ServerException 和基础 Exception 类的 @internal 标记。这一变更看似微小，实则对库的使用体验产生了显著影响。

Pheanstalk 作为 PHP 的 Beanstalkd 客户端库，其异常体系设计遵循了分层原则。基础异常类为开发者提供了统一的错误处理入口，而具体的子类则对应不同类型的操作异常。原先将这些基类标记为 @internal 的本意是防止开发者随意扩展这些异常类，但这种做法带来了意料之外的使用障碍。

在实际开发场景中，开发者经常需要捕获通用的异常类型，而不是逐一处理所有可能的特定异常。例如，当只需要记录错误或进行统一的重试逻辑时，捕获基础异常比枚举所有子类异常更为简洁高效。原先的 @internal 标记导致部分 IDE（如 PhpStorm）产生警告，暗示开发者不应使用这些"内部"类，这显然与实际的合理使用场景相矛盾。

技术实现上，Pheanstalk 团队移除了这些异常类的 @internal 文档块标记，同时保留了类文档中关于"内部使用"的文字说明。这种调整既保留了文档的指导作用，又消除了工具链的误报警告。值得注意的是，这一变更并不影响异常类的实际功能，而是改善了开发体验和代码的可维护性。

对于库的设计者而言，这一案例提供了有价值的经验：在考虑 API 边界控制时，需要平衡"防止滥用"和"合理使用"之间的关系。标记为内部的内容应当仅限于那些确实不应该被外部直接使用或扩展的实现细节，而对于那些虽然主要供内部使用但确实存在合理外部使用场景的组件，则应该保持开放。

这一改进体现了 Pheanstalk 项目对开发者体验的重视，也展示了开源项目如何通过社区反馈不断优化自身设计。对于使用者来说，现在可以更自由地使用这些基础异常类来构建更健壮的错误处理逻辑，而不必担心工具链的警告干扰。