首頁 > 文章 > 後端開發 > PHP擴充開發之開發我們自己的介面類

PHP擴充開發之開發我們自己的介面類

不言原創: 2018-04-13 16:23:161723瀏覽

本篇文章給大家分享的內容是PHP擴充開發之開發我們自己的介面類，有著一定的參考價值，有需要的朋友可以參考一下

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::Class7291a602fab93c84dabbc8532a6a1d6e counter("Counter");

Counter類別裡面有個函數叫increment，透過下面語法告訴擴充讓php腳本能訪問這個函數。

counter.method78b504f69415d8c8003c96fef61971c4 ("increment");

main.cpp 的C 原始碼如下。

#include <phpcpp.h>
#include <time.h>

//扩展的导出类 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");
        
        //注册导出类的可访问普通函数
        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測試程式碼如下。

<?php
$counter = new Counter;
echo &#39;result of increment() = &#39;. $counter->increment() . PHP_EOL;
echo &#39;result of increment() = &#39;. $counter->increment() . PHP_EOL;
echo &#39;result of decrement() = &#39;. $counter->decrement() . PHP_EOL;
echo &#39;result of value() = &#39;. $counter->value() . PHP_EOL;
echo &#39;result of gettime() = &#39;. 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 &params);
Php::Value  YourClass::example3();
Php::Value  YourClass::example4(Php::Parameters &params);

另外函數如果帶修飾符 const。還有下面4種變化的樣式。

void        YourClass::example5() const;
void        YourClass::example6(Php::Parameters &params) const;
Php::Value  YourClass::example7() const;
Php::Value  YourClass::example8(Php::Parameters &params) const;

三、參考文獻

PHP-CPP幫助：classes-and-objects