如何在Laravel中实现类似Django print、console.log效果并写入laravel.log

基础日志打印方法 #

Laravel 内置日志功能，无需手动操作文件写入，以下两种方式都可以实现类似console.log、print的调试效果：

• 方式1：使用Log门面
  先在文件顶部引入门面：

  use Illuminate\Support\Facades\Log;
  

  之后就可以在需要打印日志的位置调用对应方法：

  // 打印普通文本
  Log::info('你要输出的调试内容');
  // 支持打印数组/对象等结构化数据
  Log::info('用户请求参数', $request->all());
  // 其他日志级别按需调用
  Log::debug('细粒度调试信息');
  Log::error('错误信息');
  

• 方式2：使用全局辅助函数（更便捷，无需引入门面）
  直接调用即可：

  info('你要输出的调试内容');
  

  效果和Log::info完全一致。

无法写入laravel.log的排查步骤 #

1. 优先排查目录/文件权限（VM环境下90%的写入失败都是权限问题） #

Laravel 要求storage目录和bootstrap/cache目录有 web 服务运行用户的读写权限，到项目根目录执行以下命令修改权限：

# 赋予目录读写权限
chmod -R 775 storage bootstrap/cache
# 将目录所有者修改为web服务运行用户，默认web用户通常为www-data，可根据你的实际运行用户替换
chown -R www-data:www-data storage bootstrap/cache

注意：不要使用root用户执行php artisan相关命令，否则生成的日志文件所有者为root，会导致web服务后续无法写入该文件。

2. 检查.env日志配置 #

打开项目根目录的.env文件，确认日志相关配置正确：

LOG_CHANNEL=stack
LOG_LEVEL=debug

• LOG_CHANNEL设为stack是默认将日志写入laravel.log的配置，不要修改为syslog、slack等其他驱动
• LOG_LEVEL设为debug才能写入所有级别的日志，若设置为info及以上级别，debug级别的日志会被过滤不写入

3. 检查日志配置文件 #

打开config/logging.php，确认默认stack通道配置正确：

'stack' => [
    'driver' => 'stack',
    'channels' => ['single'], // 这里的single对应单文件写入到laravel.log
    'ignore_exceptions' => false,
],
'single' => [
    'driver' => 'single',
    'path' => storage_path('logs/laravel.log'), // 确认路径和你找到的laravel.log路径一致
    'level' => env('LOG_LEVEL', 'debug'),
],

4. 清除配置缓存 #

修改配置后需要执行命令清除配置缓存才能生效：

php artisan config:clear

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