共享主机中PHP脚本通过Cron Job运行时无法保存图片的问题排查求助

从你的描述和代码来看，Cron环境下图片保存失败通常和环境变量差异、权限问题或者网络访问限制有关，结合你提到的“Cron不能用引入文件”的情况，咱们一步步排查：

1. $_SERVER['DOCUMENT_ROOT']在Cron环境中不存在 #

Cron运行脚本时是在CLI（命令行）环境，不是Web服务器环境，所以$_SERVER数组里很多变量（包括DOCUMENT_ROOT）是没有的！这会导致你的$target_path变成一个无效路径，自然无法保存文件。

解决办法： #

直接使用绝对路径，比如你可以通过__DIR__（当前脚本所在目录的绝对路径）来拼接，假设你的脚本在网站根目录下，那可以这样写：

// 替换原来的$_SERVER['DOCUMENT_ROOT']
$site_root = __DIR__; // 如果脚本在根目录，这就是网站根路径
$target_path = $site_root . "/admin/uploads/youtube_videos_testing/" . $new_image_link1;

或者你直接写死服务器上的绝对路径，比如/home/your_username/public_html/admin/uploads/youtube_videos_testing/（根据你的主机实际路径调整）。

2. 目录权限问题 #

Cron Job的执行用户可能和Web服务器的用户不一样（比如Web用apache或nginx，Cron用你的主机用户名），导致脚本没有权限写入uploads/youtube_videos_testing目录。

解决办法： #

• 给目标目录设置合适的权限：一般设置为755（如果需要写入，可能要775，但别用777，不安全）。
• 或者在保存文件前，先检查目录是否存在，不存在就创建：

$upload_dir = $site_root . "/admin/uploads/youtube_videos_testing/";
if (!is_dir($upload_dir)) {
    mkdir($upload_dir, 0755, true); // 递归创建目录
}
$target_path = $upload_dir . $new_image_link1;

3. file_get_contents无法访问外部图片 #

有些共享主机会限制CLI环境下的外部网络请求，或者目标图片URL有反爬机制（比如检查Referer、User-Agent），导致file_get_contents获取不到图片内容。

解决办法： #

• 给file_get_contents加上上下文参数，模拟浏览器请求：

$opts = [
    'http' => [
        'method' => 'GET',
        'header' => 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36'
    ]
];
$context = stream_context_create($opts);
$data = file_get_contents($image_outer_link, false, $context);

// 别忘了检查$data是否获取成功
if ($data === false) {
    // 可以记录错误日志，方便排查
    error_log("Failed to fetch image from: " . $image_outer_link);
    continue; // 跳过这个图片，继续处理下一个
}

• 如果主机限制了CLI的外部请求，你可以尝试用curl替代file_get_contents，很多主机对curl的限制更少：

$ch = curl_init($image_outer_link);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36');
$data = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($data === false || $http_code != 200) {
    error_log("Curl failed for image: " . $image_outer_link . ", HTTP code: " . $http_code);
    continue;
}

4. 错误日志排查 #

在Cron环境下，echo的内容不会显示在浏览器里，你可以把错误信息记录到日志文件里，方便排查：

// 在脚本开头开启错误日志
ini_set('log_errors', 1);
ini_set('error_log', __DIR__ . '/cron_error.log');

这样脚本运行时的错误（比如路径不存在、权限不足、网络错误）都会被记录到cron_error.log里，你可以查看这个文件找到具体问题。

总结修改后的关键代码片段 #

把这些修复点整合到你的代码里，那部分的代码可以改成这样：

// 替换原来的$_SERVER['DOCUMENT_ROOT']
$site_root = __DIR__; // 或者写死绝对路径
$upload_dir = $site_root . "/admin/uploads/youtube_videos_testing/";

// 检查并创建目录
if (!is_dir($upload_dir)) {
    mkdir($upload_dir, 0755, true);
}

$new_image_link1 = "video-" . $the_last_inserted_id . ".jpg";
$target_path = $upload_dir . $new_image_link1;

// 使用curl获取图片（更可靠）
$ch = curl_init($image_outer_link);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36');
$data = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($data !== false && $http_code == 200) {
    // 保存文件
    if (file_put_contents($target_path, $data)) {
        // 保存成功的逻辑
    } else {
        error_log("Failed to write file to: " . $target_path);
    }
} else {
    error_log("Failed to fetch image: " . $image_outer_link . ", HTTP code: " . $http_code);
}

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