首先确认环境满足PHP>=8.1、已安装Composer,然后通过laravel new或composer create-project创建项目,最后用php artisan serve启动服务即可访问Laravel欢迎页面。

Laravel 是目前最流行的 PHP 框架之一,以优雅的语法和强大的功能著称。安装 Laravel 并不复杂,只要你的开发环境准备就绪,几分钟内就能完成。下面是一份详细的 Laravel 安装步骤图文教程,适合新手快速上手。
准备工作:检查系统环境
在安装 Laravel 之前,确保你的电脑满足以下基本条件:
- PHP >= 8.1(建议使用最新稳定版)
- Composer 工具已安装(PHP 的依赖管理工具)
- 支持的数据库(如 MySQL、SQLite 等)
- Web 服务器(如 Apache 或 Nginx,或直接使用 PHP 内置服务器)
打开终端或命令提示符,输入以下命令检查 PHP 和 Composer 是否可用:
php -vcomposer -v
如果看到版本信息,说明环境已配置好。
安装 Laravel 安装器(可选)
Laravel 提供了一个官方的全局安装器,可以更方便地创建新项目。
运行以下命令安装 Laravel 安装器:
composer global require laravel/installer安装完成后,就可以用 laravel new 命令创建项目。
方法一:使用 Laravel 安装器创建项目
执行以下命令创建一个名为 myproject 的 Laravel 应用:
laravel new myproject等待几分钟,Composer 会自动下载并配置所有依赖。完成后你会看到类似“Application ready!”的提示。
方法二:通过 Composer 创建项目(推荐)
如果你没有安装 Laravel 全局工具,可以直接用 Composer 创建项目:
composer create-project --prefer-dist laravel/laravel myproject这条命令会从 Packagist 下载最新稳定版 Laravel,并安装到 myproject 文件夹中。
启动开发服务器
进入项目目录:
cd myproject启动内置的 PHP 开发服务器:
php artisan serve看到如下输出表示启动成功:
Laravel development server started:打开浏览器,访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,你将看到 Laravel 的欢迎页面。
常见问题与解决
安装过程中可能会遇到一些问题,这里列出几个常见的:
- 报错:file_put_contents(): Permission denied —— 检查 storage 和 bootstrap/cache 目录权限,确保 Web 服务器有写入权限。
- Class 'Illuminate\Support\Facades\...' not found —— 运行 composer dump-autoload 重建自动加载文件。
- Mcrypt PHP extension required —— Laravel 9+ 不再需要 mcrypt,建议升级 PHP 版本并确认扩展正确安装。
配置 .env 文件(重要)
项目根目录下的 .env 文件是环境配置文件,用于设置数据库、缓存、邮件等参数。
例如,修改数据库连接:
DB_CONNECTION=mysqlDB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password
修改后无需重启服务,Laravel 会自动读取配置。
基本上就这些。按照以上步骤操作,你应该已经成功安装并运行了 Laravel 项目。后续可以学习路由、控制器、Eloquent 模型等核心功能,逐步构建自己的应用。










