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: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,比重装三次环境更省时间。