laravel 11 要求 php ≥ 8.2，否则报错 runtimeexception；必需扩展包括 mbstring、openssl、pdo 等，缺一则 artisan 命令可能静默失败；必须用 composer create-project 安装，禁用 zip 或 git 克隆；开发阶段可用 php artisan serve，无需 nginx；node.js ≥ 18.x 为可选但高频依赖。
PHP 版本和扩展必须达标
Laravel 11（当前最新稳定版）要求 PHP ≥ 8.2，低于这个版本会直接报错 RuntimeException: Laravel requires PHP version 8.2 or higher.。别信“差不多能跑”，哪怕只差小数点后一位，composer create-project 都会中断。运行 php -v 确认版本后，还得检查必需扩展是否启用：php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json|bcmath|fileinfo'。漏掉 mbstring 或 fileinfo，后续 artisan 命令可能静默失败或路由不生效。
Composer 是唯一可信的安装入口
不要下载 ZIP 包手动解压，也不要用 Git clone 官方仓库——Laravel 不是这样用的。所有官方支持的安装方式都依赖 composer。它不只是“装包工具”，更是 Laravel 项目结构、自动加载、服务提供者注册的起点。确认 composer -v 可执行后，优先用 composer create-project laravel/laravel myapp，而不是 laravel new myapp（后者需要全局安装 laravel/installer，多一层故障点）。如果遇到 “Could not find package laravel/laravel” 错误，大概率是 Composer 源被墙或缓存损坏，可临时切国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，应改用 https://mirrors.aliyun.com/composer/）。
Web 服务器不是必须立刻配好
本地开发阶段，完全不需要 Apache 或 Nginx。Laravel 自带的 php artisan serve 就够用，它基于 PHP 内置服务器，监听 http://127.0.0.1:8000。但要注意：这个服务器不支持重写规则（如隐藏 index.php），也不处理静态资源缓存，仅用于开发调试。如果你硬要配 Nginx，就必须手动写 location / 块并指向 public/index.php，否则 404 会反复出现。Windows 用户尤其别在 WampServer/XAMPP 里“套娃”跑 Laravel——路径解析和权限容易错乱，反而增加排查成本。
Node.js 和 npm 属于可选但高频依赖
纯后端 API 项目可以跳过 Node.js；但只要涉及 Blade 模板里引入 CSS/JS、使用 Inertia/Vue/React，或者跑 npm run build，就必须装 Node.js ≥ 18.x（Laravel Vite 默认要求）。常见坑是：装了 Node.js 却没装 npm，或 npm -v 显示版本但 npm install 报 ERR_OSSL_PEM_NO_START_LINE ——这通常是 OpenSSL 版本冲突，建议用 nvm-windows（Windows）或 nvm（macOS/Linux）管理 Node 版本，避免系统级污染。
php artisan migrate 或访问页面时才暴露。与其提前堆砌所有“可能要用”的东西，不如按需安装、逐个验证。
