如何使用Guzzle HTTP读取本地文件 解决file协议不支持报错

该报错的核心原因是GuzzleHTTP默认仅允许http、https两类协议的请求，file://协议不在默认的许可白名单内，即使底层libcurl库本身支持该协议，也会被Guzzle的配置拦截。同时你使用的file://localhost/写法属于非标准的本地文件协议格式，也会提升报错概率。

• 第一步：修正file协议的写法
  访问本地文件的标准file协议格式为file:/// + 本地文件绝对路径，不需要追加localhost，示例如下：

  • Linux/Mac 路径：file:///home/admin/test.html
  • Windows 路径：file:///C:/Users/admin/test.html

• 第二步：显式在Guzzle配置中开启file协议许可
  初始化Guzzle客户端时，在配置项中添加file协议到允许的协议列表，示例代码如下：

  $client = new \GuzzleHttp\Client([
      'allow_redirects' => [
          // 追加file到许可协议列表，保留原有需要的http/https协议
          'protocols' => ['http', 'https', 'file']
      ]
  ]);
  
  // 发起file协议请求
  $response = $client->get('file:///home/admin/test.html');
  

• 第三步：（可选）验证libcurl的file协议支持
  如果修改配置后仍然报错，可执行命令curl --version查看输出的支持协议列表中是否包含file，如果没有则需要重新编译安装libcurl，开启file协议的编译选项。

开启file协议支持存在安全风险，如果你的Guzzle客户端会处理用户传入的不可信URL，攻击者可以构造特殊的file路径读取服务器上的敏感文件。如果仅需要读取本地文件，优先使用PHP原生的file_get_contents、fopen等文件操作函数，效率更高也更安全。

内容的提问来源于stack exchange，提问作者Zain Ali