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

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

### 你的第一个 Laravel 项目

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

#### 准备工作

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

1. **PHP环境**：Laravel要求PHP版本至少为7.3.0及以上（推荐使用PHP 8.x以获得最佳性能）。你可以通过PHP的官方网站下载安装包或使用包管理器（如Homebrew for macOS, apt for Ubuntu）进行安装。

2. **Composer**：Composer是PHP的依赖管理工具，Laravel项目依赖它来安装和管理第三方库。访问[Composer官网](https://getcomposer.org/)下载并安装Composer。

3. **数据库**：Laravel支持多种数据库，但MySQL和PostgreSQL是最常用的两种。你需要安装并配置好至少一种数据库系统，并创建一个新的数据库供Laravel项目使用。

4. **文本编辑器或IDE**：选择你喜欢的代码编辑器或集成开发环境（IDE），如Visual Studio Code, Sublime Text, PhpStorm等，用于编写Laravel代码。

5. **Git**（可选）：虽然不是必需的，但使用Git进行版本控制是一个好习惯。如果你还没有安装Git，可以从[Git官网](https://git-scm.com/)下载并安装。

#### 创建Laravel项目

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

```bash
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`文件。找到以下几行，并根据你的数据库设置进行相应的修改：

```plaintext
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开发服务器：

```bash
php artisan serve
```

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

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

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

1. **创建路由**：
   
   打开`routes/web.php`文件，这是Laravel中定义Web路由的地方。在文件中添加以下路由定义：

```php
   Route::get('/hello', [HelloController::class, 'index']);
   ```

但在此之前，你还没有`HelloController`，所以我们需要先创建它。

2. **创建控制器**：

使用Artisan命令来创建一个新的控制器：

```bash
   php artisan make:controller HelloController
   ```

这条命令会在`app/Http/Controllers`目录下创建一个名为`HelloController.php`的新文件。

3. **定义控制器方法**：

打开`HelloController.php`文件，并添加一个名为`index`的方法，该方法将返回一个简单的欢迎信息：

```php
   <?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HelloController extends Controller
   {
       public function index()
       {
           return 'Hello, Laravel!';
       }
   }
   ```

注意，我们在这里直接返回了一个字符串。在实际开发中，你通常会返回一个视图或JSON响应。

4. **测试你的路由**：

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

#### 结语

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

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

该分类下的相关小册推荐：

PHP高性能框架-Workerman

Swoole高性能框架-Hyperf

PHP8实战小册

Magento零基础到架构师(内容设计)

PHP8入门与项目实战（1）

Laravel(10.x)从入门到精通(十四)

Laravel(10.x)从入门到精通(十二)

ThinkPHP项目开发实战

Magento零基础到架构师(产品管理)

Swoole高性能框架-SwooleWorker

PHP8入门与项目实战（6）

PHP8入门与项目实战（4）