PHP扩展开发C基础教程

PHP扩展开发C基础教程

PHP扩展是用C或C++写的动态库。扩展可以提升性能或调用底层库。今天说说PHP扩展开发的基础知识。

一个最简单的扩展函数。

```c
// hello.c
#include

PHP_FUNCTION(hello_from_c) {
RETURN_STRINGL("Hello from C!", 13);
}

const zend_function_entry hello_functions[] = {
PHP_FE(hello_from_c, NULL)
PHP_FE_END
};

zend_module_entry hello_module_entry = {
STANDARD_MODULE_HEADER,
"hello",
hello_functions,
NULL, NULL, NULL, NULL, NULL,
"1.0.0",
STANDARD_MODULE_PROPERTIES
};

ZEND_GET_MODULE(hello_module_entry)
```

编译安装后在PHP里调用。

```php
echo hello_from_c();
?>

用PHP-CPP扩展库更方便。

```cpp
#include

class Calculator : public Php::Base {
public:
Php::Value add(Php::Parameters& params) {
return params[0].numericValue() + params[1].numericValue();
}

Php::Value factorial(Php::Parameters& params) {
int n = params[0].numericValue();
long result = 1;
for (int i = 2; i <= n; i++) result *= i;
return result;
}
};

extern "C" {
PHPCPP_EXPORT void *get_module() {
static Php::Extension ext("calc", "1.0.0");
ext.add("Calculator");
ext.add("Calculator::add", &Calculator::add);
ext.add("Calculator::factorial", &Calculator::factorial);
return ext;
}
}
```

PHP端调用。

```php
$calc = new Calculator();
echo $calc->add(10, 20) . "\n";
echo $calc->factorial(10) . "\n";
?>

扩展开发需要了解PHP的zval和HashTable结构。

```c
// 操作PHP数组
PHP_FUNCTION(cpp_array_sum) {
zval *arr;
if (zend_parse_parameters(ZEND_NUM_ARGS(), "a", &arr) == FAILURE) {
RETURN_FALSE;
}

double sum = 0.0;
HashTable *ht = Z_ARRVAL_P(arr);
zval *val;

ZEND_HASH_FOREACH_VAL(ht, val) {
switch (Z_TYPE_P(val)) {
case IS_LONG: sum += Z_LVAL_P(val); break;
case IS_DOUBLE: sum += Z_DVAL_P(val); break;
default: break;
}
} ZEND_HASH_FOREACH_END();

RETURN_DOUBLE(sum);
}
```

扩展开发的场景。性能关键的计算可以用C加速，调用已有的C/C++库，给PHP增加系统级能力。大部分PHP项目不需要写扩展，内置函数已经够用了。写扩展主要是为了理解PHP底层工作原理。