PHP安全写入文件（覆盖写入 storage/logs/app.log）
<?php
declare(strict_types=1);
/**
* 安全写入（覆盖写入）示例：将内容写入 storage/logs/app.log
* - 原子写入：先写入临时文件，再原子替换目标文件，避免部分写入
* - 权限控制：目录与文件权限设置（0750/0640）
* - 安全检查：固定路径、目录非符号链接、大小限制、内容清洗
* - 兼容：PHP 7.4+
*/
const RELATIVE_TARGET = 'storage/logs/app.log'; // 固定相对路径（不接收用户输入）
const MAX_BYTES = 1024 * 1024; // 单次写入最大1MB
const DIR_PERM = 0750;
const FILE_PERM = 0640;
/**
* 确保目录存在且可写，拒绝使用符号链接目录
*/
function ensureDirectory(string $dir, int $perm = DIR_PERM): void
{
if (is_dir($dir)) {
if (is_link($dir)) {
throw new RuntimeException("Refusing to use symlinked directory: $dir");
}
if (!is_writable($dir)) {
throw new RuntimeException("Directory is not writable: $dir");
}
return;
}
if (!mkdir($dir, $perm, true)) {
throw new RuntimeException("Failed to create directory: $dir");
}
@chmod($dir, $perm); // 受 umask 影响，尽力设置
}
/**
* 日志内容清洗：
* - 尝试转为 UTF-8
* - 统一换行符为 \n
* - 去除不可打印控制字符（保留 \t 和 \n）
* - 限制最大字节数
*/
function sanitizeLogContent(string $input): string
{
if (function_exists('mb_detect_encoding') && function_exists('mb_convert_encoding')) {
if (!mb_detect_encoding($input, 'UTF-8', true)) {
// 当来源编码未知时，'auto' 会尝试检测常见编码并转为 UTF-8
$input = mb_convert_encoding($input, 'UTF-8', 'auto');
}
}
// 统一换行
$input = str_replace(["\r\n", "\r"], "\n", $input);
// 去除不可打印控制字符（保留 \t 与 \n）
$filtered = @preg_replace('/[^\P{C}\t\n]/u', '', $input);
if ($filtered !== null) {
$input = $filtered;
}
if (strlen($input) > MAX_BYTES) {
throw new RuntimeException('Log content exceeds size limit of ' . MAX_BYTES . ' bytes.');
}
return $input;
}
/**
* 原子覆盖写入：
* - 在同目录下创建临时文件，写入完成后 rename 覆盖目标文件
* - 在部分平台上，如目标存在 rename 可能失败，则先尝试 unlink 再重试
*/
function safeOverwrite(string $targetPath, string $data, int $perm = FILE_PERM): void
{
$dir = dirname($targetPath);
ensureDirectory($dir);
$tmp = tempnam($dir, 'wrt_');
if ($tmp === false) {
throw new RuntimeException('Failed to create temporary file.');
}
$bytes = file_put_contents($tmp, $data, LOCK_EX);
if ($bytes === false || $bytes !== strlen($data)) {
@unlink($tmp);
throw new RuntimeException('Failed to write all data to temporary file.');
}
// 原子替换（同一文件系统内）
if (!@rename($tmp, $targetPath)) {
// 某些平台（尤其是旧版 Windows）如目标存在可能失败
if (file_exists($targetPath) && !@unlink($targetPath)) {
@unlink($tmp);
throw new RuntimeException('Failed to replace existing target file.');
}
if (!@rename($tmp, $targetPath)) {
@unlink($tmp);
throw new RuntimeException('Failed to move temporary file into place.');
}
}
// 设置最终文件权限（尽力而为）
@chmod($targetPath, $perm);
}
/**
* 计算目标文件的绝对路径（固定常量，不接受外部输入）
*/
function getTargetAbsolutePath(): string
{
$baseDir = realpath(__DIR__);
if ($baseDir === false) {
throw new RuntimeException('Failed to resolve script base directory.');
}
return $baseDir . DIRECTORY_SEPARATOR . str_replace(['/', '\\'], DIRECTORY_SEPARATOR, RELATIVE_TARGET);
}
/**
* 示例写入（覆盖写入）
* 注意：覆盖写入会清空已有内容，仅保留本次写入内容
*/
try {
// 示例日志内容（应由服务器端生成；若包含用户输入请先清洗/转义）
$logLine = sprintf(
"[%s] level=INFO message=%s\n",
date('c'),
'Application started'
);
$payload = sanitizeLogContent($logLine);
$target = getTargetAbsolutePath();
// 执行覆盖写入
safeOverwrite($target, $payload);
// 按需处理返回（CLI/HTTP）
echo "Wrote log to: " . $target . PHP_EOL;
} catch (Throwable $e) {
// 记录详细错误到 PHP 错误日志（不向客户端暴露具体路径/细节）
error_log('Log write error: ' . $e->getMessage());
// 客户端返回最小错误信息
if (PHP_SAPI !== 'cli') {
http_response_code(500);
}
echo "Failed to write log.";
}
使用说明
- 文件路径：相对于当前脚本目录，写入至 storage/logs/app.log。如果目录不存在，脚本会以 0750 权限创建。
- 覆盖写入：本示例为“write（覆盖）”操作，每次执行会用新的内容替换原文件全部内容。若您需要“追加写入”，请见下方备注。
- 快速开始：
- 将上述代码保存为任意 PHP 脚本（例如 scripts/write_log.php）。
- 确保 PHP 进程对项目目录拥有写权限（特别是 storage/logs）。
- 通过 CLI 或 Web 执行该脚本，成功后会在 storage/logs/app.log 中看到新内容。
- 自定义内容：将 $logLine 替换为您的业务日志字符串；若包含用户输入，请先清洗和长度限制。
附：如果您更适合“追加写入”日志（常规日志场景），可将 safeOverwrite 替换为使用 FILE_APPEND 的实现（请谨慎使用，这里仅提供参考，不在本次“write/覆盖”范围内）：
- 参考做法：file_put_contents($target, $payload, FILE_APPEND | LOCK_EX)
安全提示
- 禁止使用外部（用户）输入来构造文件路径；本示例使用固定常量，避免路径穿越。
- 若需要写入用户提供的文本，务必：
- 使用 sanitizeLogContent 进行清洗（编码统一、去除控制字符、长度限制）。
- 额外根据业务进行关键词或格式校验，防止日志注入（如伪造多行、插入控制序列）。
- 权限与所有者：
- 目录使用 0750，文件使用 0640，避免对“其他用户”开放读写。
- 确保运行 PHP 的用户对 storage/logs 拥有写权限。
- 符号链接安全：拒绝使用符号链接目录，避免被重定向到敏感路径。
- 原子写入：通过临时文件 + rename 避免并发写入产生的半成品文件；确保临时文件与目标文件在同一挂载点。
错误处理
可能的错误与解决建议：
- Failed to create directory / Directory is not writable
- 检查目录是否存在、是否为符号链接、PHP 进程是否有写权限；修正所有者与权限（chmod/chown）。
- Failed to create temporary file
- Failed to write all data to temporary file
- 磁盘不足或文件系统限制；检查磁盘空间与 ulimit。
- Failed to replace existing target file / Failed to move temporary file into place
- 可能目标在不同文件系统、Windows 上覆盖失败或被占用；确保目标目录与临时文件同一分区，或释放占用进程。
- Log content exceeds size limit
- 单次写入内容超过 MAX_BYTES，缩小内容或调大限制（注意内存与磁盘压力）。
- 编码或正则相关问题
- 若未安装 mbstring 扩展，代码会降级跳过编码转换；如需严格编码控制，请启用 mbstring。
