HoRain云--超全PHP安装指南：Linux/Windows/macOS全攻略-编程阁

🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

⛳️ 推荐

一、主流操作系统安装方法

1. Linux 系统（推荐包管理器安装）

## 1. 基于发行版的快速安装

## 2. 源码编译安装（高级场景）

2. Windows 系统（推荐集成环境）

PHP 安装的核心原则是：根据不同操作系统选择官方推荐方式，Linux 优先使用包管理器安装，Windows 推荐集成环境，macOS 需注意系统版本差异，且必须配置 PHP-FPM 或 Web 服务器模块以支持动态解析。安装后务必通过phpinfo()验证环境是否生效，关键配置包括extension_dir路径正确性和必要扩展（如mysqli、mbstring）的启用状态。

一、主流操作系统安装方法

1.Linux 系统（推荐包管理器安装）

## 1. 基于发行版的快速安装

Debian/Ubuntu 系列：
```
sudo apt update sudo apt install -y php php-fpm php-mysql php-gd php-curl php-mbstring
```
安装后PHP-FPM 服务默认自动启动，需确保php-fpm进程运行中。

RHEL/CentOS 系列：

sudo dnf install -y epel-release sudo dnf module enable php:remi-8.3 -y # 指定 PHP 8.3 版本 sudo dnf install -y php php-fpm php-mysqlnd php-gd

必须启用 Remi 源以获取新版 PHP，否则默认仓库版本过旧。

## 2. 源码编译安装（高级场景）

适用于定制化需求（如信创环境）：

安装依赖库（关键步骤）：

# Debian/Ubuntu sudo apt install -y libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libonig-dev # RHEL/CentOS sudo dnf install -y libxml2-devel openssl-devel libcurl-devel libjpeg-turbo-devel oniguruma-devel

配置编译参数：
必须指定--enable-fpm和数据库扩展（如--with-pdo-mysql），否则 Web 服务无法解析 PHP。

./configure --prefix=/usr/local/php \ --enable-fpm \ --with-fpm-user=www-data \ --with-fpm-group=www-data \ --enable-mbstring \ --with-pdo-mysql

2.Windows 系统（推荐集成环境）

## 1. 集成环境（新手首选）

phpEnv：
支持多 PHP 版本共存（如 8.2/8.3），内置 Apache/Nginx、MySQL，无需手动配置环境变量，安装后直接通过 GUI 切换版本。
XAMPP/WampServer：
一键安装 Apache、MySQL、PHP，适合本地开发，但生产环境需额外加固配置。

## 2. 手动安装（需严格匹配架构）

从 PHP 官方 Windows 版下载页获取线程安全（TS）版本（Apache 需 TS，Nginx 需 NTS）。
解压后：
- 将 PHP 目录路径（如C:\php）加入系统环境变量PATH。
- 重命名php.ini-development为php.ini，启用关键扩展：
```
extension=gd extension=mysqli extension=mbstring
```
Web 服务器配置差异：
- Apache：在httpd.conf中添加LoadModule php_module "C:/php/php8apache2_4.dll"和PHPIniDir "C:/php"。
- Nginx：需配置fastcgi_pass指向php-cgi.exe或php-fpm。

3.macOS 系统

## 1. 官方支持变化

macOS Monterey (12.0) 之前：系统自带 PHP，但版本老旧（通常 7.x），不推荐使用。
macOS Monterey 之后：不再预装 PHP，需通过第三方工具安装。

## 2. 推荐安装方式

Homebrew（主流方案）：

brew install php@8.3 # 指定版本 echo 'export PATH="/opt/homebrew/opt/php@8.3/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

必须手动更新PATH，否则终端仍调用系统旧版 PHP。

手动编译：
适用于深度定制，需先安装 Xcode 命令行工具：

xcode-select --install ./configure --with-apxs2=/usr/sbin/apxs --with-mysqli --enable-mbstring

二、关键配置与验证

1.Web 服务器集成要点

Nginx 必须配置fastcgi_pass：
将.php请求转发至 PHP-FPM，例如：

location ~ \.php$ { fastcgi_pass unix:/run/php-fpm/www.sock; # 路径需与 php-fpm.conf 一致 include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }

路径不匹配将导致 502 错误。