# 包裝器操作
除了url_stat()函數, 包裝器操作中在const char *label元素之前的每個操作都可以用于激活的流實例上. 每個函數的意義如下:
<table>
<tr>
<td>stream_opener()</td>
<td>
實例化一個流實例. 當某個用戶空間的fopen()函數被調用時, 這個函數將被調用. 這個函數返回的php_stream實例是fopen()函數返回的文件資源句柄的內部表示. 集成函數比如file(), file_get_contents(), file_put_contents(), readfile()等等, 在請求包裝資源時, 都使用這個包裝器ops.
</td>
</tr>
<tr>
<td>stream_closer()</td>
<td>
當一個流實例結束其生命周期時這個函數被調用. stream_opener()時分配的所有資源都應該在這個函數中被釋放.
</td>
</tr>
<tr>
<td>stream_stat()</td>
<td>
類似于用戶空間的fstat()函數, 這個函數應該填充ssb結構體(實際上只包含一個struct statbuf sb結構體成員),
</td>
</tr>
<tr>
<td>dir_opener()</td>
<td>
和stream_opener()行為一致, 不過它是調用opendir()一族的用戶空間函數時被調用的. 目錄流使用的底層流實現和文件流遵循相同的規則;不過目錄流只需要返回包含在打開的目錄中找到的文件名的記錄, 它的大小為struct dirent這個結構體的大小.
</td>
</tr>
</table>
## 靜態包裝器操作
包裝器操作函數中的其他函數是在URI路徑上執行原子操作, 具體取決于包裝器協議. 在php4.3的php_stream_wrapper_ops結構體中只有url_stat()和unlink(); 其他的方式是到php 5.0后才定義的, 編碼時應該適時的使用#ifdef塊說明.
<table>
<tr>
<td>url_stat()</td>
<td>
stat()族函數使用, 返回文件元數據, 比如訪問授權, 大小, 類型; 以及訪問, 修改,創建時間. 盡管這個函數是在php 4.3引入流包裝層時出現在php_stream_wrapper_ops結構體中的, 但直到php 5.0才被用戶空間的stat()函數使用.
</td>
</tr>
<tr>
<td>unlink()</td>
<td>
和posix文件系統的同名函數語義相同, 它執行文件刪除. 如果對于當前的包裝器刪除沒有意義, 比如內建的http://包裝器, 這個函數應該被定義為NULL, 以便內核去引發適當的錯誤消息.
</td>
</tr>
<tr>
<td>rename()</td>
<td>
當用戶空間的rename()函數的參數$from和$to參數指向的是相同的底層包裝器實現, php則將這個重命名請求分發到包裝器的rename函數.
</td>
</tr>
<tr>
<td>mkdir() & rmdir()</td>
<td>
這兩個函數直接映射到對應的用戶空間函數.
</td>
</tr>
</table>
## links
* [目錄](<preface.md>)
* 15.1 [php流的表象之下](<15.1.md>)
* 15.3 [實現一個包裝器](<15.3.md>)
- about
- 開始閱讀
- 目錄
- 1 PHP的生命周期
- 1.讓我們從SAPI開始
- 2.PHP的啟動與終止
- 3.PHP的生命周期
- 4.線程安全
- 5.小結
- 2 PHP變量在內核中的實現
- 1. 變量的類型
- 2. 變量的值
- 3. 創建PHP變量
- 4. 變量的存儲方式
- 5. 變量的檢索
- 6. 類型轉換
- 7. 小結
- 3 內存管理
- 1. 內存管理
- 2. 引用計數
- 3. 總結
- 4 動手編譯PHP
- 1. 編譯前的準備
- 2. PHP編譯前的config配置
- 3. Unix/Linux平臺下的編譯
- 4. 在Win32平臺上編譯PHP
- 5. 小結
- 5 Your First Extension
- 1. 一個擴展的基本結構
- 2. 編譯我們的擴展
- 3. 靜態編譯
- 4. 編寫函數
- 5. 小結
- 6 函數返回值
- 1. 一個特殊的參數:return_value
- 2. 引用與函數的執行結果
- 3. 小結
- 7 函數的參數
- 1. zend_parse_parameters
- 2. Arg Info 與類型綁定
- 3. 小結
- 8 使用HashTable與{數組}
- 1. 數組(C中的)與鏈表
- 2. 操作HashTable的API
- 3. 在內核中操作PHP語言中數組
- 4. 小結
- 9 PHP中的資源類型
- 1. 復合類型的數據——{資源}
- 2. Persistent Resources
- 3. {資源}自有的引用計數
- 4. 小結
- 10 PHP中的面向對象(一)
- 1. zend_class_entry
- 2. 定義一個類
- 3. 定義一個接口
- 4. 類的繼承與接口的實現
- 5. 小結
- 11 PHP中的面向對象(二)
- 1. 生成對象的實例與調用方法
- 2. 讀寫對象的屬性
- 3. 小結
- 12 啟動與終止的那點事
- 2. 小結
- 1. 關于生命周期
- 2. MINFO與phpinfo
- 3. 常量
- 4. PHP擴展中的全局變量
- 5. PHP語言中的超級全局變量
- 6. 小結
- 13 INI設置
- 1. 聲明和訪問ini設置
- 2. 小結
- 2. 小結
- 14 流式訪問
- 1. 概覽
- 2. 打開流
- 3. 訪問流
- 4. 靜態資源操作
- 5. 小結
- 15 流的實現
- 1. php流的表象之下
- 2. 包裝器操作
- 3. 實現一個包裝器
- 4. 操縱
- 5. 檢查
- 6. 小結
- 16 有趣的流
- 1. 上下文
- 2. 過濾器
- 3. 小結
- 17 配置和鏈接
- 1. autoconf
- 2. 庫的查找
- 3. 強制模塊依賴
- 4. Windows方言
- 5. 小結
- 18 擴展生成
- 1. ext_skel
- 2. PECL_Gen
- 3. 小結
- 19 設置宿主環境
- 1. 嵌入式SAPI
- 2. 構建并編譯一個宿主應用
- 3. 通過嵌入包裝重新創建cli
- 4. 老技術新用
- 5. 小結
- 20 高級嵌入式
- 1. 回調到php中
- 2. 錯誤處理
- 3. 初始化php
- 4. 覆寫INI_SYSTEM和INI_PERDIR選項
- 5. 捕獲輸出
- 6. 同時擴展和嵌入
- 7. 小結
- 約定