laravel 环境配置需严格遵循步骤：确认 php ≥ 8.2 及必需扩展，显式指定版本创建项目，复制 .env.example 并修改关键配置，运行 php artisan key:generate 生成密钥，再执行 php artisan serve 启动服务。
刚装好 Laravel，别急着写代码——先确保环境跑得稳、配置写得对、命令用得熟。安装只是起点，真正影响后续开发效率的，是 .env 的规范设置和 Artisan 的日常使用。
环境准备：PHP 版本与扩展一个都不能少
Laravel 11 要求 PHP ≥ 8.2.0，Laravel 10 可用 PHP 8.1+，但推荐统一用 8.2 或更高。缺扩展比版本低更致命，以下扩展必须启用：
- mbstring（字符串处理）
- openssl（加密与 HTTPS）
- pdo（数据库驱动基础）
- tokenizer（语法解析关键）
- xml、ctype、json（框架启动必备）
验证方式很简单：
- 运行 php -v 确认版本
- 运行 php -m | grep -E 'mbstring|openssl|pdo'（Mac/Linux）或 php -m 后手动查找（Windows）
Windows 用户若用 WAMP/XAMPP，请检查 php.ini 中是否启用了对应 extension= 行；WSL 或 Linux 用户常用 apt install php8.2-mbstring php8.2-xml 补全。
项目创建：别被“最新版”误导，版本要手动锁
默认执行 composer create-project laravel/laravel myapp 拉到的大概率是 Laravel 10.x，不是你想要的 v11。Packagist 的 latest 标签尚未自动切到 v11 stable，必须显式指定：
- 装 Laravel 11：composer create-project laravel/laravel:^11.0 myapp
- 加 --prefer-dist 加速下载（优先用压缩包而非 git clone）
- 国内用户务必提前配镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
装完立刻检查 myapp/composer.json 中 "laravel/framework": "^11.0" 是否存在，否则说明没拉对。
.env 配置：不是可选项，是运行前提
项目根目录下没有 .env 文件，Laravel 就无法读取数据库、调试开关、应用密钥等关键参数。操作步骤必须严格：
- 从 .env.example 复制一份，重命名为 .env（注意 Windows 资源管理器可能隐藏扩展名，建议用命令行：copy .env.example .env 或编辑器直接新建）
- 至少修改这几项：
APP_NAME（如 MyAdmin）
APP_DEBUG=true（开发环境；上线前务必改为 false）
DB_CONNECTION=mysql（选 mysql 或 sqlite；若选 mysql，DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD 必须填全） - 改完立即运行 php artisan config:clear，否则缓存沿用旧值，配置“不生效”是常见假象
启动前必做：APP_KEY 生成与 Artisan 命令规范
APP_KEY 不是随便填的占位符，而是框架启动必需。初始 APP_KEY=base64: 是无效值，不生成真实密钥会导致 session、cookie、signed URL 全部失效，页面直接 500。
- 进入项目根目录后，第一时间执行：php artisan key:generate
- Artisan 命令必须在项目根目录运行，确认路径无误后可用 php artisan list 查看全部可用命令
- 自定义命令需注册到 app/Console/Kernel.php 的
$commands数组，或满足 Laravel 10+ 自动发现规则；$signature中空格与等号位置必须准确，否则命令无法识别 - 数据库迁移前，确保已运行 php artisan migrate --seed（含填充数据）或仅 php artisan migrate
最后，用 php artisan serve 启动开发服务器，默认访问 http://localhost:8000。看到欢迎页，说明整个链路已通。
