
全面详尽的PHP环境搭建教程(涵盖 Windows、Linux与macOS)
PHP作为全球最流行的服务端脚本语言之一,其开发环境的高效配置是项目顺利运行的基础。无论您是初学者还是资深开发者,在不同操作系统中快速搭建稳定可靠的PHP运行环境都是必备技能。本文将详细讲解在Windows、Linux和macOS三大主流平台上的PHP环境搭建流程。
一、Windows环境下的PHP搭建
在Windows下搭建PHP环境,主要有集成环境和手动安装两种方式。对于追求灵活性和性能调优的开发者,推荐手动安装配置。
1. 手动安装配置
前往PHP官方Windows下载站点(windows.php.net)下载适用于Windows的ZIP压缩包。请务必选择“Thread Safe”(线程安全)版本,以便后续配合Apache等服务器使用。
下载解压后,将其放置于如 C:php 目录下。接着配置系统环境变量:
右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
在“系统变量”的“Path”中新增
C:php路径。
随后,进入PHP安装目录,将 php.ini-development 重命名为 php.ini,并编辑该文件开启常用扩展(去掉分号注释):
extension_dir = "ext" extension=curl extension=gd extension=mysqli extension=pdo_mysql extension=openssl
验证是否安装成功,打开命令提示符执行:
php -v
2. 配置Apache服务器
若需配合Apache,需修改Apache的 httpd.conf 文件,加载PHP模块并关联文件解析:
LoadModule php_module "C:/php/php8apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php"
二、Linux环境下的PHP搭建
Linux发行版众多,本文以最常用的Ubuntu (Debian系) 和CentOS (RHEL系) 为例,使用包管理器进行安装,这是最快捷稳定的方式。
1. Ubuntu系统安装PHP
Ubuntu官方源通常包含较新的PHP版本。通过APT安装PHP及常用扩展:
sudo apt update sudo apt install php php-cli php-fpm php-mysql php-xml php-mbstring php-curl php-zip
2. CentOS系统安装PHP
CentOS默认源中的PHP版本较旧,推荐安装EPEL和Remi仓库以获取最新版本:
sudo yum install epel-release sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm sudo yum-config-manager --enable remi-php81 sudo yum install php php-cli php-fpm php-mysqlnd php-xml php-mbstring php-json
3. 启动与配置PHP-FPM
现代Linux环境中通常配合Nginx使用PHP-FPM来处理PHP请求。安装完成后需启动该服务:
sudo systemctl start php-fpm sudo systemctl enable php-fpm
在Nginx的站点配置中,需将PHP请求反向代理到PHP-FPM监听的端口(通常是9000端口或Unix Socket):
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;
}三、macOS环境下的PHP搭建
macOS自带了较为老旧的PHP环境,但自macOS Catalina起,Apple移除了内置的PHP。目前最推荐的方式是使用Homebrew包管理器进行安装。
1. 安装Homebrew
若尚未安装Homebrew,可通过终端执行以下命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 使用Homebrew安装PHP
直接通过brew安装最新版PHP,它将自动处理依赖关系:
brew install php
3. 服务管理
Homebrew安装完PHP后,会自动启动PHP-FPM服务。您也可以通过brew services来管理它:
brew services start php brew services restart php
四、环境验证与测试
无论使用哪种操作系统,环境搭建完成后,均需进行统一验证。
1. 命令行验证
在终端或命令行输入以下命令,若正确返回PHP版本信息,则说明CLI环境配置成功:
php -v
2. Web服务器验证
在您的Web根目录(如Apache的htdocs或Nginx的html目录)下,创建一个名为 phpinfo.php 的文件,写入以下代码:
<?php phpinfo(); ?>
随后在浏览器中访问 http://localhost/phpinfo.php。若能看到完整的PHP配置信息页面,则说明PHP运行环境已全面搭建成功。调试完毕后,建议删除该文件以免暴露服务器配置信息。