PHP文件上传日志记录有五种方法：一、用file_put_contents追加文本日志；二、用error_log写入系统或自定义日志；三、存入MySQL结构化存储；四、集成Monolog实现多通道记录；五、通过trigger_error配合自定义错误处理记录异常。
如果在PHP应用中执行文件上传操作，但未记录相关行为，则可能难以追踪上传来源、时间、文件名及结果。以下是实现上传文件日志记录的具体方法：
一、使用file_put_contents追加写入文本日志
该方法通过PHP内置函数将上传事件信息以纯文本格式追加到指定日志文件中，无需数据库依赖，适合轻量级记录需求。
1、在文件上传处理逻辑（如move_uploaded_file之后）添加日志写入代码。
2、构造日志字符串，包含当前时间、客户端IP、上传表单名、原始文件名、保存路径、文件大小及上传状态。
立即学习“PHP免费学习笔记（深入）”；
3、调用file_put_contents函数，传入日志文件路径、日志字符串和FILE_APPEND | LOCK_EX标志。
4、确保日志目录存在且Web服务器用户具有写入权限，例如设置logs/目录权限为755或775。
二、基于error_log函数写入系统日志或自定义日志文件
利用PHP的error_log函数可将上传事件输出至系统日志（如syslog）或指定文件，便于与服务器级日志统一管理。
1、配置error_log参数为2（写入系统日志）或3（写入指定文件路径）。
2、组装结构化日志消息，例如："[UPLOAD][".date('Y-m-d H:i:s')."] IP:$_SERVER['REMOTE_ADDR'] File:$_FILES['file']['name'] Status:Success"。
3、调用error_log($message, $type, $destination)，其中$type为2或3，$destination为日志路径（当$type=3时必需）。
4、验证Web服务器（如Apache或Nginx）对目标日志路径具备写入能力，避免因权限问题导致日志丢失。
三、写入MySQL数据库表进行结构化存储
将每次上传事件作为一条记录存入数据库，支持按时间、用户、文件类型等字段高效查询与筛选。
1、创建upload_logs数据表，字段包括id（自增主键）、upload_time（datetime）、client_ip（varchar）、user_id（int，默认NULL）、file_name（varchar）、file_path（varchar）、file_size（bigint）、status（enum或tinyint）。
2、在上传成功或失败后，使用PDO或mysqli执行INSERT语句，绑定对应参数值。
3、对$_SERVER['REMOTE_ADDR']、$_FILES['file']['name']等外部输入进行trim()和htmlspecialchars()基础过滤，防止日志注入影响显示。
4、为upload_time字段添加B-TREE索引，提升按时间范围查询日志的响应速度。
四、集成Monolog日志库实现多通道记录
Monolog提供灵活的处理器（Handler）机制，可同时向文件、Syslog、邮件甚至远程服务（如Logstash）发送上传日志。
1、通过Composer安装monolog/monolog：composer require monolog/monolog。
2、实例化Logger对象，并添加StreamHandler（写入文件）、SyslogHandler（写入系统日志）等处理器。
3、定义日志上下文数组，包含'client_ip' => $_SERVER['REMOTE_ADDR']、'filename' => $_FILES['file']['name']、'size' => $_FILES['file']['size']等键值对。
4、调用logger->info('File uploaded', $context)，触发所有已注册处理器执行写入操作。
五、通过自定义错误处理配合trigger_error记录上传异常
针对上传过程中发生的错误（如UPLOAD_ERR_INI_SIZE、UPLOAD_ERR_NO_FILE），可捕获并转换为带上下文的日志条目。
1、在上传前设置set_error_handler回调函数，捕获E_USER_WARNING级别错误。
2、在move_uploaded_file失败后，根据$_FILES['file']['error']值映射为可读错误消息，并调用trigger_error()携带UPLOAD_LOG_CONTEXT常量标识。
3、在自定义错误处理器中判断error_type是否为E_USER_WARNING且error_message包含UPLOAD_LOG_CONTEXT，再提取$_FILES和$_SERVER信息拼接日志行。
4、将组合后的日志内容写入独立的upload_errors.log文件，避免与常规业务日志混杂。
