在wsl2的ubuntu 24.04中安装laravel 10，需先确认php≥8.1并启用mbstring、openssl、pdo等扩展，再安装配置composer，最后执行sudo composer create-project laravel/laravel myapp "10.*"创建项目，设置权限并运行php artisan serve验证。
在 WSL2 的 Ubuntu 24.04 中安装 Laravel 10，核心是先配好 PHP 环境和 Composer，再用命令创建项目。整个过程不依赖 Windows 原生工具，更贴近生产部署逻辑。
确认 PHP 版本与扩展
Laravel 10 要求 PHP ≥ 8.1，并启用以下扩展：mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl。执行以下命令检查：
- php -v —— 确保输出为 8.1 或更高（Ubuntu 24.04 默认带 PHP 8.3）
- php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json|intl' —— 检查是否全部列出
- 若缺 intl 扩展：sudo apt install php-intl
- 若缺 xml 或其他模块：sudo apt install php-xml php-mbstring php-zip php-curl
安装并配置 Composer
Composer 是 Laravel 的依赖管理器，必须全局可用：
- 下载安装脚本：curl -sS https://getcomposer.org/installer | php
- 移至系统路径：sudo mv composer.phar /usr/local/bin/composer
- 赋予执行权限：sudo chmod +x /usr/local/bin/composer
- 验证：composer --version，应显示 2.7.x 或更高
- 推荐切国内镜像加速：composer config -g repo.packagist composer https://packagist.phpcomposer.com
创建 Laravel 10 项目
进入 Web 根目录（如 /var/www），运行创建命令：
- sudo composer create-project laravel/laravel myapp "10.*" —— 明确指定 10.x 分支，避免默认拉取 Laravel 11/12
- 若网络卡顿，可加 -vvv 查看卡点；内存不足时加前缀：COMPOSER_MEMORY_LIMIT=-1 composer ...
- 项目生成后，设置正确权限：sudo chown -R $USER:www-data /var/www/myapp 和 sudo chmod -R 775 /var/www/myapp/storage /var/www/myapp/bootstrap/cache
基础验证与启动
无需 Nginx 也能快速验证项目是否可运行：
- 进入项目目录：cd /var/www/myapp
- 生成应用密钥：php artisan key:generate
- 启动内置服务器：php artisan serve --host=0.0.0.0:8000
- 在 Windows 浏览器中访问 http://localhost:8000（确保 WSL2 端口转发正常）
- 如遇 403 或白屏，检查 .env 中 APP_URL=http://localhost:8000 是否正确，且未误填为 127.0.0.1
