PHP本地环境配置需按需求选择：php -S适合快速验证，XAMPP/WAMP/MAMP适合传统Web项目，Docker适合现代框架开发；关键在于确认实际使用的PHP实例及配置文件。
PHP 本地环境不需要装“PHP 教程包”或“一键集成包”也能跑起来，关键在于明确你真正需要什么：是快速验证一段代码？开发 Laravel 项目？还是调试 WordPress？不同目标，配置方式和陷阱完全不同。
用 php -S 启动内置服务器（适合单文件/小项目）
PHP 5.4+ 自带轻量 HTTP 服务器，不依赖 Apache/Nginx，改完代码刷新即生效，适合学习语法、写工具脚本或原型验证。
常见错误现象：Could not open input file: -S（命令输错）、Failed to listen on 127.0.0.1:8000（端口被占）、路由不生效（没配 router.php）。
- 确保当前目录有
index.php，运行：php -S 127.0.0.1:8000
- 想支持 URL 路由（如访问
/user/123不报 404），加router.php：<?php if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js)$/', $_SERVER["REQUEST_URI"])) { return false; } include __DIR__ . '/index.php'; - Windows 用户注意：CMD 中
php -S可能因路径空格报错，建议用 PowerShell 或把项目移到无空格路径（如C:\phpdev）
用 XAMPP / WAMP / MAMP（适合 WordPress / ThinkPHP 等传统项目）
这类集成包本质是预装了 Apache + MySQL + PHP 的图形化管理器，省去手动配服务的步骤，但容易掩盖真实依赖关系——比如你以为 PHP 已就绪，其实 pdo_mysql 扩展默认是关的。
立即学习“PHP免费学习笔记（深入）”；
使用场景：需要数据库、要跑带 .htaccess 的老项目、团队协作需统一基础环境。
- 安装后务必打开控制面板，确认
Apache和MySQL都显示 Running，不是 Stopped 或 Blocked - 访问
http://localhost/phpmyadmin能进，不代表 PHP 连得上 MySQL；在项目里执行new PDO('mysql:host=localhost;dbname=test', $user, $pass)才算真通 - 扩展常被禁用：
extension=openssl、extension=curl、extension=pdo_mysql这三行在php.ini里必须取消注释（去掉分号），改完要重启 Apache - Mac 上 MAMP 默认用自建 PHP 而非系统 PHP，终端里
which php看到的路径和phpinfo()显示的Loaded Configuration File往往不一致，别混用
用 Docker 快速复现生产环境（适合 Laravel / Symfony 等现代框架）
本地装一堆服务容易冲突，Docker 把 PHP-FPM、Nginx、MySQL 封进隔离容器，docker-compose.yml 里定义好版本和配置，就能和线上保持一致。
性能影响：首次启动慢（要拉镜像），但后续 docker-compose up 秒启；文件变动热更新需额外配 notify 或挂载时加 :cached（Mac/Linux）。
- 最小可用配置只需两段：
version: '3.8' services: app: image: 'php:8.2-apache' ports: ['8080:80'] volumes: ['./src:/var/www/html'] - 别直接
docker run -it php:8.2-cli测试命令——它没 Apache，php -S也因网络限制无法从宿主机访问，必须用php:8.2-apache或自己装php-fpm + nginx -
php.ini修改不能只改宿主机文件：要么构建新镜像（Dockerfile里COPY php.ini /usr/local/etc/php/conf.d/），要么用volumes挂载整个conf.d目录
真正卡住人的往往不是“怎么装”，而是“哪个 PHP 在干活”——php -v、phpinfo()、whereis php、which php 四个命令结果经常不一致。先花 2 分钟确认当前上下文用的是哪个 PHP 实例、加载的是哪份 php.ini，比重装三次环境更省时间。
