PHP copy怎么用-php教程-PHP中文网

copy() 要求源路径必须是真实文件且目标父目录存在可写，否则静默失败；需用 is_file() 校验源、mkdir(..., true) 创建父目录、error_get_last() 获取错误详情，并对大文件或关键数据采取流式复制与完整性校验。

php copy怎么用

copy() 函数能直接复制文件，但不是“传进去就能用”——它对参数类型、路径状态和权限极其敏感，稍不注意就会静默失败或报致命警告。

为什么 copy() 会报 “The first argument to copy() function cannot be a directory”

这个警告不是偶然，而是 copy() 的硬性限制：第一个参数必须是普通文件（regular file），不能是目录、符号链接（未解析）、socket、设备节点等。

常见诱因：用 scandir() 遍历目录后，没过滤 .、.. 和子目录，直接把目录名当文件传给 copy()
file_exists() 不够用：它对目录、链接、管道都返回 true
is_dir() 也不行：它只帮你排除目录，但无法确认剩下的是不是真文件

✅ 正确做法：

必须用 is_file($source) 显式校验源路径是否为真实文件
搭配 realpath($source) 可进一步规避符号链接绕过检查的风险（可选但推荐）

目标路径不存在时 copy() 会直接失败

copy() 不会自动创建父目录。哪怕 /uploads/2026/08/ 不存在，传入 copy('a.jpg', '/uploads/2026/08/b.jpg') 就会返回 false，且无明确错误提示。

is_writable() 对目标父目录才有效，不是对目标文件路径本身
创建目录要用 mkdir($dir, 0755, true)，第三个参数 true 表示递归创建
注意权限掩码：在某些服务器上 0777 可能被 umask 修正，0755 更稳妥

✅ 推荐流程：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用 dirname($destination) 提取父目录路径
用 is_dir() + is_writable() 检查该目录是否存在且可写
若不存在，调用 mkdir(..., 0755, true)

copy() 失败时怎么拿到真正原因

copy() 只返回 true/false，错误信息藏在 PHP 最近一次错误里。

不要用 @copy() 抑制警告再靠返回值判断——这会丢掉原始警告内容
失败后立刻调用 error_get_last()，它返回数组，其中 ['message'] 是关键线索
常见错误类型包括：
- failed to open stream: Permission denied → 源不可读或目标目录不可写
- No such file or directory → 父目录不存在（不是源文件不存在）
- Operation not permitted → SELinux 或容器环境限制

✅ 示例片段：

if (!copy($source, $dest)) {
    $err = error_get_last();
    error_log("copy failed: {$err['message']} ({$source} → {$dest})");
    throw new RuntimeException("Copy failed: " . $err['message']);
}