PHP 安装与版本切换教程(Mac + Windows)
本文详细解析了在 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.2php@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 版本
- 很适合本地开发和学生项目
使用方式:
- 安装 Laragon
- 启动后检查 PHP 版本
- 把项目放到网站目录中
- 通过内置环境直接运行
如果 Laragon 已经自带一个 PHP 版本,但你想换成 8.2,可以下载对应版本后放入 Laragon 的 bin/php/ 目录,再在 Laragon 中切换。
方案 B:直接下载 PHP
如果你不想装集成环境,也可以去 PHP 官网下载 Windows 版本。
大致步骤:
- 下载 PHP 8.2 的 Thread Safe 或 Non Thread Safe 版本
- 解压到本地目录,例如
D:\php\php-8.2 - 配置系统环境变量
Path - 在命令行执行
php -v
不过这种方式相对麻烦一些,尤其是后续还要搭配 Nginx、Apache、Composer,所以不如 Laragon 省心。
七、Windows 下怎么切换 PHP 版本
在 Laragon 中切换
如果你使用 Laragon,多版本切换通常最方便。
做法一般是:
- 准备多个 PHP 版本目录
- 放到 Laragon 的 PHP 目录下
- 在菜单中选择对应版本
- 重启服务
然后执行:
bash
php -v
确认版本是否切换成功。
手动切换环境变量
如果你是直接安装多个 PHP 目录,也可以通过调整系统 Path 来切换。
比如:
D:\php\php-8.2D:\php\php-8.3
把当前想用的版本目录放到环境变量前面,再重新打开终端即可。
这种方式能用,但长期来看不如 Laragon 管理方便。
八、安装完成后还要装什么
如果你要做 Laravel 项目,除了 PHP,还建议准备:
- Composer
- MySQL
- Redis
- Node.js
如果 MySQL、Redis 已经跑在 Docker 中,那就更省事了,只需要让项目连过去即可。
九、我自己的推荐方案
macOS 推荐
如果你只是想尽快上手:
brew install php@8.2brew 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。
十一、参考资料
- Laravel 11 安装文档:https://laravel.com/docs/11.x/installation
- Laravel 11 发布说明:https://laravel.com/docs/11.x/releases
- Homebrew PHP 公式:https://formulae.brew.sh/formula/php
- Homebrew PHP 8.2 公式:https://formulae.brew.sh/formula/php@8.2
- asdf 项目地址:https://github.com/asdf-vm/asdf
- asdf PHP 插件:https://github.com/asdf-community/asdf-php
- phpbrew 项目地址:https://github.com/phpbrew/phpbrew
十二、结语
如果你刚开始学 PHP,不用一上来把环境想得太复杂。
最简单的路线就是:
- 安装
PHP 8.2 - 安装
Composer - 准备好 MySQL 和 Redis
- 开始跑 Laravel 项目
等后面你项目多了,再上 asdf 统一管理版本,会更舒服一些。