PHP 的 copy() 函数仅接受文件路径作为源参数，若传入目录路径将触发致命警告；解决方法是在调用前用 is_file() 显式校验路径是否为普通文件。
php 的 `copy()` 函数仅接受文件路径作为源参数，若传入目录路径将触发致命警告；解决方法是在调用前用 `is_file()` 显式校验路径是否为普通文件。
在 PHP 文件操作中，copy($source, $destination) 是一个常用函数，用于将文件从源路径复制到目标路径。但其设计有严格限制：第一个参数 $source 必须是一个可读的常规文件（regular file），不能是目录、符号链接（除非解析后指向文件）、设备节点或任何非文件实体。一旦误将目录路径传入（例如 copy('/path/to/dir/', '/dest/')），PHP 将立即抛出如下警告：
Warning: copy(): The first argument to copy() function cannot be a directory
该错误在批量处理目录内容（如迁移上传图片）时尤为常见——开发者常直接遍历 scandir() 返回的所有条目，却未区分文件与子目录，导致 copy() 被错误调用于目录名。
✅ 正确做法：始终校验源路径类型
应在调用 copy() 前，使用 is_file() 进行类型断言。它返回 true 仅当路径存在且为普通文件（排除目录、链接、socket 等）。示例修正代码如下：
<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);
$sourceDir = $_SERVER['DOCUMENT_ROOT'] . '/miga/uploads/';
$destinationDir = $_SERVER['DOCUMENT_ROOT'] . '/miga/media/';
// 确保目标目录存在且可写
if (!is_dir($destinationDir)) {
mkdir($destinationDir, 0755, true);
}
$files = scandir($sourceDir);
$delete = [];
$gravacao = [];
foreach ($files as $file) {
// 跳过当前目录和上级目录标识符
if (in_array($file, ['.', '..'])) {
continue;
}
$sourcePath = $sourceDir . $file;
// 关键校验：仅处理普通文件
if (!is_file($sourcePath)) {
continue; // 忽略目录、链接等非文件项
}
$destinationPath = $destinationDir . $file;
// 可选：进一步过滤图片扩展名（增强健壮性）
$ext = strtolower(pathinfo($file, PATHINFO_EXTENSION));
if (!in_array($ext, ['jpg', 'jpeg', 'png', 'gif'])) {
continue;
}
if (copy($sourcePath, $destinationPath)) {
$delete[] = $sourcePath;
$gravacao[] = $sourcePath; // 注意：原代码中 $source.$destination 逻辑有误，应为 $sourcePath 或 $destinationPath
echo "✓ Copied: $file\n";
} else {
echo "✗ Failed to copy: $file\n";
}
}
// 可选：批量删除已成功复制的源文件（谨慎使用！）
// foreach ($delete as $path) {
// unlink($path);
// }
?>⚠️ 注意事项与最佳实践
- is_file() ≠ file_exists()：后者仅检查路径是否存在，而 is_file() 同时验证存在性与类型，是更安全的选择；
- 避免 glob() 与 scandir() 混用冗余逻辑：原代码中同时使用 glob(...{jpg,png}...) 获取图片列表，又用 scandir() 遍历全部条目，属于逻辑重复。推荐统一使用 glob($sourceDir . '*.{jpg,jpeg,png,gif}', GLOB_BRACE | GLOB_NOSORT) 直接获取目标文件数组，既高效又语义清晰；
- 路径拼接需防注入与跨目录访问：确保 $file 不含 ../ 等危险片段，生产环境建议结合 basename() 过滤；
- 权限与错误处理：copy() 失败可能因源不可读、目标不可写或磁盘满，应配合 is_readable() / is_writable() 预检，并捕获返回值做分支处理；
- 大文件场景考虑内存与超时：copy() 是阻塞同步操作，超大文件建议改用 stream_copy_to_stream() 或分块读写。
通过在调用前强制校验文件类型，即可彻底规避 “cannot be a directory” 错误，让文件批量迁移逻辑健壮、可维护且符合 PHP 最佳实践。
立即学习“PHP免费学习笔记（深入）”；
