PHP怎么获取文件内容并写入到另一个文件

在PHP开发中，获取一个文件的内容并写入到另一个文件，是日志归档、配置生成、数据迁移、缓存落盘以及上传文件处理等场景里经常遇到的需求。这类操作的核心并不只是简单调用函数，而是要结合文件大小、运行内存、写入模式、文件权限和并发安全等因素选择合适方案。小型文件可以直接读取为字符串再整体写入，大型文件则更适合通过文件句柄分块流转，以降低内存压力并提升稳定性。

一、读取文件内容：先判断可用性，再选择读取策略

读取文件的第一步并不是立刻调用函数，而是确认目标文件是否真实存在、是否具备读取权限。PHP提供了file_exists与is_readable两个函数，可以帮助开发者在正式读取前完成基础校验。如果跳过这一步，当文件缺失或权限不足时，程序可能抛出警告，甚至影响后续业务流程。

对于体积不大的文本文件、配置文件、JSON文件、模板文件等，file_get_contents是非常方便的选择。它会把整个文件内容一次性读取为字符串，开发者拿到字符串后即可进行解析、替换、拼接或写入新文件。这种方式代码简洁，适合大多数常规业务场景。

但如果文件体积较大，例如日志文件、导出数据文件、备份文件等，一次性读取全部内容可能会占用大量内存。这时更推荐使用fopen打开文件句柄，再配合fread按块读取。每次只处理一小段内容，可以有效控制内存消耗，也便于边读取边处理。

<?php
// 读取当前脚本同级目录下的配置文件
$filePath = __DIR__ . '/config.txt';

// 先判断文件是否存在并且可读
if (!file_exists($filePath) || !is_readable($filePath)) {
    echo '源文件不存在或不可读';
    exit;
}

// 一次性读取文件内容
$content = file_get_contents($filePath);

// file_get_contents 读取失败时返回 false
if ($content === false) {
    echo '读取失败';
} else {
    echo $content;
}
?>

分块读取的关键在于循环判断文件是否已经读取结束。feof可以用于检测文件指针是否到达末尾，而fread每次读取固定字节数。实际项目中可以根据服务器内存、磁盘IO和业务处理速度调整每次读取的块大小。

<?php
// 以只读方式打开一个较大的日志文件
$filePath = __DIR__ . '/app.log';

if (!file_exists($filePath) || !is_readable($filePath)) {
    echo '文件不存在或不可读';
    exit;
}

$handle = fopen($filePath, 'r');

if ($handle) {
    // 每次读取 4KB，避免一次性载入整个文件
    while (!feof($handle)) {
        $chunk = fread($handle, 4096);

        // 如果读取失败，则停止循环
        if ($chunk === false) {
            break;
        }

        // 这里可以继续处理每一块内容
        echo $chunk;
    }

    fclose($handle);
} else {
    echo '文件打开失败';
}
?>

二、写入目标文件：覆盖、追加与句柄写入的区别

写入文件时，最常见的方式是使用file_put_contents。这个函数适合把一段字符串快速写入指定文件。如果目标文件已经存在，默认会清空原内容后再写入，也就是覆盖模式。如果希望保留原内容，并在文件末尾继续追加，可以使用FILE_APPEND参数。

在实际项目中，覆盖写入常用于生成缓存文件、临时文件、配置文件或静态内容文件；追加写入则常用于日志记录、任务执行记录、访问记录等需要持续累积内容的场景。选择哪种模式，取决于业务是否允许旧内容被替换。

如果需要更细粒度地控制写入过程，可以使用fopen打开文件句柄，再通过fwrite写入内容。这种方式适合写入过程较复杂、需要分批次写入、需要在写入前后做额外处理，或者需要结合文件锁保证并发安全的场景。

<?php
$targetPath = __DIR__ . '/output.txt';

// 覆盖写入：如果文件已存在，会清空原内容
$content = '第一段写入的内容';
$bytes = file_put_contents($targetPath, $content);

if ($bytes !== false) {
    echo '覆盖写入成功，写入字节数：' . $bytes;
} else {
    echo '覆盖写入失败';
}

// 追加写入：保留原内容，在末尾增加新内容
$append = PHP_EOL . '第二段追加的内容';
$appendBytes = file_put_contents($targetPath, $append, FILE_APPEND);

if ($appendBytes !== false) {
    echo '追加写入成功，写入字节数：' . $appendBytes;
} else {
    echo '追加写入失败';
}
?>

使用fopen与fwrite时，需要特别注意打开模式。模式w会在文件不存在时创建文件，如果文件存在则清空内容；模式a会以追加方式打开文件，不会清空原内容。写入完成后应及时关闭句柄，避免资源长时间占用。

<?php
$targetPath = __DIR__ . '/stream-output.txt';
$content = '通过文件句柄写入的内容';

// w 模式会在文件不存在时创建，并截断已有内容
$handle = fopen($targetPath, 'w');

if ($handle) {
    $result = fwrite($handle, $content);

    if ($result !== false) {
        echo '写入成功，写入字节数：' . $result;
    } else {
        echo '写入失败';
    }

    fclose($handle);
} else {
    echo '目标文件打开失败';
}
?>

三、完整实现：从一个文件读取内容并写入另一个文件

把读取与写入组合起来，就形成了“获取文件内容并写入到另一个文件”的完整流程。对于中小型文件，可以直接使用file_get_contents读取源文件，再使用file_put_contents写入目标文件。这种方式逻辑清晰，代码量少，适合大多数普通文件复制、内容迁移或内容转存需求。

在写入前，建议检查目标目录是否可写。很多时候写入失败并不是代码问题，而是目标目录权限不足、路径不存在或磁盘空间不足。使用is_writable可以提前判断目录是否允许写入，从而让错误提示更加明确。

如果源文件与目标文件都位于当前脚本目录下，可以借助__DIR__拼接绝对路径。相比相对路径，绝对路径能减少因脚本执行入口不同而导致的路径偏差，提升代码稳定性。

<?php
$sourceFile = __DIR__ . '/source.txt';
$targetFile = __DIR__ . '/target.txt';

// 检查源文件是否可用
if (!file_exists($sourceFile) || !is_readable($sourceFile)) {
    echo '源文件不存在或不可读';
    exit;
}

// 检查目标目录是否可写
if (!is_writable(dirname($targetFile))) {
    echo '目标目录不可写';
    exit;
}

// 读取源文件内容
$content = file_get_contents($sourceFile);

// 将读取到的内容写入目标文件
$writeBytes = file_put_contents($targetFile, $content);

if ($writeBytes !== false) {
    echo '文件内容已成功写入新文件，字节数：' . $writeBytes;
} else {
    echo '写入新文件失败';
}
?>

如果文件较大，则不建议把全部内容一次性读入内存。更稳妥的做法是同时打开源文件与目标文件，然后循环从源文件读取一块内容，再将这一块内容写入目标文件。这样即使文件体积较大，程序也能保持相对稳定的内存占用。

<?php
$sourceFile = __DIR__ . '/big-source.txt';
$targetFile = __DIR__ . '/big-target.txt';

// 打开前先检查源文件是否可读
if (!file_exists($sourceFile) || !is_readable($sourceFile)) {
    echo '源文件不存在或不可读';
    exit;
}

// 检查目标目录是否可写
if (!is_writable(dirname($targetFile))) {
    echo '目标目录不可写';
    exit;
}

$readHandle = fopen($sourceFile, 'r');
$writeHandle = fopen($targetFile, 'w');

if ($readHandle && $writeHandle) {
    // 按块读取并写入，适合较大的文件
    while (!feof($readHandle)) {
        $chunk = fread($readHandle, 8192);

        if ($chunk === false) {
            break;
        }

        fwrite($writeHandle, $chunk);
    }

    fclose($readHandle);
    fclose($writeHandle);
    echo '大文件分块写入完成';
} else {
    if ($readHandle) {
        fclose($readHandle);
    }

    if ($writeHandle) {
        fclose($writeHandle);
    }

    echo '文件句柄打开失败';
}
?>

四、编码、权限与并发：容易被忽略但非常关键的细节

文件读写看起来简单，但在生产环境中经常遇到权限、编码和并发问题。写入返回false时，通常需要先检查目标目录是否存在、是否具备写入权限。Linux环境下尤其要注意文件所属用户、用户组以及目录权限。如果Web服务进程没有写入权限，即使PHP代码本身没有问题，写入也会失败。

中文内容是另一个常见问题。如果读取或写入后出现乱码，通常说明源文件编码与页面输出编码不一致。可以在读取后使用mb_convert_encoding或iconv进行编码转换，再决定输出或写入。对于需要长期维护的项目，建议尽量统一使用UTF-8编码，减少后续转换成本。

当多个进程或多个请求可能同时写入同一个文件时，还要考虑文件锁。PHP可以使用flock对文件加锁。写入前获取独占锁，写入完成后释放锁，可以减少内容交叉写入导致的数据错乱问题。这在日志写入、计数统计、任务状态记录等场景中尤为重要。

<?php
$lockFile = __DIR__ . '/locked.txt';
$handle = fopen($lockFile, 'w');

if ($handle) {
    // 获取独占锁，避免其他进程同时写入
    if (flock($handle, LOCK_EX)) {
        fwrite($handle, '在独占锁保护下写入的内容');

        // 释放锁并关闭文件
        flock($handle, LOCK_UN);
        fclose($handle);
        echo '加锁写入成功';
    } else {
        fclose($handle);
        echo '获取文件锁失败';
    }
} else {
    echo '文件打开失败';
}
?>

除了权限、编码和锁之外，文件路径也建议尽量规范化。使用__DIR__、realpath或配置中心统一管理路径，可以避免不同环境下相对路径不一致带来的问题。如果写入后的文件会立即被其他程序读取，还需要关注操作系统缓存、PHP缓存或业务缓存可能造成的延迟。

五、总结与延伸建议

整体来看，PHP实现“获取文件内容并写入到另一个文件”的思路非常清晰：先确认源文件可读，再选择合适方式读取内容；然后确认目标位置可写，再选择覆盖、追加或句柄写入方式完成写入。小型文件适合使用file_get_contents与file_put_contents快速完成；大型文件则更适合使用fopen、fread与fwrite分块处理。

在实际项目中，建议始终把健壮性放在重要位置。读取前检查文件是否存在与可读，写入前检查目录是否可写，涉及中文时关注编码统一，涉及多进程写入时使用文件锁。把这些细节处理好，文件读写功能才能在复杂业务环境中保持稳定、可靠且易于维护。

PHP文件读取文件写入file_get_contentsfile_put_contents修改时间：2026-08-15 14:19:43