确保系统满足 Laravel 环境要求:PHP >= 8.1 并安装必要扩展;2. 安装 composer 并验证版本;3. 使用 composer create-project 创建项目;4. 进入目录并运行 php artisan serve 启动服务;5. 配置 .env 文件并生成密钥;6. 执行迁移后访问 localhost:8000 查看欢迎页面完成安装。

想要顺利运行 laravel 项目,需要先正确搭建开发环境并完成安装。以下是详细的 Laravel 安装与环境搭建步骤,适合新手和中级开发者参考。
1. 环境准备:确保系统满足 Laravel 要求
Laravel 基于 PHP 开发,对 PHP 版本和扩展有明确要求。在开始前,请确认你的系统满足以下条件:
- PHP >= 8.1(推荐使用 PHP 8.1 或更高版本)
- Composer 已安装(PHP 的依赖管理工具)
- 支持的 数据库:mysql、postgresql、sqlite 或 SQL Server
- OpenSSL 扩展
- pdo 扩展
- MBstring 扩展
- Tokenizer 扩展
- xml 扩展
- Ctype 扩展
- jsON 扩展
你可以通过命令行运行 php -v 查看当前 PHP 版本,使用 php -m 查看已安装的扩展。
2. 安装 Composer
Composer 是 Laravel 安装的核心工具。如果尚未安装,请按以下方式操作:
- 访问 https://www.php.cn/link/febb75eccd1101d84a2aa5eb87859ce0 下载并安装 Composer
- windows 用户可下载安装程序,一键完成安装
- macos 用户推荐使用 Homebrew:brew install composer
- linux 用户可使用命令行脚本安装
安装完成后,运行 composer –version 验证是否成功。
3. 使用 Composer 创建 Laravel 项目
打开终端或命令行工具,执行以下命令创建新的 Laravel 项目:
composer create-project laravel/laravel your-project-name
其中 your-project-name 是你项目的文件夹名称。例如:
composer create-project laravel/laravel blog
该命令会自动下载 Laravel 最新稳定版本,并安装所有依赖包。
如果你希望使用特定版本的 Laravel,可以指定版本号:
composer create-project laravel/laravel:^9.0 blog
4. 配置本地开发服务器
Laravel 自带一个简单的开发服务器,适合本地测试。
- 进入项目目录:cd your-project-name
- 启动开发服务器:php artisan serve
默认情况下,项目将运行在 https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774。
你也可以使用更强大的本地环境工具,如:
- Laravel Sail:基于 docker,适合统一团队开发环境
- Laravel Valet(macOS):轻量级无配置开发环境
- XAMPP / WAMP / MAMP:传统本地服务器套件
5. 配置 .env 文件
项目根目录中的 .env 文件用于配置环境变量。首次安装后需设置数据库连接等信息。
- 复制 .env.example 为 .env:cp .env.example .env
- 生成应用密钥:php artisan key:generate
编辑 .env 文件中的数据库配置:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_db_username
DB_PASSword=your_db_password
保存后,Laravel 将使用这些信息连接数据库。
6. 运行迁移与测试项目
使用 Artisan 命令运行数据库迁移(如果有内置表结构):
php artisan migrate
访问 https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774,看到 Laravel 欢迎页面表示安装成功。
你可以继续使用 Artisan 命令创建控制器、模型、中间件 等:
php artisan make:controller PostController
基本上就这些。整个过程不复杂但容易忽略细节,比如 PHP 扩展缺失或 .env 配置错误。只要一步步来,Laravel 环境搭建很顺利。
以上就是 Laravel 安装步骤详细教程_Laravel 环境搭建指南的详细内容,更多请关注