PHP扩展中抛出异常有五种标准方法：一、用zend_throw_exception抛内置异常；二、用zend_throw_exception_ex指定类与错误码；三、手动创建异常对象并抛出；四、在ZEND_FUNCTION中统一转换底层错误；五、在魔术方法handler中抛出异常。
当PHP扩展在执行过程中遇到错误条件时，需要通过标准的异常机制向PHP用户空间抛出可捕获的异常。以下是几种在C语言编写的PHP扩展中处理并抛出异常的常用方法：
一、使用zend_throw_exception函数抛出内置异常
该方式用于抛出PHP标准异常类（如Exception、RuntimeException）的实例，是兼容性最好、最推荐的基础方式。它会触发PHP引擎的标准异常处理流程，支持try/catch捕获。
1、在扩展源码中包含必要头文件：#include "Zend/zend_exceptions.h"。
2、在需要报错的位置调用zend_throw_exception函数，传入NULL表示使用默认Exception类，或传入对应类的zend_class_entry指针。
立即学习“PHP免费学习笔记（深入）”；
3、示例代码：zend_throw_exception(NULL, "Invalid parameter provided", 0);。
4、该调用后应立即返回FAILURE或NULL，避免后续逻辑继续执行。
二、使用zend_throw_exception_ex指定异常类和错误码
此函数允许精确指定异常类（如InvalidArgumentException）、错误消息及整型错误码，便于上层区分异常类型与上下文。
1、获取目标异常类的zend_class_entry指针，例如：zend_class_entry *ce = zend_exception_get_default();。
2、调用zend_throw_exception_ex(ce, error_code, "%s", "Error message");。
3、error_code需为整型值，可在catch块中通过$e->getCode()获取。
4、若ce为NULL，则等效于使用Exception类；若非NULL，必须确保该类已注册且可访问。
三、手动创建异常对象并调用zend_throw_exception_object
适用于需动态构造异常对象、设置属性（如自定义字段）或复用已有zval结构的场景。该方式提供最大灵活性，但需注意内存管理。
1、使用object_init_ex(&exception_zv, ce)初始化一个指定类的对象。
2、使用zend_hash_str_update等函数向exception_zv.properties中写入自定义属性。
3、调用zend_throw_exception_object(&exception_zv)，传入已初始化的zval指针。
4、调用后不得再对exception_zv进行zval_ptr_dtor操作，否则引发双重释放。
四、在ZEND_FUNCTION中统一拦截并转换底层错误为异常
对于封装了外部库（如cURL、OpenSSL）调用的扩展，宜在函数入口处设置错误钩子或检查返回值，并将底层错误码映射为语义明确的PHP异常。
1、在函数实现开头检查关键资源是否有效，例如if (!resource) { zend_throw_exception(zend_ce_invalid_argument, "Resource is not valid", 0); return; }。
2、调用外部库API后立即检查其返回状态，如openssl函数返回-1时，调用zend_throw_exception_ex(zend_ce_runtime_exception, OPENSSL_ERROR_CODE, "%s", ERR_error_string(ERR_get_error(), NULL));。
3、所有异常抛出前应确保已清理临时分配的内存（如efree），防止泄漏。
4、避免在EG(exception)非NULL时重复抛出异常，可用if (!EG(exception))判断。
五、在对象方法（__call、__get等魔术方法）中抛出异常
当扩展暴露Zend Object接口并实现handler时，在读写不可访问属性或调用不存在方法时，可通过异常中断流程并提供清晰提示。
1、在zval *zobj参数指向的对象handler中，于read_property或call_method回调内检测非法访问。
2、使用zend_throw_exception(zend_ce_error, "Cannot access protected property", 0); 中断当前操作。
3、若handler返回NULL或FAILURE，且EG(exception)已被设置，则引擎自动终止当前操作并进入异常处理路径。
4、注意不要在handler中直接return NULL而不设异常，否则可能触发静默失败而非预期异常。
