如何使用Composer命令在安装依赖时自动创建必要的日志文件夹

Composer 安装或更新依赖时，日志目录如果不存在，写入就会失败——严重时直接报错，更隐蔽的是静默丢弃日志，排查起来极其被动。解决方法其实不复杂：利用 Composer 的 post-install-cmd / post-update-cmd 事件自动创建目录。考虑到跨平台兼容性、权限控制和环境变量支持，推荐优先采用 PHP 脚本方式，而非直接写 shell 命令。

Composer 安装时日志目录不存在会怎样

说实话，不少开发者第一次遇到这个问题时都是一脸懵：项目配置里明明写了日志路径，composer install 跑完也一切正常，可就是找不到日志文件夹。默认情况下，Composer 不会帮你自动创建这些路径——无论你是在 phpunit.xml、monolog 配置还是自定义脚本里指定了 logs/ 之类目录。结果呢？一旦写入失败，就可能直接抛 mkdir(): No such file or directory 报错；更糟糕的是，应用可能默默忽略日志写入，等出问题后才傻眼。

用 Composer 的 post-install-cmd 和 post-update-cmd 自动建目录

最稳妥的做法，是把目录创建这件事交给 Composer 的脚本事件。依赖装完后立刻执行，比靠应用首次请求时再检查要可靠得多，也避免了延迟和权限方面的坑。

• 在 composer.json 的 "scripts" 段落里加上：

"scripts": {
  "post-install-cmd": [
    "mkdir -p var/logs",
    "mkdir -p var/cache"
  ],
  "post-update-cmd": [
    "mkdir -p var/logs",
    "mkdir -p var/cache"
  ]
}

注意：mkdir -p 是灵魂所在——它能递归创建父目录，且目录已存在时也不会报错。不过 Windows 用户得换个玩法，比如用 PowerShell -Command "if (!(Test-Path 'var\logs')) { New-Item -ItemType Directory -Path 'var\logs' }"。但说真的，绕来绕去容易出平台兼容问题，后面会讲到更统一的方案。

PHP 脚本方式更可控（尤其多环境或复杂路径）

一旦路径依赖环境变量（比如 $_ENV['LOG_DIR']），或者需要对目录设置权限（0755、chown 等），纯 shell 命令就有点力不从心了。这时候写一个简单的 PHP 脚本会稳得多：

• 新建 bin/mkdirs.php：

在 composer.json 中调用：

"post-install-cmd": [
  "php bin/mkdirs.php"
]
这样一来，umask 设置、错误提示、跳过已存在目录都能精确控制，后续加 chown 或 SELinux 上下文处理也顺手多了。
别漏掉 vendor/autoload.php 加载前的日志需求
有些项目在 autoload.php 加载阶段就要写日志——比如 autoloader 本身的错误捕获。这时候 post-install-cmd 已经来不及了。必须确保在 composer install --no-autoloader 之后手动补建目录，或者把创建逻辑提前到 pre-install-cmd。不过要特别小心：此时 vendor/ 可能还没解包，路径相对位置要算准，建议只建项目根目录下的固定路径（如 logs/），别依赖 vendor/ 内部结构。
真正让人头疼的是 CI/CD 环境里多次并发运行 composer install。mkdir -p 虽然是幂等的，但如果多个进程同时判断加创建同一级目录，依然可能因为竞态问题导致权限混乱。这种情况就别指望 Composer 脚本了，最好由部署脚本前置统一处理，或者加个锁文件来避免冲突。