新手15分钟内可完成Laravel安装并显示欢迎页:先确认PHP≥8.1和Composer已安装,再用laravel new或composer create-project快速建项目,配置.env并生成密钥,最后php artisan serve启动服务访问首页。

新手零基础安装Laravel框架,需绕过手动配环境、查报错、改权限等易卡壳环节,直接用最简路径跑出欢迎页——只要电脑能连网、有基础命令行操作能力,15分钟内完成从空白到Laravel首页显示。
确认PHP和Composer已就位
打开命令行(Windows按Win+R输入cmd,macOS/Linux打开Terminal),依次执行两行命令:
php -v → 看到输出类似 PHP 8.2.2 (cli) (built: Jan 10 2024 12:34:56) 即可,【必须≥8.1,低于8.1会直接报错退出】;
composer --version → 显示 Composer version 2.7.7 或更高,无报错即通过。
若任一命令提示“不是内部或外部命令”,说明未安装。此时暂停后续步骤,先去官网 getcomposer.org 下载安装程序(Windows选.exe,macOS/Linux用curl一键装),安装时务必勾选“Add to PATH”选项。
用Laravel Installer极速创建项目
这是新手最稳的启动方式:不走依赖实时下载,而是解压预编译骨架,网络波动、镜像失效都不影响。
方法一:全局安装Laravel Installer并新建项目
在命令行中执行:
composer global require laravel/installer
等待终端出现 Successfully installed laravel/installer 后,运行:
laravel new myapp
这一步会在当前目录生成名为myapp的完整Laravel项目,包含已预装的vendor、.env、key等全部文件,【无需再执行php artisan key:generate】。
方法二:跳过全局安装,单次调用(适合不想改PATH的新手)
执行:
composer create-project laravel/laravel myapp --prefer-dist
注意末尾的 --prefer-dist 参数——它强制使用压缩包而非Git克隆,速度更快、失败率更低。项目名myapp可替换成任意英文名称,不能含空格或中文。
配置关键文件与密钥
进入项目目录:
cd myapp
复制环境配置模板:
copy .env.example .env(Windows)
cp .env.example .env(macOS/Linux)
生成应用密钥(仅当使用方法二创建项目时才需执行):
php artisan key:generate
这步会向.env文件写入APP_KEY值,用于加密session和cookie。如果跳过此步,访问页面会报“Application key not set”,且错误不可跳过。
启动服务并验证首页
第一步:赋予storage和bootstrap/cache写权限
Windows用户直接忽略此步;macOS/Linux用户执行:
chmod -R 755 storage bootstrap/cache
第二步:启动内置服务器
php artisan serve
终端将输出类似:
Starting Laravel development server: http://127.0.0.1:8000
第三步:打开浏览器,访问 http://127.0.0.1:8000
看到紫色渐变背景、中央显示“Laravel”字样及“You’re all set.”提示,即表示安装成功。


















