Mac终端源码安装PHP环境四步骤详解-php教程-PHP中文网

mac终端源码安装php非推荐路径，仅适用于需自定义configure选项、调试内核或完全控制安装路径等特殊场景；日常开发应优先使用homebrew安装，其更稳定、快速且易于维护。

mac终端源码安装php环境四步骤详解

Mac终端源码安装PHP不是推荐路径，除非你明确需要自定义扩展、调试底层或复现特定构建环境——否则 Homebrew 安装更稳、更快、更易维护。

确认是否真需源码编译

系统自带PHP早已移除（macOS Catalina 起），Homebrew 安装的 php 默认已启用常用扩展（mbstring、curl、zlib、opcache），且支持 pecl 动态安装扩展。源码编译仅在以下情况必要：

你需要禁用/启用非常规 configure 选项（如 --without-sqlite3 或自定义 --with-libdir）
要调试 PHP 内核或 Zend Engine 行为
项目强制要求与某旧版 glibc 兼容（Mac 不适用，但常被误判）
你想完全控制安装路径（如部署到 /opt/myphp 而非 Homebrew 的 /opt/homebrew）

若只是想换版本、加扩展、调 php.ini，brew install php@8.3 + brew link php@8.3 就够了。

下载与解压源码包

从 php.net/downloads 下载 tar.gz 源码（如 php-8.3.12.tar.gz），别用 GitHub zip，它不含 configure 脚本：

解压后进入目录：tar -xzf php-8.3.12.tar.gz && cd php-8.3.12
运行 ./buildconf 生成 configure 脚本（首次必须，后续修改 configure.in 后也要再跑）
检查依赖：Mac 缺少 autoconf、openssl、sqlite3 会导致 configure 失败，先用 Homebrew 装好：brew install autoconf openssl@3 sqlite3 pkg-config

注意：./configure 不会自动检测 Homebrew 安装的 OpenSSL 路径，必须显式指定：--with-openssl=/opt/homebrew/opt/openssl@3（Apple Silicon）或 --with-openssl=/usr/local/opt/openssl@3（Intel）。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

configure 参数必须显式声明依赖路径

Mac 上几乎每个外部依赖都要手动指定路径，否则 configure 会跳过或报错。常见关键参数示例：

--prefix=/opt/php-8.3.12：安装目标根目录（务必设，否则默认 /usr/local，易与 Homebrew 冲突）
--with-openssl=/opt/homebrew/opt/openssl@3：OpenSSL 路径（不写则 HTTPS 请求失败）
--with-curl=/opt/homebrew/opt/curl：curl 支持（否则 file_get_contents("https://...") 报错）
--with-sqlite3=/opt/homebrew/opt/sqlite3：SQLite 支持（PDO SQLite 依赖）
--enable-mbstring --enable-zip --enable-opcache：启用基础扩展（不加则 mb_strlen() 等函数不存在）

执行完 ./configure ... 后，务必看终端末尾输出 —— 若出现 checking for openssl... not found 或 WARNING: No OpenSSL support，说明路径错了，别急着 make。

编译安装后 PATH 和 php.ini 需手动处理

make && sudo make install 完成后，PHP 可执行文件在 /opt/php-8.3.12/bin/php，但终端还找不到它：

把路径加进 shell 配置：echo 'export PATH="/opt/php-8.3.12/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
验证：which php 应输出 /opt/php-8.3.12/bin/php，php -v 显示版本，php --ini 查看配置路径
php.ini 不会自动生成，需手动复制模板：cp /opt/php-8.3.12/lib/php.ini-development /opt/php-8.3.12/lib/php.ini
编辑该 php.ini 文件时注意：extension_dir 默认是相对路径，要改成绝对路径，如 extension_dir = "/opt/php-8.3.12/lib/php/extensions/no-debug-non-zts-20230831/"