Laravel日志文件名无法动态拼接，因通道启动时已初始化；应使用Log::build()配合StreamHandler或RotatingFileHandler手动创建带用户ID、日期等实时上下文的定制日志实例，并注意目录创建、文件句柄泄漏及高并发性能问题。
日志文件名无法直接用 date() 或 $user->id 动态拼接
Laravel 的日志通道（如 daily、single）在启动时就初始化了 StreamHandler，文件名是静态配置的，不支持运行时插值。你不能在 config/logging.php 里写 'filename' => storage_path("logs/app_".date('Y-m-d')."_{$user->id}.log") —— 这会报错或始终用启动时的时间/空用户 ID。
用 createSingleDriver + 闭包动态生成日志实例
绕过配置层，在代码中手动创建带定制文件名的 Monolog\Handler\StreamHandler，再注入到日志实例里。适用于需要按用户、请求 ID、任务批次等实时上下文隔离日志的场景。
- 必须在请求生命周期内调用（如中间件、控制器），不能放在配置文件里
- 注意避免重复创建 handler 导致文件句柄泄漏，建议用
Log::build()一次性构造 - 文件路径需确保目录存在，否则写入失败且无提示
use Illuminate\Support\Facades\Log;
use Monolog\Handler\StreamHandler;
use Monolog\Logger;
// 按当前用户 ID 和日期生成日志
$user = auth()->user();
$filename = storage_path("logs/user_{$user->id}_".date('Y-m-d').'.log');
if (!is_dir(dirname($filename))) {
mkdir(dirname($filename), 0755, true);
}
$logger = Log::build([
'driver' => 'monolog',
'handler' => StreamHandler::class,
'with' => ['stream' => $filename],
]);
$logger->info('This goes to user-specific log', ['user_id' => $user->id]);
改用 RotatingFileHandler 实现按日期轮转 + 自定义前缀
如果目标是「每天一个文件」但想加前缀（如 api_2024-06-15.log 或 admin_2024-06-15.log），原生 daily 驱动不支持前缀。得换用 Monolog 原生的 RotatingFileHandler，并传入自定义 $filenameFormat。
-
RotatingFileHandler默认格式是{filename}_{date}.{extension}，但你可以重写getFilename方法或直接传格式字符串 - Laravel 9+ 支持在
with数组中传'filename_format' => 'api_{date}.log' - 注意：该 handler 不会自动创建子目录，
storage/logs/api/要提前建好或手动mkdir
Log::build([
'driver' => 'monolog',
'handler' => \Monolog\Handler\RotatingFileHandler::class,
'with' => [
'filename' => storage_path('logs/api/app.log'),
'filename_format' => 'api_{date}.log',
'max_files' => 30,
],
]);
多级目录 + 用户 ID 日志路径要小心权限和性能
有人会想把日志按用户存成 storage/logs/users/123/2024-06-15.log，这在高并发下容易触发大量目录创建和磁盘 I/O。Linux 对单目录下超万级子目录响应明显变慢，且 storage 目录通常不属于 web 用户，mkdir 可能失败。
- 优先用哈希分片：例如
users/12/3/（取 ID 前两位 + 后一位）代替users/123/ - 所有目录创建必须用
mkdir(..., 0755, true)并捕获 warning（Laravel 默认屏蔽了 mkdir warning） - 别在每次请求都
file_put_contents写新文件——Monolog 的 handler 是有缓冲和锁机制的，自己裸写容易丢日志或损坏文件
