17370845950

用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 这样的域名更接近真实部署场景。

• 修改系统 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 输出的扩展列表，比反复重装快得多。