咨询PHP copy类函数路径参数的进阶用法及相关文档

核心概念：Stream Wrapper #

PHP 的文件操作函数（比如copy()、file_get_contents()、file_put_contents()）并非仅支持本地文件路径，它们依赖**Stream Wrapper（流包装器）**处理不同类型的资源路径。你看到的zip://就是 PHP 内置的一种流包装器，专门用来访问 ZIP 压缩包内的文件。

常用内置流包装器 #

以下是直接可用的内置流包装器：

• file://：默认本地文件系统路径，即熟悉的/path/to/file或C:\file.txt，可省略不写
• zip://：访问 ZIP 包内文件，语法为zip:///path/to/archive.zip#internal/file/path（Windows 下为zip://C:/path/to/archive.zip#internal/file）
• phar://：访问 PHAR 归档内文件，语法类似phar:///path/to/app.phar/src/script.php
• http:///https://：直接读取远程 HTTP/HTTPS 文件，例如copy('https://example.com/file.jpg', 'local.jpg')
• ftp:///ftps://：访问 FTP 服务器文件，支持匿名或带认证路径，比如ftp://user:pass@ftp.example.com/file.txt
• php://：访问 PHP 输入输出流，常用的有php://stdin、php://stdout、php://memory（内存临时文件）、php://temp（满阈值后转磁盘的临时文件）
• data://：直接嵌入数据，比如data:text/plain;base64,SGVsbG8gV29ybGQh，可读取内嵌文本或二进制数据

关键语法规则 #

• 流包装器统一格式为wrapper://target，target格式由对应包装器定义
• 归档类包装器（zip://、phar://）用#分隔压缩包路径与内部文件路径（部分文档会写!，但#是标准写法）
• 远程包装器（http://、ftp://）支持 URL 标准参数，比如查询字符串、端口号

使用限制与注意事项 #

• 配置依赖：部分包装器需开启 PHP 配置，比如allow_url_fopen设为On才能用 http://、ftp:// 等远程包装器；phar扩展需启用才能使用phar://
• 读写权限：不是所有包装器都支持读写，比如http://仅支持读取，无法写入；zip://默认只读，写入需配合 ZipArchive 类；file://支持完整读写
• 性能与资源：远程包装器依赖网络，速度慢且易超时；php://memory受内存限制，大文件建议用php://temp
• 路径转义：路径含特殊字符（如#）时，需用urlencode()处理，避免解析错误

自定义流包装器 #

PHP 允许通过stream_wrapper_register()函数注册自定义流包装器，用来处理云存储、数据库文件等自定义资源类型，属于进阶用法。

示例代码 #

• 从 ZIP 包复制文件到本地：

  copy('zip:///var/files/archive.zip#docs/readme.txt', '/home/user/readme.txt');
  

• 读取远程 HTTP 文件：

  $content = file_get_contents('https://example.com/api/data.json');
  

• 使用内存流临时存储：

  $handle = fopen('php://memory', 'r+');
  fwrite($handle, 'Temporary data');
  rewind($handle);
  echo fread($handle, 1024);
  fclose($handle);
  

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