全面详尽的PHP环境搭建教程（涵盖 Windows、Linux与macOS）

PHP环境搭建全攻略：Windows、Linux、macOS三大系统详细步骤与验证教程

PHP是目前使用最广泛的服务器端脚本语言之一，无论是搭建个人博客、开发电商网站，还是构建企业级应用，都离不开它。对于刚接触PHP的开发者来说，第一步就是要在自己的电脑上搭建好运行环境。但由于Windows、Linux和macOS三个系统的差异，很多人在这一步就卡住了。本文将从零开始，逐一讲解三种操作系统下的PHP环境搭建方法，并附上详细的验证步骤，确保你能顺利完成配置。

一、Windows系统下搭建PHP环境

Windows用户搭建PHP环境有两种主流方式：一种是使用集成环境，另一种是手动配置。集成环境适合不想折腾的初学者，一键安装就能用；手动配置则更适合需要自定义配置、追求性能优化的开发者。这里我们重点介绍手动配置的方法，因为这样能让你更清楚地了解PHP的运行原理。

1. 下载并解压PHP

首先，我们需要从PHP官方网站下载Windows版本的安装包。打开浏览器，访问PHP的Windows下载页面，你会看到两个主要版本：一个是线程安全版本，另一个是非线程安全版本。如果你打算配合Apache服务器使用，一定要选择线程安全版本，否则会出现兼容性问题。

下载完成后，得到一个ZIP压缩包。把它解压到一个你容易记住的位置，比如C盘的根目录下，文件夹名称可以改成简单的名字，例如C:\php。这个目录就是PHP的安装目录，后面所有的配置都会围绕这个目录展开。

2. 配置系统环境变量

为了让系统能够全局识别PHP命令，我们需要把PHP的安装路径添加到系统的环境变量中。操作步骤如下：

右键点击桌面上的“此电脑”图标，选择“属性”。在弹出的窗口中，点击左侧的“高级系统设置”。接着会弹出“系统属性”对话框，点击右下角的“环境变量”按钮。在“系统变量”列表中找到“Path”这一项，双击它，然后点击“新建”，输入PHP的安装路径，也就是C:\php。确认保存后，环境变量就配置好了。

这一步非常重要，如果不配置环境变量，你在命令行里输入php -v就会提示找不到命令。配置完成后，建议重启一下命令行窗口，让新的环境变量生效。

3. 修改PHP配置文件

进入PHP安装目录，你会看到两个示例配置文件：php.ini-development和php.ini-production。前者适合开发环境，后者适合生产环境。我们把php.ini-development重命名为php.ini，然后用记事本或其他文本编辑器打开它。

在这个文件中，你需要开启一些常用的扩展。找到下面这几行，把前面的分号去掉即可启用对应的扩展：

extension_dir = "ext"
extension=curl
extension=gd
extension=mysqli
extension=pdo_mysql
extension=openssl

这些扩展分别对应不同的功能：curl用于网络请求，gd用于图像处理，mysqli和pdo_mysql用于连接MySQL数据库，openssl用于加密通信。根据你的项目需求，还可以开启更多扩展。

4. 验证PHP是否安装成功

打开命令提示符，输入以下命令：

php -v

如果屏幕上显示出PHP的版本信息，比如“PHP 8.x.x”，那就说明PHP的命令行环境已经配置成功了。如果提示“不是内部或外部命令”，那就需要回头检查环境变量是否配置正确。

5. 配置Apache服务器（可选）

如果你需要使用Apache作为Web服务器，还需要在Apache的配置文件中添加对PHP的支持。找到Apache的httpd.conf文件，在合适的位置加入以下几行：

LoadModule php_module "C:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"

第一行告诉Apache加载PHP模块，第二行让Apache知道.php后缀的文件要用PHP来处理，第三行指定PHP配置文件的路径。修改完成后，重启Apache服务，就可以正常解析PHP文件了。

二、Linux系统下搭建PHP环境

Linux系统在服务器领域占据主导地位，大部分PHP应用都是在Linux环境下运行的。这里我们以最常见的Ubuntu和CentOS为例，介绍如何使用包管理器安装PHP。

1. Ubuntu系统安装PHP

Ubuntu使用的是APT包管理器，安装软件非常方便。打开终端，先更新一下软件源，确保能获取到最新的软件包：

sudo apt update

然后执行安装命令，一次性安装PHP及其常用扩展：

sudo apt install php php-cli php-fpm php-mysql php-xml php-mbstring php-curl php-zip

这条命令会安装PHP的核心程序、命令行接口、FastCGI进程管理器、MySQL扩展、XML处理扩展、多字节字符串扩展、cURL扩展和ZIP扩展。这些都是开发PHP应用时最常用的组件。

安装完成后，可以用同样的php -v命令验证是否安装成功。

2. CentOS系统安装PHP

CentOS默认的软件源中PHP版本比较老旧，所以我们先安装EPEL和Remi这两个第三方仓库，这样可以获取到更新的PHP版本。

sudo yum install epel-release
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm

安装完仓库后，启用PHP 8.1版本的源：

sudo yum-config-manager --enable remi-php81

最后安装PHP及相关扩展：

sudo yum install php php-cli php-fpm php-mysqlnd php-xml php-mbstring php-json

CentOS的安装过程和Ubuntu大同小异，只是包管理器和仓库配置略有不同。

3. 启动PHP-FPM服务

在现代Linux环境中，PHP通常以PHP-FPM的形式运行，配合Nginx一起使用。PHP-FPM是一个独立的进程管理器，专门用来处理PHP请求。安装完成后，需要启动这个服务：

sudo systemctl start php-fpm
sudo systemctl enable php-fpm

第一行命令立即启动PHP-FPM，第二行命令设置开机自启，这样每次重启服务器后PHP-FPM都会自动运行。

4. 配置Nginx与PHP-FPM协同工作

如果你的Web服务器是Nginx，需要在Nginx的站点配置文件中添加一段配置，让Nginx把PHP请求转发给PHP-FPM处理。找到Nginx的配置文件，在server块中添加如下内容：

location ~ .php$ {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

这段配置的意思是：当用户访问以.php结尾的URL时，Nginx会把请求交给本地地址127.0.0.1的9000端口处理，而这个端口正是PHP-FPM监听的端口。配置完成后，重启Nginx服务即可生效。

三、macOS系统下搭建PHP环境

macOS系统虽然自带PHP，但从某个版本开始苹果移除了内置的PHP。现在最推荐的安装方式是使用Homebrew包管理器，它能帮你处理好所有依赖关系。

1. 安装Homebrew

Homebrew是macOS上最流行的包管理工具。打开终端，执行以下命令即可安装：

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

安装过程中可能会要求输入密码，按照提示操作即可。安装完成后，可以用brew --version命令验证是否安装成功。

2. 使用Homebrew安装PHP

Homebrew安装软件非常简单，一条命令就能搞定：

brew install php

这个命令会自动下载PHP的最新版本，并安装所有必要的依赖。整个过程可能需要几分钟时间，耐心等待即可。

3. 管理PHP服务

Homebrew安装完PHP后，会自动启动PHP-FPM服务。你可以通过以下命令来管理这个服务：

brew services start php
brew services restart php
brew services stop php

第一行命令启动PHP服务，第二行重启服务，第三行停止服务。这些命令在你修改PHP配置后需要重启服务时会非常有用。

4. 验证macOS下的PHP环境

同样，在终端中输入php -v命令，如果能显示PHP版本信息，说明安装成功。如果需要配合Web服务器使用，可以参考前面Linux部分的Nginx配置方法。

四、环境验证与测试

不管你在哪个操作系统上搭建了PHP环境，最后都需要做一次全面的验证，确保一切正常工作。

1. 命令行验证

打开终端或命令提示符，输入：

php -v

如果看到类似“PHP 8.x.x”的输出，说明PHP的命令行接口已经配置成功。

2. Web服务器验证

接下来测试PHP能否在Web服务器中正常运行。在你的Web根目录下创建一个名为phpinfo.php的文件，写入以下内容：

<?php phpinfo(); ?>

然后在浏览器中访问http://localhost/phpinfo.php。如果能看到一张显示PHP配置信息的表格，上面有PHP版本、已加载的扩展、服务器环境等信息，那就说明你的PHP环境已经完全搭建成功。

需要注意的是，phpinfo()函数会暴露服务器的详细信息，出于安全考虑，测试完成后记得删除这个文件。

3. 常见问题排查

如果在验证过程中遇到问题，可以按以下思路排查：

• 如果命令行能运行但浏览器无法解析，检查Web服务器是否配置正确，特别是PHP模块或PHP-FPM是否已启动。
• 如果提示“404 Not Found”，检查文件路径是否正确，Web根目录是否设置对了。
• 如果出现空白页面，可能是PHP代码中有语法错误，或者某个扩展没有正确加载。

结语

PHP环境的搭建看似繁琐，但只要按照步骤一步步来，其实并不复杂。Windows、Linux和macOS各有各的特点，选择适合你的操作系统和安装方式就好。对于初学者，建议先从Windows的集成环境入手，熟悉之后再尝试手动配置。对于服务器环境，Linux加Nginx的组合是最经典的选择。希望这篇教程能帮助你顺利搭建起PHP开发环境，迈出学习PHP的第一步。

PHP环境搭建Windows PHP安装Linux PHP配置macOS PHP设置PHP开发教程修改时间：2026-08-01 21:11:34