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: - Windows 用户注意:CMD 中
php -S可能因路径空格报错,建议用 PowerShell 或把项目移到无空格路径(如C:\phpdev)
用 XAMPP / WAMP / MAMP(适合 WordPress / ThinkPHP 等传统项目)
这类集成包本质是预装了 Apache + MySQL + PHP 的图形化管理器,省去手动配服务的步骤,但容易掩盖真实依赖关系——比如你以为 PHP 已就绪,其实 pdo_mysql 扩展默认是关的。
立即学习“PHP免费学习笔记(深入)”;
PHP网络编程技术详解由浅入深,全面、系统地介绍了PHP开发技术,并提供了大量实例,供读者实战演练。另外,笔者专门为本书录制了相应的配套教学视频,以帮助读者更好地学习本书内容。这些视频和书中的实例源代码一起收录于配书光盘中。本书共分4篇。第1篇是PHP准备篇,介绍了PHP的优势、开发环境及安装;第2篇是PHP基础篇,介绍了PHP中的常量与变量、运算符与表达式、流程控制以及函数;第3篇是进阶篇,介绍
使用场景:需要数据库、要跑带 .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,比重装三次环境更省时间。










