lostphp

just do it

基于PHP7的PHP扩展开发之十三(进行流的操作)

目的:在扩展中进行流的操作。简单来讲就是对一些文件,网络的IO操作。PHP已经把这些IO操作,封装成流操作。
使用PHP扩展实现一个目录遍历的功能。

PHP示例代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?php
function list_dir($dir) {
    if (is_dir($dir) === false) {
        return;
    }   
 
    $dh = opendir($dir);
    if ($dh == false) {
        return;
    }   
 
    while (($file = readdir($dh)) !== false) {
        if(is_dir($dir."/".$file) && $file != "." && $file != "..") {
            list_dir($dir."/".$file);
        } else if ($file != "." && $file != "..") {
            echo $dir."/".$file."\n";
        }   
    }   
    closedir($dh);
}
 
list_dir("/Users/canglong/dev/test/gc");
?>

执行后输出内容是:

/Users/canglong/dev/test/gc/blog/lostphp.com
/Users/canglong/dev/test/gc/lostphp.com

我们将在扩展中list_dir方法。

基础代码

这个扩展,我们将在myecho扩展上增加list_dir方法代码。

第一步,先引入头文件:

1
#include "ext/standard/php_filestat.h"

第二步,实现list_dir函数 list_dir函数的代码如下:

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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
void list_dir(const char *dir);
 
PHP_FUNCTION(list_dir)
{
    char *dir;
    size_t dir_len;
 
#ifndef FAST_ZPP
    /* Get function parameters and do error-checking. */
    if (zend_parse_parameters(ZEND_NUM_ARGS(), "s", &dir, &dir_len) == FAILURE) {
        return;
    }
#else
    ZEND_PARSE_PARAMETERS_START(1, 1)
    Z_PARAM_PATH(dir, dir_len)
    ZEND_PARSE_PARAMETERS_END();
#endif
 
 
    php_stat(dir, (php_stat_len) dir_len, FS_IS_DIR, return_value);
 
    if (Z_TYPE_P(return_value) == IS_FALSE) {
        RETURN_NULL();
    }
 
    list_dir(dir);
 
    RETURN_NULL();
}
 
void list_dir(const char *dir)
{
    php_stream *stream;
    int options = REPORT_ERRORS;
    php_stream_dirent entry;
    int path_len;
    char path[MAXPATHLEN];
    zend_stat_t st;
 
    stream = php_stream_opendir(dir, options, NULL);
    if (!stream) {
        return;
    }
 
    while(php_stream_readdir(stream, &entry)) {
        if ((path_len = snprintf(path, sizeof(path), "%s/%s", dir, entry.d_name)) 小于 0) {
            break;
        }
        if (zend_stat(path, &st) != -1 && S_ISDIR(st.st_mode) && strcmp(entry.d_name, ".") != 0
                && strcmp(entry.d_name, "..") != 0) {
            list_dir(path);
        } else if (strcmp(entry.d_name, ".") != 0 && strcmp(entry.d_name, "..") != 0) {
            PUTS(path);
            PUTS("\n");
        }
    }
    php_stream_closedir(stream);
}

代码解读

首先说下路径状态的判断。 php_stat函数是PHP中is_dir函数在实现的时候,使用的一个函数。具体代码参见ext/standard/filestat.c文件的FileFunction宏方法。在1092行附近。这个函数是判断一个路径的状态。如,是否是文件夹等。一般在扩展实现的时候,不建议使用。这里只是为了演示,才使用的。

zend_stat宏方法。也是实现判断一个路径的状态。推荐在扩展中使用。如果调用有问题,会返回-1。

PHP把一些IO操作都封装成了流操作。这些流操作都声明在main/php_streams.h文件中。下面我们说下,我们用到的流操作函数。

php_stream_opendir函数是用于打开一个目录。

第一个参数:路径
第二个参数:选项。控制一些函数调用行为。定义在main/php_streams.h中。多个选项可以使用异或操作。如 int options = IGNORE_PATH | REPORT_ERRORS;
php_stream_readdir读取目录流。

第一个参数:上面函数打开的stream流
第二个参数:php_stream_dirent 用于存储当前读取的信息。
php_stream_closedir关闭目录流。参数是之前打开的流。

点赞

发表评论

电子邮件地址不会被公开。 必填项已用*标注