PHP扩展开发教程4 - 开发我们自己的接口类

xiaodao 发布于2019-06-28 18:43 / 1219人阅读

摘要：二扩展类的普通函数支持的样式扩展类的函数，必须按照一定的规范来写，返回值和参数的名称类型都是有规定。最常见的是下面种函数样式，跟上一章的普通函数的样式其实差不多，返回值和参数的用法也完全一样，所以就不再多说。

PHP扩展是高级PHP程序员必须了解的技能之一，对于一个初入门的PHP扩展开发者，怎么才能开发一个成熟的扩展，进入PHP开发的高级领域呢？本系列开发教程将手把手带您从入门进入高级阶段。
本教程系列在linux下面开发（推荐使用centos），php版本用的是5.6，并假设您有一定的linux操作经验和c/c++基础。
有问题需要沟通的朋友请加QQ技术交流群32550793和我沟通。

上一章演示了如何在PHP扩展中导出普通函数，本章介绍怎么样在扩展中导出类。使得PHP能够在脚本中直接访问扩展中的C++类。

一、如何在PHP扩展中导出C++类

下面是使用PHP-CPP开发的一个扩展骨架代码，编译可以导出一个演示C++类。

工程的源码见github，可以用git客户端下或者打开网址打包下载。

# git clone https://github.com/elvisszhang/phpcpp_counter.git

现在我们的类名是 Counter, 扩展里面注册类的语法是这样子的

Php::Class counter("Counter");

Counter类里面有个函数叫 increment，通过下面语法告诉扩展让php脚本能访问这个函数。

counter.method<&Counter::increment> ("increment");

main.cpp 的C++源码如下。

#include 
#include 

//扩展的导出类 Counter
class Counter : public Php::Base
{
private:
    int _value = 0;
public:
    Counter() = default;
    virtual ~Counter() = default;
    //类的普通成员函数
    Php::Value increment() { return ++_value; }
    Php::Value decrement() { return --_value; }
    Php::Value value() const { return _value; }
    //类的静态成员函数
    static Php::Value gettime() {return time();}
};

//告诉编译器get_module是个纯C函数
extern "C" {
    //get_module是扩展的入口函数
    PHPCPP_EXPORT void *get_module() {
        static Php::Extension myExtension("counter", "1.0.0");
        
        //初始化导出类
        Php::Class counter("Counter");
        
        //注册导出类的可访问普通函数
        counter.method<&Counter::increment> ("increment");
        counter.method<&Counter::decrement> ("decrement");
        counter.method<&Counter::value> ("value");
        
        //注册导出类的可访问静态函数
        counter.method<&Counter::gettime>("gettime");

        //注册导出类，使用右值引用方式，优化资源使用
        myExtension.add(std::move(counter));
        
        //返回扩展对象指针
        return myExtension;
    }
}

对应上述例子的php测试代码如下。

increment() . PHP_EOL;
echo "result of increment() = ". $counter->increment() . PHP_EOL;
echo "result of decrement() = ". $counter->decrement() . PHP_EOL;
echo "result of value() = ". $counter->value() . PHP_EOL;
echo "result of gettime() = ". Counter::gettime() . PHP_EOL;
?>

上述php代码运行后的输出信息如下。

result of increment() = 1
result of increment() = 2
result of decrement() = 1
result of value() = 1
result of gettime() = 1523363778

二、扩展类的普通函数支持的样式

扩展类的函数，必须按照一定的规范来写，返回值和参数的名称、类型都是有规定。否则就不能被PHP脚本认识。

最常见的是下面4种函数样式，跟上一章的普通函数的样式其实差不多，返回值和参数的用法也完全一样，所以就不再多说。

// signatures of supported regular methods
void        YourClass::example1();
void        YourClass::example2(Php::Parameters ¶ms);
Php::Value  YourClass::example3();
Php::Value  YourClass::example4(Php::Parameters ¶ms);

另外函数如果带上修饰符 const。还有下面4种变化的样式。

void        YourClass::example5() const;
void        YourClass::example6(Php::Parameters ¶ms) const;
Php::Value  YourClass::example7() const;
Php::Value  YourClass::example8(Php::Parameters ¶ms) const;

三、参考文献

PHP-CPP帮助：classes-and-objects

GPU云服务器云服务器 php接口开发教程 php开发api接口教程 php扩展开发 php扩展开发培训

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/28573.html

PHP扩展开发教程2 - 编写第一个扩展 hello world

摘要：二下载第一个扩展第一个扩展的源码已经在上准备好了，直接用命令克隆，或者手工下载都可以。第四步确认扩展已经安装成功使用命令可以查看目前已经安装的所有扩展。 PHP扩展是高级PHP程序员必须了解的技能之一，对于一个初入门的PHP扩展开发者，怎么才能开发一个成熟的扩展，进入PHP开发的高级领域呢？本系列开发教程将手把手带您从入门进入高级阶段。本教程系列在linux下面开发（推荐使用cento...

Berwin 2019-06-28 18:40 评论0 收藏0
PHP扩展开发教程1 - 相关开发技术对比及介绍

摘要：四使用语言开发是我重点推荐的扩展开发框架，简明易懂，功能强大，开发效率高，代码易维护，执行速度快。优点三支持，的扩展开发有两套扩展开发框架，分别支持，，虽然框架代码有两个，但是接口却是一样的。 PHP扩展是高级PHP程序员必须了解的技能之一，对于一个初入门的PHP扩展开发者，怎么才能开发一个成熟的扩展，进入PHP开发的高级领域呢？本系列开发教程将手把手带您从入门进入高级阶段。本教程系列...

alaege 2019-06-28 18:40 评论0 收藏0
PHP扩展开发教程3 - 开发一个我们自己的数学函数库

摘要：下载命令行浏览器下载网址和仓库网址一样一不带参数，没有返回值的扩展函数写法函数功能打印以内的素数函数名称如何注册扩展函数必须在函数体中，注册函数，以便能在中能直接调用。函数有返回值，返回值类型设置为。 PHP扩展是高级PHP程序员必须了解的技能之一，对于一个初入门的PHP扩展开发者，怎么才能开发一个成熟的扩展，进入PHP开发的高级领域呢？本系列开发教程将手把手带您从入门进入高级阶段。本...

Barry_Ng 2019-06-28 18:43 评论0 收藏0
SegmentFault 技术周刊 Vol.40 - 2018，来学习一门新的编程语言吧！

摘要：入门，第一个这是一门很新的语言，年前后正式公布，算起来是比较年轻的编程语言了，更重要的是它是面向程序员的函数式编程语言，它的代码运行在之上。它通过编辑类工具，带来了先进的编辑体验，增强了语言服务。 showImg(https://segmentfault.com/img/bV1xdq?w=900&h=385); 新的一年不知不觉已经到来了，总结过去的 2017，相信小伙们一定有很多收获...

caspar 2019-08-15 13:33 评论0 收藏0
SegmentFault 技术周刊 Vol.40 - 2018，来学习一门新的编程语言吧！

摘要：入门，第一个这是一门很新的语言，年前后正式公布，算起来是比较年轻的编程语言了，更重要的是它是面向程序员的函数式编程语言，它的代码运行在之上。它通过编辑类工具，带来了先进的编辑体验，增强了语言服务。 showImg(https://segmentfault.com/img/bV1xdq?w=900&h=385); 新的一年不知不觉已经到来了，总结过去的 2017，相信小伙们一定有很多收获...

nihao 2019-08-21 18:39 评论0 收藏0