通过Nix flake安装后Composer读取PHP版本错误问题排查

问题根源 #

你的Nix配置里Composer未与指定的PHP8.1实例绑定，导致它读取到了系统全局的PHP8.0版本。以下是完整的修正配置和验证步骤：

完整Flake配置示例 #

{
  description = "WordPress Xero API Plugin Development Environment";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs = { self, nixpkgs, flake-utils }:
    flake-utils.lib.eachDefaultSystem (system:
      let
        pkgs = import nixpkgs { inherit system; };
        # 指定使用PHP 8.1
        php = pkgs.php81;
        # 加载WordPress和Xero API所需的PHP扩展（按需调整）
        phpWithExtensions = php.withExtensions (e: with e; [
          curl
          gd
          mbstring
          mysql
          xml
          zip
        ]);
        # 强制Composer使用我们定义的PHP 8.1实例
        composer = pkgs.composer.override {
          php = phpWithExtensions;
        };
      in
      {
        devShells.default = pkgs.mkShell {
          buildInputs = [
            phpWithExtensions
            composer
            # 可添加wp-cli等其他开发工具
          ];

          # 确保环境优先使用Nix提供的PHP，排除全局版本干扰
          shellHook = ''
            export PATH="${phpWithExtensions}/bin:$PATH"
            export PHP_INI_SCAN_DIR="${phpWithExtensions}/etc/php"
          '';
        };
      }
    );
}

关键配置说明 #

• 绑定Composer与PHP版本：通过composer.override让Composer明确使用我们配置的PHP8.1，这是解决版本不匹配的核心。
• 扩展按需加载：php.withExtensions添加WordPress和Xero API依赖的扩展，避免后续运行时出现扩展缺失问题。
• 环境变量强制覆盖：shellHook里的PATH设置确保shell优先调用Nix提供的PHP，防止系统全局PHP版本干扰检测。

验证与修复步骤 #

1. 清理Composer缓存（清除旧的版本检测记录）：

   composer clear-cache
   

2. 进入Nix开发Shell：

   nix develop
   

3. 验证版本一致性：

   php -v # 确认输出为PHP 8.1.17
   composer -V # 查看Composer版本，此时它会使用绑定的PHP8.1
   

4. 重新安装依赖：

   composer install
   

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