PHP 安装与版本切换教程(Mac + Windows)

2026-04-27开发环境5 分钟177 次阅读
AI 摘要salmon-ai

本文详细解析了在 macOS 和 Windows 上安装 PHP 以及切换多版本的实用方案,重点围

前言

最近准备做一个基于 PHP 的 Web 项目,顺手把自己在 macOS 和 Windows 上安装 PHP、管理多版本、切换版本的过程整理成一篇教程。
这篇文章适合下面几类同学:

  • 刚接触 PHP,不知道怎么安装
  • 电脑里已经有 PHP,但版本不合适
  • 想同时维护多个 PHP 版本
  • 想像 pyenv、jenv、nvm 一样管理 PHP 版本

本文会分成两条路线:

  • 直接安装:适合只想尽快把 PHP 跑起来
  • 多版本管理:适合后面可能切换 PHP 版本的人

本项目后端准备使用 Laravel 11,因此推荐使用 PHP 8.2。

一、先说结论

如果你只是想尽快上手:

  • macOS:推荐 Homebrew + php@8.2
  • Windows:推荐 Laragon

如果你希望像 pyenv 一样管理多个版本:

  • macOS:推荐 asdf
  • 只想专门管理 PHP:可以用 phpbrew
  • Windows:如果主要用于本地开发,推荐 Laragon 自带的 PHP 版本切换

二、为什么推荐 PHP 8.2

当前项目准备使用 Laravel 11。
根据 Laravel 官方文档,Laravel 11 最低要求是 PHP 8.2。

选择 PHP 8.2 的原因:

  • 兼容 Laravel 11
  • 在 macOS 和 Windows 上都比较稳定
  • 生态成熟,资料多
  • 相比追新版本,部署更稳

所以如果你是第一次搭环境,直接上 PHP 8.2 就行。

三、macOS 安装 PHP

1. 先安装 Homebrew

如果你还没有安装 Homebrew,可以先执行:

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

安装完成后检查:

bash 复制代码
brew --version

如果能看到版本号,说明 Homebrew 已经可用。

2. 直接安装 PHP 8.2

执行:

bash 复制代码
brew install php@8.2

安装完成后查看版本:

bash 复制代码
php -v

如果当前终端还没有切到 8.2,可以执行:

bash 复制代码
brew unlink php
brew link php@8.2 --force --overwrite

然后再检查:

bash 复制代码
php -v

3. 安装 Composer

PHP 项目尤其是 Laravel,基本都会用到 Composer。

安装命令:

bash 复制代码
brew install composer

检查是否安装成功:

bash 复制代码
composer -V

四、macOS 下的 PHP 多版本管理

如果你后面会接触不同项目,比如:

  • 旧项目要 PHP 7.4
  • 新项目要 PHP 8.2
  • 某些框架想试试 PHP 8.3 或 8.4

那就不建议只装一个固定版本,而是直接上版本管理工具。

方案 A:使用 asdf 管理 PHP

这是我更推荐的一种方案,因为它的思路和 pyenv、jenv 很像,而且不止能管 PHP,还能管 Node.js、Java、Python。

1. 安装 asdf

bash 复制代码
brew install asdf

如果你使用的是 zsh,可以把下面这行加入 ~/.zshrc:

bash 复制代码
echo '\n. "$(brew --prefix asdf)/libexec/asdf.sh"' >> ~/.zshrc
source ~/.zshrc

检查版本:

bash 复制代码
asdf --version

2. 添加 PHP 插件

bash 复制代码
asdf plugin add php https://github.com/asdf-community/asdf-php.git

3. 安装 PHP 8.2

先查看可安装版本:

bash 复制代码
asdf list all php

安装某个 8.2 版本,例如:

bash 复制代码
asdf install php 8.2.28

4. 设置全局版本

bash 复制代码
asdf global php 8.2.28

5. 给当前项目单独设置版本

如果只想某个项目使用指定版本,可以进入项目目录执行:

bash 复制代码
asdf local php 8.2.28

这会生成一个 .tool-versions 文件。
以后你进入这个目录时,就会自动使用这个版本。

6. 查看当前版本

bash 复制代码
php -v
asdf current

7. 切换版本

假设你还安装了另一个版本:

bash 复制代码
asdf install php 8.3.18

切换全局版本:

bash 复制代码
asdf global php 8.3.18

切换项目版本:

bash 复制代码
asdf local php 8.2.28

方案 B:使用 phpbrew 管理 PHP

如果你只想管 PHP,不需要统一管理别的语言,也可以考虑 phpbrew。

1. 安装 phpbrew

可以先通过 Homebrew 安装:

bash 复制代码
brew install phpbrew

初始化:

bash 复制代码
phpbrew init

把环境变量加入 ~/.zshrc:

bash 复制代码
echo '[[ -e ~/.phpbrew/bashrc ]] && source ~/.phpbrew/bashrc' >> ~/.zshrc
source ~/.zshrc

2. 查看可安装版本

bash 复制代码
phpbrew known

3. 安装 PHP

例如安装 8.2:

bash 复制代码
phpbrew install 8.2 +default

4. 切换版本

bash 复制代码
phpbrew switch 8.2

查看当前版本:

bash 复制代码
php -v
phpbrew list

5. phpbrew 适合谁

适合:

  • 只想管理 PHP
  • 愿意稍微折腾一下编译和扩展

不太适合:

  • 想快速上手
  • 不想碰太多构建细节

所以对大多数同学来说,我还是更推荐 asdf。

五、macOS 下通过 Homebrew 切换 PHP 版本

如果你不是用 asdf 或 phpbrew,而是直接通过 Homebrew 装了多个版本,也可以手动切换。

例如你装了:

  • php@8.2
  • php@8.3

切换到 8.2:

bash 复制代码
brew unlink php
brew unlink php@8.3
brew link php@8.2 --force --overwrite

切换到 8.3:

bash 复制代码
brew unlink php
brew unlink php@8.2
brew link php@8.3 --force --overwrite

查看当前版本:

bash 复制代码
php -v
which php

这种方式能用,但不如 asdf 顺手。

六、Windows 安装 PHP

Windows 上我更推荐的不是单独硬装 PHP,而是直接使用集成环境。

方案 A:Laragon

这是我最推荐的方式。

优点:

  • 安装简单
  • 自带 PHP、Nginx/Apache、MySQL
  • 支持切换 PHP 版本
  • 很适合本地开发和学生项目

使用方式:

  1. 安装 Laragon
  2. 启动后检查 PHP 版本
  3. 把项目放到网站目录中
  4. 通过内置环境直接运行

如果 Laragon 已经自带一个 PHP 版本,但你想换成 8.2,可以下载对应版本后放入 Laragon 的 bin/php/ 目录,再在 Laragon 中切换。

方案 B:直接下载 PHP

如果你不想装集成环境,也可以去 PHP 官网下载 Windows 版本。

大致步骤:

  1. 下载 PHP 8.2 的 Thread Safe 或 Non Thread Safe 版本
  2. 解压到本地目录,例如 D:\php\php-8.2
  3. 配置系统环境变量 Path
  4. 在命令行执行 php -v

不过这种方式相对麻烦一些,尤其是后续还要搭配 Nginx、Apache、Composer,所以不如 Laragon 省心。

七、Windows 下怎么切换 PHP 版本

在 Laragon 中切换

如果你使用 Laragon,多版本切换通常最方便。

做法一般是:

  1. 准备多个 PHP 版本目录
  2. 放到 Laragon 的 PHP 目录下
  3. 在菜单中选择对应版本
  4. 重启服务

然后执行:

bash 复制代码
php -v

确认版本是否切换成功。

手动切换环境变量

如果你是直接安装多个 PHP 目录,也可以通过调整系统 Path 来切换。

比如:

  • D:\php\php-8.2
  • D:\php\php-8.3

把当前想用的版本目录放到环境变量前面,再重新打开终端即可。

这种方式能用,但长期来看不如 Laragon 管理方便。

八、安装完成后还要装什么

如果你要做 Laravel 项目,除了 PHP,还建议准备:

  • Composer
  • MySQL
  • Redis
  • Node.js

如果 MySQL、Redis 已经跑在 Docker 中,那就更省事了,只需要让项目连过去即可。

九、我自己的推荐方案

macOS 推荐

如果你只是想尽快上手:

  • brew install php@8.2
  • brew install composer

如果你后面会长期开发:

  • asdf 管理 PHP、Node.js 等版本

Windows 推荐

  • 本地开发优先用 Laragon
  • 项目 PHP 版本统一用 8.2

十、常见问题

1. 我电脑里已经有 PHP 8.4 了,还要装 8.2 吗

如果你的项目明确要对齐 Laravel 11 + PHP 8.2,建议还是装一个 8.2。
这样本地环境和部署环境更统一,后续排查问题更轻松。

2. 直接装一个版本够不够

够。
如果你只是做一个项目,直接用 php@8.2 就行。

3. 什么情况下需要 asdf

当你:

  • 会做多个项目
  • 经常切换 PHP 版本
  • 还要管理 Node、Java、Python

那 asdf 会非常舒服。

4. 什么情况下用 phpbrew

当你只想深度管理 PHP,自定义更多 PHP 构建细节时,可以考虑 phpbrew。

十一、参考资料

十二、结语

如果你刚开始学 PHP,不用一上来把环境想得太复杂。
最简单的路线就是:

  1. 安装 PHP 8.2
  2. 安装 Composer
  3. 准备好 MySQL 和 Redis
  4. 开始跑 Laravel 项目

等后面你项目多了,再上 asdf 统一管理版本,会更舒服一些。

觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句