如何在Composer脚本中检查磁盘剩余空间？安装前的环境检测-composer-PHP中文网

composer脚本中需通过php函数或系统命令检查磁盘空间：优先用disk_free_space()校验稳定路径（如sys_get_temp_dir()或$home/.composer/cache），避免依赖getcwd()；若需详细信息，则用shell_exec()调用df（linux/macos）或wmic（windows），并严格解析输出，注意ci环境多挂载点和exec禁用情况。

如何在composer脚本中检查磁盘剩余空间？安装前的环境检测

Composer脚本里怎么调用磁盘空间检查？

Composer 本身不提供内置的磁盘空间检测能力，必须通过 exec() 或 shell_exec() 调用系统命令。PHP 的 disk_free_space() 函数虽可用，但只支持路径级查询，而 Composer 脚本运行时工作目录不稳定（可能是项目根、vendor 目录甚至临时路径），直接传 getcwd() 容易误判。

推荐统一检查 Composer 缓存目录所在磁盘（通常是用户主目录下的 ~/.composer/cache）或项目根目录所在磁盘——后者更贴近实际安装目标位置。

Linux/macOS 下用 df -B1 /path 获取字节数，再用 PHP 解析；Windows 下用 dir C: /-C 或 wmic logicaldisk get size,freespace,caption
避免用 system()，它会直接输出到终端，干扰 Composer 输出流；优先用 shell_exec() 并静默处理
记得用 trim() 和 intval() 清洗命令结果，防止空格或换行导致解析失败

在 composer.json 的 scripts 里怎么写？

不能直接写 shell 命令（Composer 不执行 shell 解析），必须封装成 PHP callable。常见错误是把 df 命令直接塞进 "scripts" 字段，结果报错 Script df -B1 . handling the pre-install-cmd event returned with error code 127。

正确做法：定义一个自定义函数（如 checkDiskSpace），在 autoload-dev 中加载，然后在 scripts 中引用：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

{
  "scripts": {
    "pre-install-cmd": [
      "My\Installer::checkDiskSpace"
    ]
  },
  "autoload-dev": {
    "psr-4": {
      "My\": "scripts/"
    }
  }
}

对应 scripts/Installer.php 内容示例：

<?php namespace My;
class Installer
{
    public static function checkDiskSpace($event)
    {
        $path = getcwd(); // 或硬编码为 sys_get_temp_dir()、$_SERVER['HOME'] . '/.composer/cache'
        $free = disk_free_space($path);
        if ($free < 500 * 1024 * 1024) { // 少于 500MB
            throw new Exception("Insufficient disk space: " . round($free / 1024 / 1024, 1) . " MB free");
        }
    }
}

为什么 `disk_free_space()` 有时返回 false？

不是权限问题就是路径不存在。Composer 脚本可能在 vendor 安装中途触发（比如 post-autoload-dump），此时 getcwd() 可能指向 vendor/composer/... 这类临时路径，而该路径在某些 CI 环境下尚未创建或不可读。

始终 fallback 到已知稳定路径：如 $_SERVER['HOME']（Linux/macOS）、$_SERVER['USERPROFILE']（Windows）、或 sys_get_temp_dir()
加一层存在性判断：is_dir($path) && is_readable($path)，否则跳过检查或报明确错误
注意 Windows 下盘符大小写无关，但 disk_free_space("c:\") 和 disk_free_space("C:\") 在某些 PHP 版本中行为不一致，建议统一转小写

CI 环境下磁盘检查特别容易失效

GitHub Actions、GitLab CI 默认分配的磁盘极小（常仅 14GB），且缓存目录和工作目录可能跨不同挂载点。单纯查 getcwd() 所在分区，可能漏掉 Composer 实际写入的 ~/.composer/cache 所在分区。

CI 中应显式检查两个位置：disk_free_space(sys_get_temp_dir()) 和 disk_free_space(getenv('HOME') . '/.composer/cache')
某些 CI 镜像禁用 exec()（如部分 Alpine 容器），此时 disk_free_space() 是唯一可靠方式，但需确保路径存在
别依赖 df 输出格式——不同 Linux 发行版的列顺序可能不同（如 Ubuntu 的 df -B1 第二列是 total，CentOS 可能是 used），解析时务必按 header 行匹配，而非固定索引

真正麻烦的是多挂载点场景：项目在 /mnt/ssd，但 Composer 缓存却配置在 /home（NFS 挂载），两者剩余空间差异极大。这种情况下，只检查一处等于没检查。