你的第一个 Laravel 项目-Laravel(10.x)从入门到精通(一)

当前位置:　首页>> 技术小册>> Laravel(10.x)从入门到精通(一)

你的第一个 Laravel 项目

在Laravel的广阔世界中踏出第一步，意味着你将开启一段高效、优雅且充满可能性的Web开发之旅。Laravel，作为PHP界最受欢迎的现代框架之一，以其简洁的语法、强大的功能集和丰富的社区资源，赢得了全球开发者的青睐。本章将引导你从头开始，创建并运行你的第一个Laravel项目，让你亲身体验Laravel的魅力所在。

准备工作

在开始前，请确保你的开发环境已经准备好了以下基本条件：

PHP环境：Laravel要求PHP版本至少为7.3.0及以上（推荐使用PHP 8.x以获得最佳性能）。你可以通过PHP的官方网站下载安装包或使用包管理器（如Homebrew for macOS, apt for Ubuntu）进行安装。
Composer：Composer是PHP的依赖管理工具，Laravel项目依赖它来安装和管理第三方库。访问Composer官网下载并安装Composer。
数据库：Laravel支持多种数据库，但MySQL和PostgreSQL是最常用的两种。你需要安装并配置好至少一种数据库系统，并创建一个新的数据库供Laravel项目使用。
文本编辑器或IDE：选择你喜欢的代码编辑器或集成开发环境（IDE），如Visual Studio Code, Sublime Text, PhpStorm等，用于编写Laravel代码。
Git（可选）：虽然不是必需的，但使用Git进行版本控制是一个好习惯。如果你还没有安装Git，可以从Git官网下载并安装。

创建Laravel项目

一切准备就绪后，我们可以开始创建Laravel项目了。打开终端（或命令提示符），切换到你想存放项目的目录，然后运行以下命令来创建一个新的Laravel项目：

composer create-project --prefer-dist laravel/laravel your-project-name

将your-project-name替换为你希望的项目名称。这个命令会下载Laravel的安装包，并通过Composer安装所有必需的依赖项。这可能需要一些时间，具体取决于你的网络速度和Composer服务器的响应速度。

安装完成后，你会看到一个名为your-project-name的新目录，里面包含了Laravel项目的所有文件和目录。

项目结构概览

进入你的Laravel项目目录，你会看到一系列文件和目录，它们共同构成了Laravel项目的骨架。以下是一些关键文件和目录的简要说明：

app/：包含应用程序的核心代码，如控制器、模型、视图、服务等。
- Http/：处理Web请求的主要逻辑所在，包含控制器、中间件和路由文件。
- Models/：存储Eloquent ORM模型，用于与数据库交互。
bootstrap/：包含框架启动和自动加载配置文件。
config/：应用程序的配置文件。
database/：数据库迁移和种子文件，用于定义和填充数据库结构。
public/：Web服务器访问的入口点，包含前端资源（如CSS、JS、图片）和index.php文件。
resources/：包含视图文件、语言文件和资产（如Sass、Less文件）。
- views/：Blade模板文件，用于定义应用的HTML结构。
routes/：定义应用程序的路由，即URL到控制器动作的映射。
storage/：用于存储框架生成的文件，如缓存、日志和会话数据。
tests/：包含自动化测试代码。
vendor/：通过Composer安装的第三方库和框架本身的代码。
.env：环境配置文件，包含敏感信息，如数据库凭据、密钥等。
artisan：Laravel的命令行工具，用于执行各种开发任务，如数据库迁移、路由生成等。

配置数据库

在继续之前，你需要根据你的数据库配置修改.env文件。找到以下几行，并根据你的数据库设置进行相应的修改：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_username
DB_PASSWORD=your_database_password

将your_database_name、your_database_username和your_database_password替换为你的数据库名、用户名和密码。

运行Laravel项目

一切配置妥当后，你就可以运行你的Laravel项目了。在终端中，切换到你的项目目录，运行以下命令来启动Laravel内置的PHP开发服务器：

php artisan serve

默认情况下，Laravel开发服务器会在http://localhost:8000上启动。打开你的浏览器，访问这个地址，你应该会看到Laravel的欢迎页面，这标志着你的第一个Laravel项目已经成功运行了！

创建你的第一个路由和控制器

现在，让我们来创建你的第一个路由和控制器，以感受Laravel的MVC（模型-视图-控制器）架构的魅力。

创建路由：

打开routes/web.php文件，这是Laravel中定义Web路由的地方。在文件中添加以下路由定义：
```
Route::get('/hello', [HelloController::class, 'index']);
```
但在此之前，你还没有HelloController，所以我们需要先创建它。
创建控制器：

使用Artisan命令来创建一个新的控制器：
```
php artisan make:controller HelloController
```
这条命令会在app/Http/Controllers目录下创建一个名为HelloController.php的新文件。
定义控制器方法：

打开HelloController.php文件，并添加一个名为index的方法，该方法将返回一个简单的欢迎信息：
```
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class HelloController extends Controller
{
    public function index()
    {
        return 'Hello, Laravel!';
    }
}
```
注意，我们在这里直接返回了一个字符串。在实际开发中，你通常会返回一个视图或JSON响应。
测试你的路由：

回到浏览器，访问http://localhost:8000/hello。你应该会看到页面上显示了“Hello, Laravel!”的文本，这表明你的路由和控制器已经成功工作。

结语

恭喜你，你已经成功创建了你的第一个Laravel项目，并学会了如何配置数据库、运行项目、以及创建简单的路由和控制器。这只是Laravel强大功能的冰山一角，随着你深入学习，你将能够利用Laravel构建更复杂、更强大的Web应用程序。

在后续章节中，我们将继续探索Laravel的更多特性，包括Eloquent ORM、数据库迁移、中间件、认证系统、视图与Blade模板引擎、请求与响应处理、路由与控制器的高级用法等。准备好踏上这段激动人心的旅程吧！