WhatsDive

# macOS 下利用 Homebrew 管理 PHP 版本全流程

# 1. 安装 Homebrew（如已装可跳过）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 确认当前无 PHP 环境

php -v || echo "PHP 未安装"

which php || echo "未找到 php 执行路径"

正常会输出 “PHP 未安装” 等信息。

# 3. 查询可用 PHP 版本

brew search php

软件包搜索结果演示

选择你想要安装的版本，这里作为演示，下载的是php@8.2 和 php@8.4。

# 4. 安装所需 PHP 版本

# 安装 PHP 8.2

brew install php@8.2

# 安装 PHP 8.4

brew install php@8.4

# 5. 激活/切换版本

# 首次激活 PHP 8.2

brew link php@8.2 --force --overwrite

php -v     # 应显示 PHP 8.2.x

which php   # 查看绑定路径，优先为 Homebrew 路径

# 切换到 PHP 8.4

brew unlink php@8.2

brew link php@8.4 --force --overwrite

php -v     # 应显示 PHP 8.4.x

# 切回 PHP 8.2

brew unlink php@8.4

brew link php@8.2 --force --overwrite

php -v

# 6. 常见问题与说明

  • brew unlink php 报错可忽略，直接 unlink/link 具体版本。

  • 未发现 php@8.4 时，建议用 php@8.2、php@8.3 演示切换流程。

  • 新终端或重启后确保 PATH 生效（或者执行 exec $SHELL）。

  • 用 which php 检查实际 PHP 执行路径是否为 /opt/homebrew/bin/php（M1/M2）或 /usr/local/bin/php（Intel）。

# 7. 流程总结

brew install php@8.2

brew install php@8.4    

brew link php@8.2 --force --overwrite

php -v

brew unlink php@8.2

brew link php@8.4 --force --overwrite

php -v

# 8. 写个hello world 的demo

# 创建文件

echo '<?php

echo "Hello, world!\n";

' > hello.php


# 运行脚本

php hello.php

hello world 输出效果

# 9. 参考