前言
啥是流操作?简单来讲就是对一些文件,网络的IO操作。PHP已经把这些IO操作,封装成流操作。这节,我们将使用PHP扩展实现一个目录遍历的功能。PHP示例代码如下:
<?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/www.bo56.com
/Users/canglong/dev/test/gc/www.bo56.com
我们将在扩展中list_dir方法。
代码
基础代码
这个扩展,我们将在say扩展上增加list_dir方法代码。say扩展相关代码大家请看这篇博文。PHP7扩展开发之hello word 文中已经详细介绍了如何创建一个扩展和提供了源码下载。
代码实现
第一步,先引入头文件:
#include "ext/standard/php_filestat.h"
第二步,实现list_dir
函数
list_dir
函数的代码如下:
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
关闭目录流。参数是之前打开的流。
源码下载
原文链接:PHP7扩展开发之流操作