Mac本地怎么安装PHP8.4？Homebrew环境配置-php教程-PHP中文网

Mac本地装PHP 8.4核心三点：M芯片必须用/opt/homebrew原生路径，安装php@8.4并启用mbstring/openssl/pdo等11个必需扩展，修复macOS 15 Sequoia下dyld库加载失败问题，需brew安装oniguruma/icu4c/openssl@3并配置DYLD_LIBRARY_PATH。

mac本地怎么安装php8.4？homebrew环境配置

Mac本地装PHP 8.4，核心就三点：用对Homebrew路径、装对PHP版本、配好动态库依赖。M系列芯片（M1/M2/M3/M4）必须走 /opt/homebrew 路径，不能套用Intel老教程；PHP 8.4.1起对系统库更敏感，尤其在macOS 15 Sequoia上容易因dyld加载失败而崩溃。

确认Homebrew安装路径与架构

先检查是否原生安装了arm64版Homebrew：

运行 which brew，正确输出应为 /opt/homebrew/bin/brew（Apple Silicon）或 /usr/local/bin/brew（Intel）
若显示 /usr/local/bin/brew 且你用的是M芯片，说明是Rosetta转译安装，建议卸载后重装原生版：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
验证架构：arch 应输出 arm64；brew config | grep "Chip" 应显示 Chip: Apple Mx

安装PHP 8.4并启用必需扩展

PHP 8.4要求最低为PHP ≥ 8.2，且必须启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json、bcmath、fileinfo、zip、curl 扩展——缺一不可，否则 Laravel artisan 或数据库迁移会直接报错。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

执行安装命令：brew install php@8.4
强制链接（避免被其他PHP版本覆盖）：brew link --overwrite --force php@8.4
把Homebrew的bin目录加入PATH（zsh用户编辑 ~/.zshrc）：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
验证：php -v 应显示 PHP 8.4.x；php -m | grep -E "(mbstring|pdo|openssl)" 应全部有输出

修复macOS 15常见dyld崩溃问题

PHP 8.4.1在Sequoia上启动时报“dyld: Library not loaded”很常见，主因是oniguruma、icu4c、openssl@3等依赖库路径未被识别。

先装齐依赖：brew install oniguruma icu4c openssl@3
创建软链（以oniguruma为例，路径按 brew --prefix oniguruma 输出调整）：
sudo ln -sf $(brew --prefix oniguruma)/lib/libonig.5.dylib /usr/local/lib/libonig.5.dylib
确保 /opt/homebrew/lib 在动态库搜索路径中：
echo 'export DYLD_LIBRARY_PATH="/opt/homebrew/lib:$DYLD_LIBRARY_PATH"' >> ~/.zshrc && source ~/.zshrc
临时测试是否生效：DYLD_LIBRARY_PATH="/opt/homebrew/lib" php -v；若成功，再执行永久配置