在PHP的文件操作场景中，copy()函数是实现文件复制的常用工具，它的核心作用是将一个文件从源路径复制到目标路径。但很多开发者在使用时会遇到源路径为目录导致的错误，这是因为copy()函数本身仅支持复制普通文件，无法直接处理目录的复制操作。
copy()函数的基本用法
copy()函数的语法格式非常简单，接收两个必填参数，第一个是源文件路径，第二个是目标文件路径，函数执行成功返回true，失败返回false。下面是一个最基础的使用示例：
<?php
$source = '/tmp/test.txt';
$dest = '/home/user/test_copy.txt';
if (copy($source, $dest)) {
echo '文件复制成功';
} else {
echo '文件复制失败';
}
?>
源路径为目录时报错的原因
当传入copy()函数的源路径是一个目录时，函数会直接返回false并报错，这是因为copy()函数的底层实现仅针对普通文件设计，不支持目录的递归复制逻辑。如果需要对目录进行复制，需要开发者自行实现目录遍历和文件复制的逻辑，不能直接调用copy()函数。
避免错误的常用方法
1. 使用is_file()函数判断源路径
is_file()函数可以判断给定路径是否为一个普通文件，如果是文件返回true，是目录或者其他类型返回false。在调用copy()之前先使用该函数校验，就能避免传入目录的问题：
<?php
$source = '/tmp/test_dir';
$dest = '/home/user/test_dir_copy';
if (is_file($source)) {
if (copy($source, $dest)) {
echo '文件复制成功';
} else {
echo '文件复制失败';
}
} else {
echo '源路径不是普通文件，无法使用copy函数复制';
}
?>
2. 结合is_dir()函数做二次校验
如果需要同时处理文件和目录的不同逻辑，可以先使用is_dir()判断是否为目录，再决定后续操作：
<?php
$source = '/tmp/test_dir';
$dest = '/home/user/test_dir_copy';
if (is_dir($source)) {
echo '源路径是目录，需要走目录复制逻辑';
// 这里可以编写目录复制的相关代码
} elseif (is_file($source)) {
if (copy($source, $dest)) {
echo '文件复制成功';
} else {
echo '文件复制失败';
}
} else {
echo '源路径不存在或者不是有效的文件/目录';
}
?>
3. 封装通用的复制校验函数
为了提升代码复用性，可以把路径判断和复制逻辑封装成一个通用函数，方便多处调用：
<?php
/**
* 安全复制文件的函数
* @param string $source 源路径
* @param string $dest 目标路径
* @return bool 复制成功返回true，失败返回false
*/
function safeCopyFile($source, $dest) {
// 先判断源路径是否存在
if (!file_exists($source)) {
return false;
}
// 判断是否为普通文件
if (!is_file($source)) {
return false;
}
// 执行复制操作
return copy($source, $dest);
}
// 调用示例
$source = '/tmp/data.log';
$dest = '/home/user/data_backup.log';
if (safeCopyFile($source, $dest)) {
echo '复制成功';
} else {
echo '复制失败，请检查源路径是否为普通文件';
}
?>
注意事项
- 判断路径类型前最好先使用
file_exists()函数确认路径是否存在，避免判断函数返回意外结果。 - 如果目标路径所在的目录不存在，copy()函数也会执行失败，需要提前使用
is_dir()和mkdir()函数创建目标目录。 - 对于跨磁盘或者权限受限的路径，即使源路径是普通文件，也可能因为权限问题导致复制失败，需要额外处理权限相关的异常。