laravel安装失败主因是php扩展缺失、composer超时、权限不足或.env配置错误；需安装ctype/filter/hash/mbstring/openssl/session/tokenizer扩展并重启php服务，切换国内镜像、延长超时或改用create-project命令，重置~/.composer权限，且必须运行php artisan key:generate生成app_key。
新手安装Laravel时，常因环境配置缺失、权限混乱或网络策略误设导致laravel new命令卡死、报错退出甚至生成不完整项目结构。
检查并安装必需PHP扩展
运行laravel new myapp前，Laravel Installer会强制校验一组核心PHP扩展是否启用。缺失任一扩展都会中断安装流程，直接抛出"The following PHP extensions are required but are not installed"错误。
在Ubuntu/Debian系统中执行：
sudo apt-get install php-ctype php-filter php-hash php-mbstring php-openssl php-session php-tokenizer
CentOS/RHEL用户请改用：
sudo yum install php-ctype php-filter php-hash php-mbstring php-openssl php-session php-tokenizer
【必须重启PHP服务】扩展安装后不重启PHP-FPM或Apache，扩展仍不会生效——这是90%新手跳过的致命步骤。
解决Composer依赖下载超时
方法一：切换国内镜像源
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
方法二：延长全局超时阈值
composer config -g process-timeout 600
方法三：绕过Installer，直接用create-project（更稳定）
composer create-project laravel/laravel my-project --prefer-dist
注意：如果已卡在Installing dependencies超过5分钟，不要等待，立即Ctrl+C终止后执行方法三。
修复权限不足导致的写入失败
第一步：重置Composer全局目录权限
sudo chown -R $USER:$USER ~/.composer && sudo chmod -R 755 ~/.composer
第二步：确保目标项目路径可写
mkdir -p /path/to/your/projects && sudo chmod -R 755 /path/to/your/projects
第三步：Windows用户必须以管理员身份运行终端——普通CMD或PowerShell窗口无法写入Program Files或受保护系统路径。
规避.env文件配置陷阱
安装成功后立即编辑.env文件，完成以下三项不可跳过的修改：
APP_DEBUG=false → 不关掉它，线上所有SQL语句、文件路径、密钥将裸露在浏览器错误页中
APP_ENV=production → 否则缓存、路由等优化机制不会启用，性能下降3倍以上
APP_KEY=base64:xxxxxx → 必须运行php artisan key:generate生成，不能留空或用默认值，否则Session加密失效
【严禁提交.env到Git】确认.gitignore中已包含.env，若已误提交，立刻执行：
git rm --cached .env && git commit -m "Remove .env from version control"
验证LaravelS WebSocket服务监听配置
若后续需启用LaravelS（如长连接、实时通知），安装后必须手动修正.env两处关键项：
LARAVELS_LISTEN_IP=0.0.0.0 → 不设为该值，外部设备无法访问WebSocket服务
LARAVELS_DAEMONIZE=true → 否则进程随终端关闭而终止，无法后台常驻
这两项漏配会导致php bin/laravels start看似成功，实则服务不可达。
