当前位置:

首页 > 编程开发 > 把php5的程序 升级为php7,将PHP C++扩展从php5升级到php7

把php5的程序 升级为php7,将PHP C++扩展从php5升级到php7

通过修改核心头文件实现版本适配,根据PHP主版本号自动切换。分别准备php5obj.h和php7obj.h,将旧版宏映射到PHP7API,无需重写大量代码即可将PHP5的C++扩展高效升级至PHP7,兼容性强,支持自动条件编译,极大降低迁移成本。

本文目录

    接手一个基于 PHP5 写的 C++ 扩展,需要快速升级到 PHP7 环境下使用,但之前对 PHP5 和 PHP7 的源码并没有深入理解,怎么办?很多人第一反应是要重写大量代码,其实不然——只需要修改一个核心头文件,扩展就能编译通过,运行正常。下面就把这个“偷懒”的方法拆开来看。

    phpobj.h 文件:版本选择

    整个思路的核心是做一个版本适配层。先看这个 phpobj.h,它根据 PHP 的主版本号来决定加载哪个具体实现:

    #ifndef _PHP_OBJ_H_2017
    #define _PHP_OBJ_H_2017
    #include 
    #if PHP_MAJOR_VERSION < 7
    #include "php5obj.h"
    #else
    #include "php7obj.h"
    #endif
    #endif//_PHP_OBJ_H_2017
    

    这样,扩展代码里只需要统一引用 phpobj.h,底层自动切换。剩下的工作就是分别准备两个版本的头文件,把旧版 PHP5 的宏调用映射到 PHP7 的 API 上。

    php5obj.h(旧版)

    保留原有的宏定义,确保在 PHP5 环境下能正常编译。注意,这里用了一堆 #define 来包装原来的函数/宏,目的是让上层代码不直接依赖 PHP 版本细节:

    #define SW_RETURN_STRINGL    RETURN_STRINGL
    #define SW_RETVAL_STRINGL    RETVAL_STRING
    #define SW_RETVAL_STRING     RETVAL_STRING
    #define SW_RETURN_STRING     RETURN_STRING
    #define SW_ZVAL_STRINGL      ZVAL_STRINGL
    #define SW_ZVAL_STRING       ZVAL_STRING
    #define SW_MAKE_STD_ZVAL(p)  MAKE_STD_ZVAL(p)
    #define PZVAL_IS_REF(len)    ZVAL_IS_REF(len)
    
    // Register the class entry..
    #define PHP5CPP_REGISTER_CLASS(name, obj_name) \
    { \
        zend_class_entry ce; \
        INIT_CLASS_ENTRY(ce, obj_name, php5cpp_ ## name ##_methods); \
        ce.create_object = php5cpp_object_new_ ## name; \
        php5cpp_ce_ ## name = zend_register_internal_class_ex(&ce, NULL, NULL TSRMLS_CC);\
        memcpy( &php5cpp_object_handlers_ ## name, \
            zend_get_std_object_handlers(), \
            sizeof(zend_object_handlers) ); \
        php5cpp_object_handlers_ ## name.clone_obj = NULL; \
        php5cpp_ce_ ## name->ce_flags |= ZEND_ACC_FINAL_CLASS; \
    }
    
    #define PHP5CPP_GET_THIS() \
        zval* object = getThis();
    
    // Register resources. If we're using an object, put it into the object store.
    #define PHP5CPP_REGISTER_RESOURCE(obj_type, return_value, res, le) \
    { \
        PHP5CPP_GET_THIS(); \
        int rsrc_id = ZEND_REGISTER_RESOURCE(object ? NULL : return_value, res, le); \
        if (object) { \
            php5cpp_obj *obj = (php5cpp_obj *)zend_object_store_get_object(object TSRMLS_CC); \
            obj->u.obj_type= res; \
            obj->rsrc_id = rsrc_id; \
            obj->type= is_ ## obj_type; \
        } \
    }
    
    // These are for parsing parameters and getting the actual object from the store.
    #define PHP5CPP_SET_OBJ(type) \
    { \
        php5cpp_obj *obj= (php5cpp_obj *)zend_object_store_get_object( object TSRMLS_CC ); \
        type ## _instance = obj->u.type; \
    }
    
    // Deprecated
    #define PHP5CPP_OBJ_PARAMS(type, params) \
    { \
        PHP5CPP_GET_THIS(); \
        if (object) { \
            if (params == FAILURE) { \
                RETURN_FALSE; \
            } \
            PHP5CPP_SET_OBJ(type) \
        } \
    }
    
    // Deprecated
    #define PHP5CPP_OBJ_NO_PARAMS(type) \
    { \
        PHP5CPP_GET_THIS(); \
        if (object) { \
            if (ZEND_NUM_ARGS() != 0) { \
                php_error(E_WARNING, "didn't expect any arguments in %s()", get_active_function_name(TSRMLS_C)); \
            } \
            PHP5CPP_SET_OBJ(type) \
        } \
    }
    
    #define PHP5CPP_GET_OBJ(type) \
    { \
        PHP5CPP_GET_THIS(); \
        if (object) { \
            PHP5CPP_SET_OBJ(type) \
        } \
        if (type ## _instance == NULL) { \
            php_error(E_WARNING, "Get object fall in %s()", get_active_function_name(TSRMLS_C)); \
        } \
    }
    
    #define PHP5CPP_GET_OBJ_ZVAL(type, obj) \
    { \
        zval* object = obj; \
        if (object) { \
            PHP5CPP_SET_OBJ(type) \
        } \
        if (type ## _instance == NULL) { \
            php_error(E_WARNING, "Get object fall in %s()", get_active_function_name(TSRMLS_C)); \
        } \
    }
    
    //static void php5cpp_object_free_storage_ ## type(zend_object *object TSRMLS_DC)
    #define PHP5CPP_OBJ_FREE_FUNCTION(type) \
    static void php5cpp_object_free_storage_ ## type(void *object TSRMLS_DC) \
    { \
        php5cpp_obj *obj = (php5cpp_obj *) object; \
        zend_hash_destroy(obj->std.properties); \
        FREE_HASHTABLE(obj->std.properties); \
        if ( obj->u.type ) { \
            zend_list_delete(obj->rsrc_id); \
        } \
        efree(obj); \
    }
    
    #define PHP5CPP_OBJ_NEW_FUNCTION(type) \
    static zend_object_value php5cpp_object_new_ ## type(zend_class_entry *class_type TSRMLS_DC) \
    { \
        zend_object_value retval; \
        zval *tmp; \
        php5cpp_obj *obj = (php5cpp_obj *)emalloc( sizeof(php5cpp_obj) ); \
        memset( obj, 0, sizeof(php5cpp_obj) ); \
        obj->std.ce = class_type; \
        ALLOC_HASHTABLE( obj->std.properties ); \
        zend_hash_init( obj->std.properties, 0, NULL, ZVAL_PTR_DTOR, 0 ); \
        zend_hash_copy( obj->std.properties, \
            &class_type->properties_info, \
            (copy_ctor_func_t) zval_add_ref, \
            (void *) &tmp, \
            sizeof(zval *) ); \
        retval.handle = zend_objects_store_put( obj, \
            NULL, \
            (zend_objects_free_object_storage_t)php5cpp_object_free_storage_ ## type, \
            NULL TSRMLS_CC ); \
        retval.handlers = &php5cpp_object_handlers_ ## type; \
        return retval; \
    }
    
    #endif
    

    php7obj.h(新版)

    PHP7 内部对象模型变化很大,原来的 zval 分配、zend_object_store 等机制都改了。新版头文件里主要做了三件事:

    • 把老的 RETURN_STRINGL 等宏映射到新 API(注意参数个数变化);
    • 用 XtOffsetOf 获取对象偏移量,实现从 zend_object 到自定义结构的转换;
    • 修改对象创建/销毁函数,改用 zend_object_std_init 和 object_properties_init。
    #define SW_RETURN_STRINGL(s, l, dup)    RETURN_STRINGL(s, l)
    #define SW_RETVAL_STRINGL(s, l, dup)    do{RETVAL_STRINGL(s, l); if (dup == 0) efree(s);}while(0)
    #define SW_RETVAL_STRING(s, dup)        do{RETVAL_STRING(s); if (dup == 0) efree(s);}while(0)
    #define SW_RETURN_STRING(val, duplicate) RETURN_STRING(val)
    #define SW_ZVAL_STRINGL(z, s, l, dup)   ZVAL_STRINGL(z, s, l)
    #define SW_ZVAL_STRING(z,s,dup)         ZVAL_STRING(z,s)
    #define SW_MAKE_STD_ZVAL(p)             zval _stack_zval_##p; p = &(_stack_zval_##p)
    #define PZVAL_IS_REF(len)               0
    
    static inline php5cpp_obj* php5obj_from_obj(zend_object *obj) {
        return (php5cpp_obj*)((char*)(obj) - XtOffsetOf(php5cpp_obj, std));
    }
    
    #define Z_PHP5OBJ_P(zv)    php5obj_from_obj(Z_OBJ_P((zv)))
    
    // Register the class entry..
    #define PHP5CPP_REGISTER_CLASS(name, obj_name)\
    {\
        zend_class_entry ce;\
        INIT_CLASS_ENTRY(ce, obj_name, php5cpp_##name##_methods);\
        ce.create_object = php5cpp_object_new_##name; \
        php5cpp_ce_##name = zend_register_internal_class_ex(&ce, NULL);\
        memcpy( &php5cpp_object_handlers_##name, zend_get_std_object_handlers(),sizeof(zend_object_handlers) );\
        php5cpp_object_handlers_##name.clone_obj = NULL;\
    }
    
    //#define ZEND_REGISTER_RESOURCE(return_value, result, le_result)ZVAL_RES(return_value,zend_register_resource(result, le_result))
    #define PHP5CPP_GET_THIS() \
        zval* object = getThis();
    
    // Register resources. If we're using an object, put it into the object store.
    #define PHP5CPP_REGISTER_RESOURCE(obj_type, return_value, res, le) \
    {\
        PHP5CPP_GET_THIS();\
        int rsrc_id =0;\
        /*zend_register_resource(res,le);*/\
        if (object) { \
            php5cpp_obj *obj = Z_PHP5OBJ_P(object);\
            obj->u.obj_type= res;\
            obj->rsrc_id = rsrc_id;\
            obj->type= is_##obj_type;\
        }\
    }
    
    // These are for parsing parameters and getting the actual object from the store.
    #define PHP5CPP_SET_OBJ(type_name) \
    { \
        php5cpp_obj *obj= Z_PHP5OBJ_P(object) ; \
        type_name ## _instance = obj->u.type_name;\
    }
    
    // Deprecated
    #define PHP5CPP_OBJ_PARAMS(type, params) \
    { \
        PHP5CPP_GET_THIS(); \
        if (object) { \
            if (params == FAILURE) { \
                RETURN_FALSE; \
            } \
            PHP5CPP_SET_OBJ(type) \
        } \
    }
    
    // Deprecated
    #define PHP5CPP_OBJ_NO_PARAMS(type) \
    { \
        PHP5CPP_GET_THIS(); \
        if (object) { \
            if (ZEND_NUM_ARGS() != 0) { \
                php_error(E_WARNING, "didn't expect any arguments in %s()", get_active_function_name(TSRMLS_C)); \
            } \
            PHP5CPP_SET_OBJ(type) \
        } \
    }
    
    #define PHP5CPP_GET_OBJ(type) \
    {\
        PHP5CPP_GET_THIS();\
        PHP5CPP_SET_OBJ(type);\
    }
    
    #define PHP5CPP_GET_OBJ_ZVAL(type, obj) \
    { \
        zval* object = obj; \
        if (object) { \
            PHP5CPP_SET_OBJ(type) \
        } \
        if (type ## _instance == NULL) { \
            php_error(E_WARNING, "Get object_zal fall in %s()", get_active_function_name(TSRMLS_C)); \
        } \
    }
    
    #define PHP5CPP_OBJ_FREE_FUNCTION(type) \
    static void php5cpp_object_free_storage_ ## type(void *object TSRMLS_DC) \
    {\
        php5cpp_obj *obj = Z_PHP5OBJ_P((zval *)object);\
        zend_object_std_dtor(&obj->std);\
    }
    
    #define PHP5CPP_OBJ_NEW_FUNCTION(type) \
    static zend_object* php5cpp_object_new_ ## type(zend_class_entry *class_type TSRMLS_DC) \
    {\
        int objsize = sizeof(php5cpp_obj);\
        php5cpp_obj *obj=(php5cpp_obj*)ecalloc(1,objsize);memset(obj,0,objsize);\
        php_error(E_WARNING, "create object %p in %s()",obj,get_active_function_name(TSRMLS_C));\
        zend_object_std_init(&obj->std, class_type TSRMLS_CC);object_properties_init(&obj->std, class_type);\
        obj->std.handlers = &php5cpp_object_handlers_##type;\
        return &obj->std;\
    }
    
    #endif//_PHP7OBJ_H_
    

    整套方案下来,改动量其实很小——只需要在原有扩展代码中把 #include "php5obj.h" 换成 #include "phpobj.h",然后确保 php5obj.h 和 php7obj.h 放在正确路径下。编译时根据 PHP 版本自动选择对应实现,整个过程几乎不需要理解 Zend 引擎的内部差异。当然,前提是原扩展没有使用 PHP5 独有的 API(比如 TSRMLS_CC 宏在 PHP7 中被移除,但这里通过宏定义巧妙避开了)。如果原扩展大量依赖 zend_list_delete、zend_objects_store 等,还需要额外处理,但这个例子证明,很多时候改一个头文件就够了。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    GitHub网页仪表盘默认视图、单行标题和六项列表分别改变什么
    GitHub网页仪表盘默认视图、单行标题和六项列表分别改变什么

    解释GitHub网页仪表盘Feed或Home默认视图、六项列表、自定义选择保留和Agent sessions隐藏条件,区分布局、数据与权限。

    LangChain Python 1.4.10、JS core 1.3.7与langchain 1.6.4为什么要区分拒答和失败
    LangChain Python 1.4.10、JS core 1.3.7与langchain 1.6.4为什么要区分拒答和失败

    核对LangChain三种包版本,解释refusal内容块、ModelRefusalError与中间件传递,提供自定义错误分支示例并区分Python消息流和追踪修复。

    Anthropic Python/Ruby 2.8.0、TS 1.8.0、Go 2.9.0、Java 3.8.0参数校验应如何理解
    Anthropic Python/Ruby 2.8.0、TS 1.8.0、Go 2.9.0、Java 3.8.0参数校验应如何理解

    区分Anthropic各语言SDK及TypeScript云适配包版本,解释Claude Tag字段、Bedrock/Vertex分号差异、非法路径参数和只读Python版本核对。

    Windows Terminal 1.25.3131.0 GA与1.26.3133.0 Preview如何区分,交互设置与修复边界是什么
    Windows Terminal 1.25.3131.0 GA与1.26.3133.0 Preview如何区分,交互设置与修复边界是什么

    区分Windows Terminal 1.25.3131.0 GA与1.26.3133.0 Preview,解释enableTabDragDrop和showResizeOverlay配置、清屏及键盘修复,并保留鼠标报告点击URL问题未确认修复的更正。

    LiteLLM 1.109.0迁移要改什么,1.108.5 LTS、1.106.8与1.110.0-rc.1该如何看
    LiteLLM 1.109.0迁移要改什么,1.108.5 LTS、1.106.8与1.110.0-rc.1该如何看

    给出LiteLLM1.109.0五项迁移配置,说明fallback列表、local缓存、router_settings硬限流、Gemini参数和Lens独立部署,并区分LTS/旧补丁/RC。

    agent-desktop 1.3.1升级后如何理解沙箱存活与桌面快照?
    agent-desktop 1.3.1升级后如何理解沙箱存活与桌面快照?

    agent-desktop 1.3.1让已经启动的沙箱在启动器退出后继续运行,并更新rustix至1.1.6。对通过JSON快照操作桌面的用户而言,沙箱存活、平台权限与ref有效性需要分别判断,不能用其中一项正常代替整项任务的验收。

    langchain-core 1.8.1如何理解langsmith_gateway的作用范围和优先级
    langchain-core 1.8.1如何理解langsmith_gateway的作用范围和优先级

    langchain-core 1.8.1新增的langsmith_gateway用于上下文级LangSmith Gateway覆盖。它并非一次模型调用的临时请求参数:路由在模型构造时解析,因而生效位置、集成支持和配置优先级都需要一起理解。

    Claude Trading Skills如何理解覆盖状态和密钥审查限制?
    Claude Trading Skills如何理解覆盖状态和密钥审查限制?

    Claude Trading Skills分别记录覆盖完整性、数据来源和规则确认;维护者自动扫描标记的not_verified不能等同完整安全验证或已发生密钥泄露,相关Skill代码未在该审查提交中修改。

    llama.cpp预发布b12420、b12424、b12426、b12428怎么按模型任务选择构建
    llama.cpp预发布b12420、b12424、b12426、b12428怎么按模型任务选择构建

    llama.cpp预发布b12420、b12424、b12426、b12428分别带来模型与模板层面的变化。文本模型、文本转语音、语音识别和Jinja渲染不是一项能力;按任务对应构建,可以避免把某个新增支持误认为适用于所有模型的通用升级。

    Google Ads Skills 1.1.1/1.0.3如何检查安装和账号诊断边界?
    Google Ads Skills 1.1.1/1.0.3如何检查安装和账号诊断边界?

    Google Ads设置与Quickstart Skills 1.1.1、账号诊断1.0.3明确MCP有限写入、只读配置和结构化search参数,安装前提为Python3.10+与pipx。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。