PHP7.4新特性FFI初体验

PHP7.4正式版发布已经好久了,而主打的新特性是FFI,今天我也来体验一把😎

FFI提供了高级语言直接的互相调用,而对于PHP来说,FFI让我们可以方便的调用C语言写的各种库。

刚好,有个小需求需要调用c代码来获取命令行窗口的大小(行数和列数)。我们的c代码是:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// filename cli_size.c

/**
* 通过函数 ioctl() 获得终端界面的参数
* @see https://blog.csdn.net/weixin_42205987/article/details/82080615
*/

#include <stdio.h>
#include <sys/ioctl.h>
#include <unistd.h>

struct winsize get_size()
{
struct winsize size;
ioctl(STDIN_FILENO, TIOCGWINSZ, &size);
return size;
}

unsigned short get_cli_rows()
{
struct winsize size;
ioctl(STDIN_FILENO, TIOCGWINSZ, &size);
return size.ws_row;
}

unsigned short get_cli_cols()
{
struct winsize size;
ioctl(STDIN_FILENO, TIOCGWINSZ, &size);
return size.ws_col;
}

我们先把上面的c代码编译成动态链接库libcli_size.so:

1
gcc -O2 -fPIC -shared -g cli_size.c -o libcli_size.so

开始写我们的php代码:

首先我们使用FFI::cdef()函数声明我们要调用的这个库中的函数以及使用到的数据类型。

比如我们在这里要调用的三个函数get_cli_rows(获取行数)、 get_cli_cols(获取列数)、 get_size(获取所有信息),我们把他们的声明作为FFI::cdef()函数的第一个参数。看到下面的代码大家应该很熟悉,就是c语言的函数声明。
这里get_size方法返回是一个结构体struct winsize,所以我们也要把这个结构体的声明也写上。

FFI::cdef()函数的第二个参数就是我们自己的库文件名了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<?php
//filename cli_size.php

$ffi = FFI::cdef(<<<CTYPE
struct winsize {
unsigned short ws_row; /* rows, in characters */
unsigned short ws_col; /* columns, in characters */
unsigned short ws_xpixel; /* horizontal size, pixels */
unsigned short ws_ypixel; /* vertical size, pixels */
};
unsigned short get_cli_rows();
unsigned short get_cli_cols();
struct winsize get_size();
CTYPE, 'libcli_size.so');

接下来就是调用了

1
2
3
4
5

//继续上面的代码
var_dump($ffi->get_cli_rows());
var_dump($ffi->get_cli_cols());
var_dump($ffi->get_size());

然后运行它:

1
php cli_size.php

输出:

1
2
3
4
5
6
7
8
9
10
11
12
int(36)     // get_cli_rows()的结果
int(150) // get_cli_cols()的结果
object(FFI\CData:struct winsize)#2 (4) { // get_size()的结果,也就是winsize结构体,
["ws_row"]=>
int(36)
["ws_col"]=>
int(150)
["ws_xpixel"]=>
int(1200)
["ws_ypixel"]=>
int(684)
}

通过上面可以看出c语言返回的unsigned short类型在这里变成了php的int, 结构体struct winsize变成了一个FFI\CData对象。

那我们怎么从结构体对象中取某一个属性值呢?

就按普通对象操作就可以了:

1
2
3
//继续上面的代码

var_dump($ffi->get_size()->ws_row);

输出:

1
int(36)

对于其他的c语言类型,PHP官方文档上都有对应的php类型说明,大家可以去看看

以上示例代码都在这里

好了,新的编程体验,好不错吧~😎😎😎

参考:

打赏
  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!

请我喝杯咖啡吧~

支付宝
微信