必须满足PHP≥8.2.0且启用openssl、pdo、mbstring、tokenizer、xml、ctype、json、curl、zip、session、filter共11项扩展，Composer≥2.5.0，并正确配置Web服务器重写规则；否则composer create-project会中断，artisan命令可能静默失败或报类未找到错误。
要成功安装 Laravel 11，必须先满足其硬性环境门槛，否则 composer create-project 会直接中断并报错，且错误信息往往指向扩展缺失或 PHP 版本过低，而非真实原因。
确认 PHP 版本与核心扩展
执行 php -v，确保输出版本号 ≥ 8.2.0；低于此值将无法加载 Laravel 11 的底层组件，Composer 会拒绝继续安装。
运行 php -m 检查以下扩展是否全部启用：openssl、pdo、mbstring、tokenizer、xml、ctype、json、curl、zip、session、filter。缺一不可——例如缺少 【session】 扩展，Artisan 命令将启动失败，但错误提示可能仅显示“Class 'SessionHandler' not found”，不直接指出缺失模块。
在 Ubuntu/Debian 系统中补全扩展：sudo apt install php-mbstring php-xml php-zip php-curl php-tokenizer php-json php-opcache php-session php-filter。
验证 Web 服务器重写支持
Apache 用户需确认 mod_rewrite 已启用：执行 a2enmod rewrite 并重启 Apache（systemctl restart apache2）。
Nginx 用户必须在 server 块中配置 try_files $uri $uri/ /index.php?$query_string;，否则所有路由请求都将返回 404，且 Laravel 的 public/index.php 不会被触发。
检查 Composer 版本与配置
运行 composer --version，确保 ≥ 2.5.0；旧版 Composer 在解析 Laravel 11 的依赖树时会出现循环依赖警告甚至静默失败。
若使用宝塔面板，务必进入对应 PHP 版本设置 → 禁用函数列表，移除 【putenv, proc_open, proc_get_status】 ——这三个函数被默认禁用会导致 Laravel 安装器崩溃、Artisan 命令执行失败、队列监听器无法启动。
初始化 Laravel 11 项目
第一步：执行 composer create-project --prefer-dist laravel/laravel myapp，等待依赖下载与自动安装完成。
第二步：进入项目目录 cd myapp，复制环境文件：cp .env.example .env。
第三步：生成应用密钥：php artisan key:generate。这一步不可跳过，否则 session 和加密功能将失效。
第四步：启动开发服务器：php artisan serve。默认监听 http://127.0.0.1:8000，访问该地址看到 Laravel 欢迎页即表示环境安装成功。
