PHP安装与环境配置详细教程

本文全面详解了PHP开发环境的四种主流配置方式——从适合新手的一键式XAMPP集成安装，到可高度定制的手动安装与环境变量配置；从macOS用户偏爱的Homebrew便捷部署，再到现代化、跨平台且隔离性强的Docker容器化方案。无论你是刚入门的开发者，还是追求灵活控制与团队协作一致性的资深工程师，都能从中找到匹配自身系统和需求的高效落地路径，快速搭建稳定、可复现的PHP运行环境。

如果您希望在本地计算机上运行PHP程序，但尚未配置相应的开发环境，则需要完成PHP解释器的安装及基础环境的搭建。以下是实现该目标的具体步骤：

一、使用XAMPP集成包快速安装

XAMPP是一个包含Apache、MySQL、PHP和Perl的开源集成环境，适用于Windows、macOS和Linux系统，无需单独配置各组件依赖关系，适合初学者快速启动。

1、访问Apache Friends官网（https://www.apachefriends.org/），下载对应操作系统的XAMPP安装包。

2、双击运行安装程序，取消勾选不需要的服务（如FileZilla、Mercury Mail），仅保留Apache和MySQL。

3、在安装路径中选择非中文、无空格的目录（例如C:\xampp），避免路径解析异常。

4、安装完成后启动XAMPP Control Panel，点击Apache和MySQL行对应的Start按钮，确认状态显示为Running。

5、在浏览器中访问http://localhost，若出现XAMPP欢迎页面，则表明Web服务器与PHP已正常协同工作。

二、手动安装PHP并配置系统环境变量

手动安装可精确控制PHP版本与扩展模块，适用于需定制化部署或学习底层原理的用户。此方式要求独立安装Web服务器（如Apache或Nginx）并完成PHP模块加载配置。

1、前往PHP官方Windows二进制包页面（https://windows.php.net/download/），下载Thread Safe（TS）版本的ZIP包（推荐PHP 8.2.x或8.3.x）。

2、解压ZIP文件至固定路径（例如C:\php），确保路径不含空格和中文字符。

3、将php.ini-development重命名为php.ini，并用文本编辑器打开，取消以下行的注释：extension_dir = "ext" 和 cgi.force_redirect = 0。

4、在系统环境变量Path中新增C:\php，使php命令可在任意终端中执行。

5、以管理员身份打开命令提示符，输入php -v，若返回PHP版本信息则表示CLI环境配置成功。

三、通过Homebrew在macOS上安装PHP

Homebrew是macOS主流的包管理工具，能自动处理依赖、编译和路径注册，安装过程简洁且易于后续升级维护。

1、若未安装Homebrew，在终端中执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。

2、运行brew update更新软件包索引。

3、执行brew install php安装最新稳定版PHP（含CLI、FPM及常用扩展）。

4、安装完成后，Homebrew会提示PHP二进制路径（通常为/opt/homebrew/bin/php），将其加入shell配置文件（如~/.zshrc）的PATH中。

5、执行source ~/.zshrc && php -v验证安装结果，确认输出包含版本号与构建信息。

四、使用Docker运行PHP开发环境

Docker提供轻量级容器化运行时，可隔离PHP版本、扩展及Web服务器配置，避免与宿主机环境冲突，支持跨平台一致部署。

1、安装Docker Desktop并确保其正在运行。

2、创建项目目录，在其中新建docker-compose.yml文件，内容包含nginx服务与php:fpm镜像定义。

3、在php服务配置中挂载本地代码目录至容器内/var/www/html，并启用opcache与gd扩展。

4、执行docker-compose up -d启动服务，等待容器初始化完成。

5、在浏览器中访问http://localhost:8080，若显示phpinfo()页面则表明容器内PHP环境已就绪。

理论要掌握，实操不能落！以上关于《PHP安装与环境配置详细教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！