用XAMPP或PHP内置服务器即可快速启动项目,无需手动配置Apache+MySQL+PHP;PHP内置服务器适合小项目验证路由和API,XAMPP/Laragon等集成环境更省心,推荐新手使用。

直接用 XAMPP 或 PHP内置服务器 就能跑起来,不需要装 Apache + MySQL + PHP 三件套手动配置——除非你明确要模拟生产环境或调试特定模块。
用 PHP 内置服务器快速启动(适合单文件/小项目)
PHP 5.4+ 自带 php -S 命令,不依赖 Apache/Nginx,适合验证路由、API 接口或静态资源服务逻辑。
- 进入项目根目录,执行:
php -S localhost:8000 -t public/
(public/是 Web 入口目录,若无则用.) - 如需自定义路由,创建
router.php:php -S localhost:8000 router.php
,其中router.php必须返回true或调用return false;让服务器 fallback 到静态文件 - 注意:
php -S不解析.htaccess,不支持mod_rewrite,也不能直接运行index.php以外的 PHP 脚本(除非路由显式包含)
用 XAMPP/Laragon/DevServer 一键开箱(推荐新手)
这类集成包把 Apache、MySQL、PHP、phpMyAdmin 打包好,双击启动即可,省去端口冲突、扩展启用、PATH 配置等常见卡点。
-
XAMPP:Windows/macOS/Linux 都有,但新版 macOS 上可能因 SIP 无法启动 MySQL;默认 Apache 监听80端口,若被 Skype 或 IIS 占用会报错「Address already in use」 -
Laragon(Windows):更轻量,支持多版本 PHP 切换,右键菜单可快速重载 Apache、打开终端、生成虚拟主机 - 启动后访问
http://localhost,确认看到欢迎页;再把项目放htdocs/(XAMPP)或www/(Laragon)下,用http://localhost/your-project/访问
配置虚拟主机(避免每次输端口或子路径)
本地开发中频繁改 localhost:8000 或 localhost/myapp 很麻烦,配个 test.local 这样的域名更接近真实部署场景。
立即学习“PHP免费学习笔记(深入)”;
- 修改系统
hosts文件(C:\Windows\System32\drivers\etc\hosts或/etc/hosts),加一行:127.0.0.1 test.local
- 在 Apache 的
httpd-vhosts.conf中添加:
(路径和目录名按实际调整)ServerName test.local DocumentRoot "C:/xampp/htdocs/myproject/public" AllowOverride All Require all granted - 重启 Apache;之后直接访问
http://test.local即可,且.htaccess生效,mod_rewrite可用
PHP 扩展与版本对齐(最容易被忽略的兼容性坑)
线上用 PHP 8.2,本地是 7.4?match 表达式、readonly 类、str_contains() 全部报错。别只看 php -v,还要确认 phpinfo() 页面里扩展是否加载成功。
- 检查常用扩展是否启用:
pdo_mysql(数据库)、mbstring(中文处理)、curl(HTTP 请求)、openssl(HTTPS/Composer) - Windows 下 XAMPP 的
php.ini通常在xampp/php/php.ini,改完必须重启 Apache 才生效;Linux/macOS 用php --ini查找配置路径 - 用
composer create-project laravel/laravel myapp初始化项目时,如果提示ext-zip not loaded,说明zip扩展未启用——不是没装,是没开
真正卡住人的往往不是“怎么装”,而是“为什么请求 404 却没报错”“为什么 var_dump 显示了但页面空白”“为什么 phpinfo 里看不到刚启用的扩展”——盯住 error_log、浏览器开发者工具 Network 标签页、以及 php -m 输出的扩展列表,比反复重装快得多。










