现在位置: 首页 / 后端开发 / 正文

用 phpbrew 管理 php 环境：从安装到多版本切换

使用 phpbrew 管理 PHP 多版本环境：从安装到切换

在 macOS 开发环境中，同时维护多个 PHP 版本是一项常见的需求。使用 phpbrew 可以轻松实现这一点，并且提供了一套可靠的流程来管理不同版本的 PHP 安装和切换。

引言

PHP 的多版本管理对于开发者来说是一个挑战。不同的项目可能需要不同版本的 PHP，手动维护这些环境不仅耗时而且容易出错。phpbrew 是一个工具，它可以帮助你在 macOS 上轻松地安装、编译并切换多个 PHP 版本。本文将详细介绍如何使用 phpbrew 来管理你的开发环境。

一、安装 phpbrew

首先通过 Homebrew 安装 phpbrew：

brew install phpbrew

确认已成功安装，并检查版本信息：

phpbrew --version

如果需要配置多个 PHP 版本，建议在你的 shell 配置文件（如 .zshrc）中添加以下内容：

export PATH="/opt/homebrew/opt/php@8.4/bin:/opt/homebrew/opt/php@8.4/sbin:$PATH"
[[ -r "$HOME/.phpbrew/bashrc" ]] && source "$HOME/.phpbrew/bashrc"
source ~/.zshrc

二、初始化 phpbrew

安装 phpbrew 后，执行下列命令进行初始化：

phpbrew init

这会创建必要的配置文件并生成 .phpbrew/bashrc。将其添加到你的 shell 配置中：

[[ -r "$HOME/.phpbrew/bashrc" ]] && source "$HOME/.phpbrew/bashrc"

重新加载配置文件以确保 phpbrew 已正确初始化：

source ~/.zshrc

验证输出结果，确认命令已成功执行。

三、处理 PHP 8.4 下的 deprecation 噪声

在使用 PHP 8.4 版本时，可能会遇到大量废弃警告信息。为了减少这些噪音，你可以创建一个包装器来屏蔽这些警告：

mkdir -p ~/.local/bin
cat > ~/.local/bin/phpbrew-php <<'EOF'
#!/bin/sh
exec /opt/homebrew/opt/php@8.4/bin/php -d error_reporting='E_ALL & ~E_DEPRECATED & ~E_STRICT' "$@"
EOF
chmod +x ~/.local/bin/phpbrew-php

在 .zshrc 中设置 PHPBREW_SYSTEM_PHP 环境变量：

export PHPBREW_SYSTEM_PHP="$HOME/.local/bin/phpbrew-php"
source ~/.zshrc

这样就能让 phpbrew 在执行时更加安静且稳定。

四、安装编译依赖

由于 phpbrew 是通过源码编译来安装 PHP，所以需要确保所有必要的编译工具和库都已就绪：

brew install bison libiconv libxml2 re2c bzip2 zip

这些依赖通常包括 openssl@3, curl, sqlite, readline, libsodium 和 oniguruma。安装完成后，尝试编译 PHP 时就不会遇到缺少头文件或库文件的问题。

五、为 phpbrew 编译准备环境变量

在 Apple Silicon 的 Homebrew 环境中，某些依赖项可能不在标准路径上。我们需要设置一些环境变量来确保 phpbrew 可以找到所有必要的编译工具和库：

export PATH="/opt/homebrew/opt/bison/bin:/opt/homebrew/opt/libxml2/bin:/opt/homebrew/opt/bzip2/bin:/opt/homebrew/opt/zip/bin:$PATH"
export PKG_CONFIG_PATH="/opt/homebrew/opt/libxml2/lib/pkgconfig:/opt/homebrew/opt/openssl@3/lib/pkgconfig:/opt/homebrew/opt/sqlite/lib/pkgconfig:/opt/homebrew/opt/readline/lib/pkgconfig:/opt/homebrew/opt/libsodium/lib/pkgconfig:/opt/homebrew/opt/oniguruma/lib/pkgconfig:$PKG_CONFIG_PATH"
export CPPFLAGS="-I/opt/homebrew/opt/libiconv/include -I/opt/homebrew/opt/libxml2/include -I/opt/homebrew/opt/bzip2/include $CPPFLAGS"
export LDFLAGS="-L/opt/homebrew/opt/libiconv/lib -L/opt/homebrew/opt/libxml2/lib -L/opt/homebrew/opt/bzip2/lib $LDFLAGS"

这些环境变量确保 phpbrew 在编译 PHP 时可以找到所有必要的头文件和库。

六、使用 phpbrew 安装 PHP 版本

查看可用的 PHP 版本：

phpbrew list-known | head -n 12

安装不同版本的 PHP，例如安装 PHP 8.4.20 和 PHP 8.2.30：

phpbrew install --stdout --jobs=4 8.4.20 +default
phpbrew install --stdout --jobs=4 8.2.30 +default

如果需要 FPM 版本，可以通过以下命令安装：

phpbrew install --stdout --jobs=4 8.2.30 +default +fpm

注意 --jobs 参数的使用方式，在某些情况下 -j4 可能会导致错误。

七、查看和切换已安装的 PHP 版本

确认所有已经安装的 PHP 版本：

phpbrew list

临时在当前终端会话中切换版本，例如切换到 PHP 8.4.20：

phpbrew use php-8.4.20

通过以上步骤和命令，你可以轻松地管理和使用不同版本的 PHP 在 macOS 开发环境中的多版本管理。

八、持久切换默认 PHP 版本

如果希望新打开的 shell 默认使用特定版本的 PHP，可以执行以下命令：

phpbrew switch php-8.4.20

或者选择另一个版本：

phpbrew switch php-8.2.30

这些操作会更新 ~/.phpbrew/bashrc 文件中的配置，使得新打开的 shell 自动加载指定的 PHP 版本。如果需要取消持久切换并恢复到系统默认的 PHP 环境：

phpbrew switch-off

这与临时切换命令 use 的区别在于：使用 switch 设置的版本会在所有新开的 shell 中生效，而通过 use 切换只影响当前活动的 shell 会话。

九、验证当前生效的 PHP 版本

在完成上述操作后，建议使用以下几种方法来确认系统中正在使用的 PHP 版本：

which php
php -v
type phpbrew
phpbrew list

这些命令分别展示了系统中指定 php 命令的实际路径，当前已安装的 PHP 版本及其详细信息，以及 phpbrew 工具本身的相关配置。为了进一步验证特定版本是否可正常运行：

~/.phpbrew/php/php-8.4.20/bin/php -v
~/.phpbrew/php/php-8.2.30/bin/php -v

这些命令直接调用指定路径下的 PHP 二进制文件，并输出其详细版本信息。这种方法比仅仅依赖 phpbrew list 更具可靠性，因为它确保了目标二进制程序能够实际执行。

十、常用命令总结

日常使用 phpbrew 进行安装、管理 PHP 版本时，以下是一些最常用的命令：

phpbrew --version # 输出 phpbrew 工具的版本信息
phpbrew init       # 初始化 phpbrew 环境配置文件
phpbrew list-known # 列出所有可安装的 PHP 版本及其扩展
phpbrew install --stdout --jobs=4 8.4.20 +default   # 安装 PHP 8.4.20 及默认扩展，使用多线程提高编译速度
phpbrew use php-8.4.20     # 在当前 shell 中切换到指定版本的 PHP
phpbrew switch php-8.4.20  # 设置持久使用的 PHP 版本
phpbrew off               # 切换回系统默认的 PHP 环境
phpbrew switch-off        # 取消持久使用设置，恢复为无特定环境配置

这些命令覆盖了安装、初始化、编译、切换和系统版本恢复的主要场景，并提供了灵活高效的开发工具支持。

十一、推荐的最佳实践方式

为了更好地管理 PHP 版本及其依赖关系，在项目中建议采取以下措施：

  1. 保留系统 PHP 作为基线环境：确保 Homebrew 安装的默认 PHP 版本可用于处理日常任务。
  2. 使用 phpbrew 编译和安装特定版本的 PHP：根据项目的需要，利用 phpbrew 创建并管理不同版本的 PHP 环境。
  3. 临时测试时使用 phpbrew use 命令：此命令仅影响当前 shell 会话中的 PHP 版本切换，适用于短期试验和调试需求。
  4. 设置持久使用的 PHP 版本通过 switch 指定：这确保了所有新开的终端窗口或 Tab 都使用指定版本的 PHP，默认情况下不会干扰其他项目的工作环境。
  5. 编译前固定依赖路径：配置好必要的编译参数，如 PKG_CONFIG_PATH, 来避免在构建过程中遇到缺少依赖的问题。

通过这种实践方式，可以清晰地区分系统 PHP 和项目 PHP 的管理边界，并且能够在多版本并存的情况下灵活切换和使用不同的开发环境。

十二、常见问题排查

解决 phpbrew 使用中的一些典型问题时，请参考以下建议：

  • 大量 Deprecated: 警告：这通常表明 phpbrew 在较新 PHP 版本（如 8.4）下的兼容性问题。可以通过检查环境变量 PHPBREW_SYSTEM_PHP 是否指向正确设置的包装器来解决。

  • 编译失败在 configure 阶段：可能是因为 Homebrew 安装的依赖不完整或者缺少必要的编译选项。需要确保以下环境变量已正确配置：

    echo $PATH
echo $PKG_CONFIG_PATH
echo $CPPFLAGS
echo $LDFLAGS

  • 并行构建错误：尝试减少或取消 -j4 参数，以避免多线程引起的冲突。可以使用 --jobs=1 来确保单线程编译的稳定性。

  • 切换后 PHP 指向系统版本的问题：若发现当前 shell 无法正确加载 phpbrew 的环境配置，则需要检查 .zshrc 文件中的相关设置是否生效，例如：

    source ~/.phpbrew/bashrc

通过合理地排除这些问题，可以确保 phpbrew 在 PHP 多版本管理过程中平稳运行。

结语

使用 phpbrew 的核心价值在于将 PHP 版本的编译、安装和切换过程标准化。这对于同时维护多种不同项目的需求尤为关键，能够显著减少因环境配置不当导致的问题，使开发流程更加高效且可预测。