PHP扩展中抛出异常有五种标准方法：一、用zend_throw_exception抛内置异常；二、用zend_throw_exception_ex指定类与错误码；三、手动创建异常对象并抛出；四、在ZEND_FUNCTION中统一转换底层错误；五、在魔术方法handler中抛出异常。
在PHP 8.3扩展开发中，当C代码遇到非法参数、资源不可用或逻辑冲突时，必须向PHP用户空间抛出可捕获的异常，否则调用方无法感知错误、程序会静默失败或触发段错误。
用zend_throw_exception抛内置异常
这是兼容性最强、最稳妥的抛异常方式，适用于绝大多数报错场景，比如参数为空、类型不匹配、数组越界等基础校验失败。
第一步：确保扩展源码已包含头文件 【#include "Zend/zend_exceptions.h"】，否则编译会报未声明函数错误。
第二步：在检测到错误的位置（如ZEND_FUNCTION函数体内）调用 zend_throw_exception(NULL, "Invalid argument", 0)；传入NULL表示使用默认Exception类，消息字符串需为C风格常量字符串，不能是动态拼接的zval或临时缓冲区。
立即学习“PHP免费学习笔记（深入）”；
第三步：立即返回 FAILURE 或 NULL（取决于函数签名），【绝不可继续执行后续逻辑】，否则可能引发内存越界或状态错乱。
用zend_throw_exception_ex指定异常类与错误码
当你需要让PHP端通过 $e->getCode() 区分错误类型，或希望catch块精准匹配 InvalidArgumentException 而非泛化的 Exception 时，必须用此方法。
方法一：获取目标类指针后调用
先调用 zend_lookup_class("InvalidArgumentException", sizeof("InvalidArgumentException") - 1, &ce) 获取类入口，再执行 zend_throw_exception_ex(ce, 400, "Missing required field: %s", field_name)；注意 ce 必须非 NULL 且已注册，否则抛出的是 Exception 而非预期子类。
方法二：直接复用已知类指针
若已知类在MINIT阶段注册过（如 PDOException），可用 zend_exception_get_default() 获取基类，或通过 zend_hash_str_find_ptr(CG(class_table), "PDOException", sizeof("PDOException") - 1) 查找具体类；错误码必须为整型，建议用有意义的HTTP状态码或自定义枚举值。
手动创建异常对象并抛出
仅在需设置自定义属性（如 error_id、trace_context）或复用已有 zval 结构时采用，日常开发中极少需要。
先用 object_init_ex(&exception_zv, ce) 初始化对象，再用 zend_hash_str_update(Z_OBJPROP_P(&exception_zv), "error_id", sizeof("error_id") - 1, &id_zv) 写入字段；最后调用 zend_throw_exception_object(&exception_zv) 抛出。
这一步极易内存泄漏：若 object_init_ex 成功但后续 zend_hash_str_update 失败，必须手动释放 exception_zv；【未调用 zval_ptr_dtor(&exception_zv) 将导致引用计数残留】。
PHP-CPP扩展中抛出C++异常
如果你用 PHP-CPP 而非原生 Zend API 开发，异常处理更简洁——直接 throw Php::Exception("message") 即可，框架自动完成C++异常到PHP Throwable的转换。
throw Php::Exception("Invalid number of parameters"); 这行代码会立刻中断当前函数，并在PHP侧生成标准 Exception 实例，支持完整堆栈追踪和 getMessage()/getCode() 访问。
注意：该异常只能在 PHP-CPP 的回调函数（如 Php::Function::invoke）中抛出，【不可在纯C线程或ZTS多线程临界区中 throw】，否则会导致PHP引擎状态错乱。
PHP 8.3新增：never返回类型配合异常终止
当扩展函数设计为“永不正常返回”（如 fatal_error_handler、abort_transaction），应在PHP层声明 function abort(): never { throw new RuntimeException("Aborted"); }。
这样做的好处是静态分析器（如 PHPStan）能识别该函数必然中断流程，避免后续代码被误判为可达；同时PHP 8.3引擎会在编译期检查 never 函数体内是否确实无 return 语句且必抛异常。
在扩展中调用此类PHP函数时，无需额外判断返回值——引擎保证它不会回来。
