集成PHP开发环境需满足四个硬性规范：1. Apache与PHP线程模型必须匹配（Windows下须用TS版）；2. php.ini中须显式声明extension_dir路径并启用mysqli、pdo_mysql等关键扩展；3. MySQL端口需与PHP连接配置一致，避免因端口冲突导致连接拒绝；4. htdocs仅用于Web服务，Composer等CLI操作须在有权限的独立目录执行。
集成软件（如 XAMPP、WAMP、MAMP、Laragon）是最快启动 PHP 开发的路径，但“一键安装”不等于“零配置”。真正能稳定跑 phpinfo()、连上数据库、支持 composer install 的环境，必须满足四个硬性规范。漏掉任一环节，后续调试会卡在莫名其妙的 500 错误、扩展加载失败或连接拒绝上。
Apache 和 PHP 版本必须匹配线程模型
Windows 下最常踩的坑：下载了非线程安全（NTS）版 PHP，却用 LoadModule php_module "php7apache2_4.dll" 尝试加载——这个 DLL 只认线程安全（TS）版 PHP。
- XAMPP 默认捆绑的是 TS 版 PHP，所以直接用它最省事
- 若手动替换 PHP（比如想升到 PHP 8.3），必须确认下载页标注为
Thread Safe，且 DLL 文件名含ts（如php8.3.0-Win32-vs16-x64-ts） - Linux/macOS 上用 Homebrew 或官方包一般无此问题，因 Apache 模块加载机制不同
- 验证方式：运行
php -i | findstr "Thread Safety"（Windows）或php -i | grep "Thread Safety"（macOS/Linux），输出enabled才对
PHP 扩展目录与启用项必须显式声明
哪怕 php.ini 是从 php.ini-development 复制而来，extension_dir 默认是注释状态，且多数扩展（如 mysqli、pdo_mysql、curl）默认被禁用。
- 取消注释并修正路径：
extension_dir = "C:/xampp/php/ext"（Windows）或extension_dir = "/opt/lampp/php/lib/php/extensions/no-debug-non-zts-20220829"（Linux XAMPP） - 逐行启用必需扩展：
extension=mysqli、extension=pdo_mysql、extension=openssl、extension=curl - Windows 下注意扩展名是
.dll，Linux/macOS 是.so，但 ini 文件里都不写后缀 - 改完后必须重启 Apache，否则
phpinfo()里看不到已启用的扩展
MySQL 服务端口与 PHP 连接配置需主动对齐
集成环境默认 MySQL 端口是 3306，但若系统已有 Skype、VMware 或其他服务占用了该端口，XAMPP 会自动 fallback 到 3307 —— 而 PHP 的 mysqli 扩展默认仍连 3306，导致 mysqli_connect(): Connection refused。
立即学习“PHP免费学习笔记（深入）”；
- 启动前先查端口占用：
netstat -ano | findstr :3306（Windows）或lsof -i :3306（macOS/Linux） - 若被占用，在 XAMPP 控制面板点击 MySQL 行右侧的
Config → my.ini，修改port=3307，保存后重启 MySQL - PHP 代码中显式指定端口：
new mysqli('127.0.0.1', 'root', '', 'test', 3307)，避免依赖默认值 - 或者统一改回
3306：关掉冲突进程，再重启 MySQL
htdocs 权限与路由路径必须区分开发与 CLI 场景
很多人测试 php -v 成功、http://localhost/info.php 正常，但运行 composer create-project laravel/laravel 却提示 Permission denied 或 Could not open input file: composer.phar —— 这是混淆了 Web 服务路径和命令行工作路径。
-
htdocs目录只对 Apache/Nginx 有效；Composer、Artisan、PHP CLI 命令在终端中执行，当前工作目录决定文件读写权限 - 不要把项目建在
C:\xampp\htdocs\myapp后直接在该目录下跑composer install（Windows 下可能因 UAC 被拦截） - 推荐做法：项目放在用户目录（如
C:\Users\Alice\projects\myapp），用 Composer 安装，再通过 Apache 虚拟主机或别名指向它 - 若坚持放
htdocs，右键终端选择“以管理员身份运行”，或临时关闭 UAC（不推荐）
四个规范里，最容易被忽略的是线程模型匹配和 CLI 工作路径隔离——它们不会在 phpinfo() 里报错，但会让后续所有框架初始化、数据库迁移、队列监听全部静默失败。动手前花两分钟确认这四点，比之后两小时查日志高效得多。
