搭建PHP全栈开发环境核心是三件事:运行服务(Web+数据库)、执行PHP、管理依赖;新手首选XAMPP等集成环境,避免手动配置的端口、权限、php.ini不一致等问题。

直接上手,不绕弯——搭建PHP全栈开发环境核心就三件事:运行服务(Web+数据库)、执行PHP、管理依赖。选对工具能省掉80%的配置踩坑时间。
选一个集成环境,别从Apache+PHP+MySQL手动配
新手或日常开发,强烈推荐用现成集成套件,避免路径、权限、端口、扩展、CLI与Web模式php.ini不一致等经典问题。
-
XAMPP:最老牌,界面直观,适合入门。安装到
C:\xampp(无中文、无空格),启动控制面板,点开 Apache 和 MySQL 即可。默认项目放htdocs,想换目录?改xampp\apache\conf\httpd.conf里的DocumentRoot和对应<directory></directory>路径即可。 -
Laragon:进阶首选。免费、轻量、支持多版本PHP/MySQL一键切换,自动配虚拟主机(比如直接访问
myapp.test),还内置Composer、Git、ngrok。安装后默认就带PHP 8.2+,开箱即用,适合Laravel/Filament等现代框架项目。 -
WampServer:稳定老将,适合习惯托盘图标的用户。注意装前装好VC++运行库;安装路径别选
Program Files;若图标橙色/红色,大概率是80端口被占用,改alias\apache\conf\extra\httpd-mpm.conf里的Listen 8080并重启。
打开PHP关键扩展,尤其命令行要用的
很多报错(如 Composer SSL失败、Filament启动报错)根源都在 php.ini 没配对——重点不是Apache用的那份,而是命令行(CMD/PowerShell)调用的那份。
- 找到CLI版php.ini:在终端运行
php --ini,看“Loaded Configuration File”路径,通常在xampp\php\php.ini或laragon\bin\php\php-{version}\php.ini。 - 必须启用的扩展(去掉前面的分号):
extension=intl(Filament/Laravel必需)、extension=openssl(Composer走HTTPS)、extension=mbstring、extension=gd、extension=pdo_mysql、extension=fileinfo(上传文件)、extension=zip(解压包)。 - 改完保存,**必须重启Apache/MySQL服务**(XAMPP点Stop再Start;Laragon点右上角?;WampServer点托盘图标→Restart All)。
装Composer,并验证它真能跑
Composer是PHP项目的“管家”,没它,Laravel、Filament、ThinkPHP都装不了。
立即学习“PHP免费学习笔记(深入)”;
- 去 getcomposer.org 下Windows Installer,安装时让它自动探测php.exe路径(一般能准确定位到集成环境里的PHP)。
- 安装完,在任意文件夹打开CMD,输入
composer -V。看到版本号(如Composer version 2.7.7)才算成功。 - 如果报错“'composer' 不是内部或外部命令”,说明系统PATH没生效——重启终端,或手动把Composer安装目录(如
C:\ProgramData\ComposerSetup\bin)加进系统环境变量PATH。
配好IDE,让代码写得顺
写PHP不靠记函数,靠IDE智能提示和调试。推荐两个主流选择:
-
HBuilderX:前端友好,轻量,对PHP基础语法支持够用。设置里指定PHP解释器路径(指向你的
php.exe),就能跑PHP内置服务器、实时预览。 -
PhpStorm:专业级,深度理解Laravel/Filament等框架,自动识别路由、模型、Blade模板。新建项目时,它会自动检测本地PHP解释器;若没识别,进
Settings → PHP → Interpreter手动指定php.exe路径即可。
不复杂但容易忽略:确保IDE用的是和命令行一致的PHP版本,否则调试时行为可能不一致。



















