摘要：前面兩節(jié)介紹了如何用編寫(xiě)常用的擴(kuò)展函數(shù)，擴(kuò)展類。對(duì)怎么使用開(kāi)發(fā)擴(kuò)展應(yīng)該已經(jīng)很熟悉了，下面晉級(jí)學(xué)習(xí)一下關(guān)于擴(kuò)展函數(shù)參數(shù)類型方面的內(nèi)容。

PHP擴(kuò)展是高級(jí)PHP程序員必須了解的技能之一，對(duì)于一個(gè)初入門(mén)的PHP擴(kuò)展開(kāi)發(fā)者，怎么才能開(kāi)發(fā)一個(gè)成熟的擴(kuò)展，進(jìn)入PHP開(kāi)發(fā)的高級(jí)領(lǐng)域呢？本系列開(kāi)發(fā)教程將手把手帶您從入門(mén)進(jìn)入高級(jí)階段。
本教程系列在linux下面開(kāi)發(fā)（推薦使用centos），php版本用的是5.6，并假設(shè)您有一定的linux操作經(jīng)驗(yàn)和c/c++基礎(chǔ)。
有問(wèn)題需要溝通的朋友請(qǐng)加QQ技術(shù)交流群32550793和我溝通。

前面兩節(jié)介紹了如何用PHP-CPP編寫(xiě)常用的擴(kuò)展函數(shù)，擴(kuò)展類。對(duì)怎么使用PHP-CPP開(kāi)發(fā)擴(kuò)展應(yīng)該已經(jīng)很熟悉了，下面晉級(jí)學(xué)習(xí)一下關(guān)于擴(kuò)展函數(shù)參數(shù)類型方面的內(nèi)容。

下面教程內(nèi)容的相關(guān)源碼已經(jīng)上傳到github上面。

git clone https://github.com/elvisszhang/phpcpp_param.git

有時(shí)候，我們開(kāi)發(fā)的函數(shù)，我們希望只能傳入特定的類型，例如字符串運(yùn)算的函數(shù)只能傳入字符串參數(shù)，數(shù)值運(yùn)算的函數(shù)只能傳入數(shù)字參數(shù)，數(shù)組操作的函數(shù)只能傳入數(shù)組參數(shù)。

下面是擴(kuò)展中如何指定一個(gè)函數(shù)參數(shù)類型的樣例代碼

#include 

void example(Php::Parameters ¶ms)
{
}

extern "C" {
    PHPCPP_EXPORT void *get_module() {
        static Php::Extension myExtension("my_extension", "1.0");
        myExtension.add("example", {
            Php::ByVal("a", Php::Type::Numeric),
            Php::ByVal("b", "ExampleClass"),
            Php::ByVal("c", "OtherClass")
        });
        return myExtension;
    }
}

上面的 Php::ByVal 是代表值類型的參數(shù)的設(shè)定方式，聰明點(diǎn)的你應(yīng)該猜到相對(duì)應(yīng)還有一個(gè) Php::ByRef的代表引用類型的參數(shù)設(shè)定方式?？上У氖窃趐hp5.x擴(kuò)展上面，經(jīng)過(guò)實(shí)驗(yàn)證明，引用方式的參數(shù)設(shè)定無(wú)效。

Php::ByVal 是代表值類型的參數(shù)的設(shè)定方式，總共有兩個(gè)函數(shù)原型定義。

第一種原型是給標(biāo)量，數(shù)組，對(duì)象，匿名函數(shù)等參數(shù)類型使用的，其C++的函數(shù)定義如下。

/**
 *  ByVal 值類型的參數(shù)的設(shè)定方式
 *  @param  name        參數(shù)名稱
 *  @param  type        參數(shù)類型
 *  @param  required    參數(shù)是否必填，默認(rèn)必填
 */
ByVal(const char *name, Php::Type type, bool required = true);

第二種原型是給具有特定類名的函數(shù)參數(shù)使用的，其C++的函數(shù)定義如下。

/**
 *  ByVal 值類型的參數(shù)的設(shè)定方式
 *  @param  name        參數(shù)名稱
 *  @param  classname   參數(shù)類名
 *  @param  nullable    是否可以為空
 *  @param  required    參數(shù)是否必填，默認(rèn)必填
 */
ByVal(const char *name, const char *classname, bool nullable = false, bool required = true);

值得注意的是，PHP不存在所謂函數(shù)參數(shù)名這個(gè)說(shuō)法，上面函數(shù)參數(shù)里面的name只是起一個(gè)助記符的作用，主要是在參數(shù)類型錯(cuò)誤等異常情況下，拋出異常的錯(cuò)誤信息里面使用，方便用戶知道具體是哪個(gè)參數(shù)有問(wèn)題。

ByVal函數(shù)中的Php::Type是個(gè)C++的枚舉量，代表PHP-CPP的函數(shù)參數(shù)，總共支持以下11種類型。

Php::Type::Null     - 表示任何類型都可以傳入
Php::Type::Numeric  - 整數(shù)類型
Php::Type::Float    - 數(shù)值類型，支持整數(shù)、單精度浮點(diǎn)數(shù)、雙精度浮點(diǎn)數(shù)
Php::Type::Bool     - 布爾類型
Php::Type::Array    - 數(shù)組類型
Php::Type::Object         - 對(duì)象類型
Php::Type::String         - 字符串類型
Php::Type::Resource       - 資源類型（保存有為打開(kāi)文件、數(shù)據(jù)庫(kù)連接、圖形畫(huà)布區(qū)域等的特殊句柄）
Php::Type::Constant       - 常量類型
Php::Type::ConstantArray  - 常量數(shù)組類型
Php::Type::Callable       - 函數(shù)類型

除了 Php::Type::Array or Php::Type::Object 這兩個(gè)類型的參數(shù)使用起來(lái)比較特殊，必須使用專用的對(duì)應(yīng)的C++類來(lái)操作。其他類型使用起來(lái)基本上差別不大，因?yàn)镻HP::Value這個(gè)類已經(jīng)做了類型重載處理，。

對(duì)于階乘運(yùn)算函數(shù)，我們都知道，需要而且只需傳入一個(gè)正整數(shù)類型即可。
下面是該擴(kuò)展函數(shù)的C++源碼

//演示階乘
Php::Value pm_factorial(Php::Parameters ¶ms)
{
    int n = (int)params[0];
    if(n < 0 )
        return 0;
    int i,f=1;
    for(i=1;i<=n;i++)
        f *= i;
    return f;
}

注冊(cè)擴(kuò)展函數(shù)的代碼

myExtension.add("pm_factorial", {
            Php::ByVal("a", Php::Type::Numeric)
});

PHP測(cè)試代碼（test/1.php）

測(cè)試返回結(jié)果

# php test/1.php

-----TEST pm_factorial()-----
PHP Warning:  pm_factorial() expects at least 1 parameter(s), 0 given in /data/develop/phpcpp_param/test/1.php on line 3
NULL

-----TEST pm_factorial("abc")-----
int(1)

-----TEST pm_factorial("5")-----
int(120)

-----TEST pm_factorial(0)-----
int(1)

-----TEST pm_factorial(10)-----
int(3628800)

-----TEST pm_factorial(-10)-----
int(0)

-----TEST pm_factorial(5.3)-----
int(120)

根據(jù)以上測(cè)試結(jié)果，可以總結(jié)出：

對(duì)于整數(shù)類型參數(shù)，會(huì)自動(dòng)把浮點(diǎn)數(shù)強(qiáng)制轉(zhuǎn)成整形。

參數(shù)不足的時(shí)候，將會(huì)生成一個(gè)PHP警告，返回值為NULL。

整數(shù)類型的參數(shù)自動(dòng)會(huì)轉(zhuǎn)換字符串類型，無(wú)法轉(zhuǎn)換時(shí)則轉(zhuǎn)換成0。

以演示兩個(gè)數(shù)字相加為例，我們希望傳入兩個(gè)參數(shù)，而且兩個(gè)參數(shù)都是數(shù)值類型。
下面是該擴(kuò)展函數(shù)的C++源碼

//演示兩個(gè)數(shù)相加
Php::Value pm_add(Php::Parameters ¶ms)
{
    return params[0] + params[1];
}

注冊(cè)擴(kuò)展函數(shù)的代碼

myExtension.add("pm_add", {
            Php::ByVal("a", Php::Type::Float),
            Php::ByVal("b", Php::Type::Float)
});

PHP測(cè)試代碼（test/2.php）

運(yùn)行測(cè)試代碼，返回結(jié)果

# php test/2.php 

-----TEST pm_add()-----
PHP Warning:  pm_add() expects at least 2 parameter(s), 0 given in /data/develop/phpcpp_param/test/1.php on line 3
NULL

-----TEST pm_add(1)-----
PHP Warning:  pm_add() expects at least 2 parameter(s), 1 given in /data/develop/phpcpp_param/test/1.php on line 6
NULL

-----TEST pm_add("abc","def")-----
int(0)

-----TEST pm_add("1","2")-----
int(3)

-----TEST pm_add(1,2)-----
int(3)

-----TEST pm_add(1.3,2.4)-----
float(3.7)

根據(jù)以上測(cè)試結(jié)果，可以總結(jié)出：

對(duì)于數(shù)值類型參數(shù)，整數(shù)，浮點(diǎn)數(shù)都支持。

參數(shù)不足的時(shí)候，將會(huì)生成一個(gè)PHP警告，返回值為NULL。

數(shù)值類型的參數(shù)自動(dòng)會(huì)轉(zhuǎn)換字符串類型的數(shù)值，無(wú)法轉(zhuǎn)換時(shí)則轉(zhuǎn)換成0。

由于篇幅有限，其他的參數(shù)類型下一章節(jié)繼續(xù)演示。

PHP-CPP官網(wǎng) - 關(guān)于函數(shù)參數(shù)