萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP fopen 函數詳解:模式參數、串流封裝協議與跨平台換行處理

函數原型

fopen(string $filename, string $mode, bool $use_include_path = false, ?resource $context = null): resource|false

模式參數完整對照

模式讀/寫指標位置截斷檔案建立檔案備註
r唯讀開頭否否檔案必須存在
r+讀寫開頭否否
w唯寫開頭是是清空現有內容
w+讀寫開頭是是
a唯寫結尾否是追加模式
a+讀寫結尾否是
x唯寫開頭否是排他建立,存在則失敗 (PHP 4.3.2+)
x+讀寫開頭否是排他建立
c唯寫開頭否是不截斷,不排他 (PHP 5.2.6+)
c+讀寫開頭否是

串流封裝協議 (Wrappers)

  • `file://`:本地檔案 (預設)
  • `https://`、`https://`:HTTP 請求 (需 `allow_url_fopen=On`)
  • `ftp://`、`ftps://`:FTP
  • `php://input`、`php://output`、`php://memory`、`php://temp`
  • `data://`:Data URI
  • `zlib://`、`compress.zlib://`:壓縮串流
  • 自定義:`stream_wrapper_register()`

跨平台換行符處理

作業系統換行符PHP 模式標記
Unix/Linux/macOSLF (\n)`b` (二進制、不轉換)
WindowsCRLF (\r\n)`t` (文字模式、自動 \n→\r\n)
Classic MacCR (\r)—

最佳實踐:總是顯式指定 `b` 標記 (如 `rb`、`wb`、`ab`),確保跨平台行為一致,避免圖片損壞、CSV 解析錯誤。

Context 參數進階用法

<?php
// HTTP POST 請求
$ctx = stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => http_build_query(['foo' => 'bar']),
        'timeout' => 10,
    ]
]);
$fp = fopen('https://api.example.com/endpoint', 'rb', false, $ctx);
$response = stream_get_contents($fp);
fclose($fp);

// 限制讀取大小
$ctx = stream_context_create(['php' => ['memory_limit' => '16M']]);
$fp = fopen('large.log', 'rb', false, $ctx);
?>

常見錯誤與排查

  • Permission denied:檢查檔案/目錄權限、SELinux、open_basedir 限制
  • No such file or directory:相對路徑問題,使用 `__DIR__` 或絕對路徑
  • HTTP wrapper does not support writeable connections:HTTP 只支援讀取,寫入需用 cURL 或 `fopen('php://output')` 配合 context
copyright © 萬盛學電腦網 all rights reserved