# 15.2 包装器操作 # 包装器操作 除了url\_stat()函数, 包装器操作中在const char \*label元素之前的每个操作都可以用于激活的流实例上. 每个函数的意义如下: stream\_opener() 实例化一个流实例. 当某个用户空间的fopen()函数被调用时, 这个函数将被调用. 这个函数返回的php\_stream实例是fopen()函数返回的文件资源句柄的内部表示. 集成函数比如file(), file\_get\_contents(), file\_put\_contents(), readfile()等等, 在请求包装资源时, 都使用这个包装器ops. stream\_closer() 当一个流实例结束其生命周期时这个函数被调用. stream\_opener()时分配的所有资源都应该在这个函数中被释放. stream\_stat() 类似于用户空间的fstat()函数, 这个函数应该填充ssb结构体(实际上只包含一个struct statbuf sb结构体成员), dir\_opener() 和stream\_opener()行为一致, 不过它是调用opendir()一族的用户空间函数时被调用的. 目录流使用的底层流实现和文件流遵循相同的规则;不过目录流只需要返回包含在打开的目录中找到的文件名的记录, 它的大小为struct dirent这个结构体的大小. ## 静态包装器操作 包装器操作函数中的其他函数是在URI路径上执行原子操作, 具体取决于包装器协议. 在php4.3的php\_stream\_wrapper\_ops结构体中只有url\_stat()和unlink(); 其他的方式是到php 5.0后才定义的, 编码时应该适时的使用#ifdef块说明. url\_stat() stat()族函数使用, 返回文件元数据, 比如访问授权, 大小, 类型; 以及访问, 修改,创建时间. 尽管这个函数是在php 4.3引入流包装层时出现在php\_stream\_wrapper\_ops结构体中的, 但直到php 5.0才被用户空间的stat()函数使用. unlink() 和posix文件系统的同名函数语义相同, 它执行文件删除. 如果对于当前的包装器删除没有意义, 比如内建的http://包装器, 这个函数应该被定义为NULL, 以便内核去引发适当的错误消息. rename() 当用户空间的rename()函数的参数$from和$to参数指向的是相同的底层包装器实现, php则将这个重命名请求分发到包装器的rename函数. mkdir() & rmdir() 这两个函数直接映射到对应的用户空间函数. ## links - [目录](preface.md) - 15.1 [php流的表象之下](15.1.html) - 15.3 [实现一个包装器](15.3.html)