Illuminate 是 Laravel 的数据库引擎，减去了 Laravel。它与 Laravel 中的 Eloquent ORM 捆绑在一起。如果您想使用 ORM 构建 PHP 应用程序并且不想使用 Laravel，那么本教程适合您。

在本教程中，我们将使用 PHP、Illuminate Database 和 Eloquent ORM 构建问答应用程序的后端。

项目依赖项

• PHP 5.5+
• MySQL
• 作曲家

应用功能

我们的应用程序将执行以下任务：

• 添加用户
• 添加问题
• 添加问题的答案
• 对答案投赞成票
• 获取问题及答案
• 获取所有问题以及提出问题的用户
• 获取特定问题、答案和点赞
• 统计特定用户的问题
• 更新用户的答案
• 删除问题

首先，让我们创建项目目录和结构。在本教程的其余部分中，我假设 eloquent 是我们的项目根目录名称。

在主项目目录中，我们将创建一个 app文件夹，然后在这个app文件夹中，我们将创建两个文件夹：模型和控制器。 在这张图中，我们的主项目文件夹名为eloquent。您应该将其替换为您喜欢的任何名称。

安装 Eloquent 库

接下来，让我们为我们的项目安装依赖项。在主项目文件夹中，我们创建 eloquent/composer.json 文件。创建后，将以下代码粘贴到我们的 eloquent/composer.json 文件中。

{
 "name": "illuminate-example/eloquent",
 "description": "Implementation of Database Queries with illuminate and Eloquent",
 "type": "project",
 "require": {}
}

要安装 Illuminate 数据库库，我们需要将 “Illuminate/database”: “^7.30”, 添加到我们的 eloquent/composer.json强>文件。

接下来，让我们为我们的模型和控制器添加 PSR-4 自动加载：

"autoload": {
    "psr-4": {
        "Controllers": "app/controllers/",
        "Models": "app/models/" 
    }
}

现在，我们的 eloquent/composer.json 文件应如下所示：

{
    "name": "illuminate-example/eloquent",
    "description": "Implementation of Database Queries with illuminate and Eloquent",
    "type": "project",
    "require": {
        "illuminate/database": "^7.30"
    },
     "autoload": {
        "psr-4": {
             "Controllers": "app/controllers/",
             "Models": "app/models/"
        }
    }
}

最后，让我们在项目目录的根目录中运行以下两个命令。

$composer install
$composer dump-autoload -o

设置数据库表和配置文件

让我们为数据库凭据添加一个配置文件。在主项目目录中，我们创建一个名为 eloquent/config.php 的文件，并在 eloquent/config 中定义数据库详细信息。 php 文件，如以下代码片段所示。请注意，这些值应替换为您自己的连接详细信息。

<?php
defined('DBDRIVER') or define('DBDRIVER','mysql');
defined('DBHOST') or define('DBHOST','localhost');
defined('DBNAME') or define('DBNAME','eloquent-app');
defined('DBUSER') or define('DBUSER','root');
defined('DBPASS') or define('DBPASS','pass');
?>

接下来，让我们为我们的应用创建一个架构。

在为数据库中的表创建架构之前需要注意的一件事是，我们可以向架构添加时间戳。

如果我们想在特定表或模型上启用时间戳操作，Eloquent ORM 需要两个时间戳列。它们是 created_at 和 updated_at 列。如果我们为模型启用时间戳，Eloquent 会自动使用我们创建或更新记录的时间更新这些字段。

第三列名为 deleted_at。不过， deleted_at 时间戳的工作方式有所不同。 Eloquent 具有软删除功能，它使用 deleted_at 列来确定记录是否已被删除。如果您使用 eloquent delete 函数删除一条记录并启用软删除，则该列将根据删除时间进行更新。这些删除的项目可以随时检索。

在此应用中，我们将利用时间戳，因此我们将在架构创建中使用所有三个时间戳。

让我们在 MySQL 中使用以下命令创建表。

问题

让我们使用以下 SQL 语句在数据库中创建 questions 表。

CREATE TABLE `questions` (
 `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
 `question` tinytext,
 `user_id` int(11) DEFAULT NULL,
 `created_at` timestamp NULL DEFAULT NULL,
 `updated_at` timestamp NULL DEFAULT NULL,
 `deleted_at` timestamp NULL DEFAULT NULL,
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

答案

让我们使用以下 SQL 语句在数据库中创建 answers 表。

CREATE TABLE `answers` (
 `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
 `answer` tinytext,
 `user_id` int(11) DEFAULT NULL,
 `question_id` int(11) DEFAULT NULL,
 `created_at` timestamp NULL DEFAULT NULL,
 `updated_at` timestamp NULL DEFAULT NULL,
 `deleted_at` timestamp NULL DEFAULT NULL,
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

投票

让我们使用以下 SQL 语句在数据库中创建 upvotes 表。

CREATE TABLE `upvotes` (
 `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
 `answer_id` int(11) DEFAULT NULL,
 `user_id` int(11) DEFAULT NULL,
 `created_at` timestamp NULL DEFAULT NULL,
 `updated_at` timestamp NULL DEFAULT NULL,
 `deleted_at` timestamp NULL DEFAULT NULL,
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

用户

让我们使用以下 SQL 语句在数据库中创建 users 表。

CREATE TABLE `users` (
 `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
 `username` varchar(100) DEFAULT NULL,
 `email` varchar(200) DEFAULT NULL,
 `password` varchar(200) DEFAULT NULL,
 `created_at` timestamp NULL DEFAULT NULL,
 `updated_at` timestamp NULL DEFAULT NULL,
 `deleted_at` timestamp NULL DEFAULT NULL,
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

现在我们已经完成了数据库设置。接下来，我们将创建应用程序所需的模型文件。

设置 Eloquent 模型

首先，我们需要创建一个通用的Database类，用于设置数据库连接。

数据库 类

使用您喜欢的文本编辑器创建 eloquent/app/models/database.php 文件并添加以下内容。

<?php
namespace Models; 

use IlluminateDatabaseCapsuleManager as Capsule;
 
class Database {
    public function __construct() 
    {
        $capsule = new Capsule;
        $capsule->addConnection([
             'driver' => DBDRIVER,
             'host' => DBHOST,
             'database' => DBNAME,
             'username' => DBUSER,
             'password' => DBPASS,
             'charset' => 'utf8',
             'collation' => 'utf8_unicode_ci',
             'prefix' => '',
        ]);

        // Setup the Eloquent ORM… 
        $capsule->bootEloquent();
    }
}

在上面的文件中，我们初始化了 Capsule 类。接下来，我们使用 addConnection 方法创建一个新的 MySQL 连接。最后，我们使用 bootEloquent 方法来初始化 Eloquent 模型。

User 模型

让我们创建包含以下内容的 eloquent/app/models/User.php 文件。

<?php
namespace Models;

use IlluminateDatabaseEloquentModel;
 
class User extends Model {
    protected $table = 'users';
    protected $fillable = ['username', 'email', 'password'];
}
?>

问题模型

让我们创建包含以下内容的 eloquent/app/models/Question.php 文件。

<?php
namespace Models;
 
use IlluminateDatabaseEloquentModel;
 
class Question extends Model {
    protected $table = 'questions';
    protected $fillable = ['question','user_id'];
}
?>

Answer 模型

让我们创建包含以下内容的 eloquent/app/models/Answer.php 文件。

<?php
namespace Models;
use IlluminateDatabaseEloquentModel;
 
class Answer extends Model {
    protected $table = 'answers';
    protected $fillable = ['answer','user_id','question_id'];
}
?>

Upvote 模型

让我们创建包含以下内容的 eloquent/app/models/Upvote.php 文件。

<?php 
namespace Models;
 
use IlluminateDatabaseEloquentModel;
 
class Upvote extends Model {
    protected $table = 'upvotes';
    protected $fillable = ['answer_id', 'user_id'];
      
}
?>

这就是设置模型类的过程。

创建前端控制器文件

在本节中，我们将创建核心引导程序和前端控制器文件。

bootstrap.php 文件

这是一个通用文件，用于引导我们的应用程序。让我们在应用程序的根目录中创建 bootstrap.php 文件。

<?php
require './config.php';
require './vendor/autoload.php';

use ModelsDatabase;

// initialize Illuminate database connection
new Database();
?>

我们还通过实例化 Database 类来设置数据库连接。

index.php 文件

这是我们应用程序的前端控制器，因此基本上它是我们应用程序的入口点。

让我们在应用程序的根目录中创建 index.php 文件。

<?php
require 'bootstrap.php';

// our example code goes here...
?>

事实上，我们将使用 index.php 文件来测试本文其余部分中的所有用例。

现在，我们也建立了模型。从下一节开始，我们将开始测试我们的用例。

任务 1：添加用户

首先，让我们创建包含以下内容的 eloquent/app/controllers/Users.php 控制器文件。

<?php
namespace Controllers;
use ModelsUser;
 
class Users {
    public static function create_user($username, $email, $password)
    {
        $user = User::create(['username'=>$username,'email'=>$email,'password'=>$password]);
        return $user;
    }
}
?>

在我们的 Users 控制器类中，我们创建了 create_user 方法，该方法用于创建新用户。我们使用 Eloquent 模型的 create 方法来创建一个新用户。

让我们从 index.php 文件中调用它来测试它，如以下代码片段所示。请确保在实际存储密码之前对密码进行严格加密。永远不建议在数据库中存储纯文本密码。

<?php
require 'bootstrap.php';

use ControllersUsers; 
 
$user = Users::create_user("user1", "user1@example.com", "user1_pass");
?>

运行index.php文件后，它应该在users表中创建一个新用户。

任务 2：添加问题

首先，让我们创建包含以下内容的 eloquent/app/controllers/Questions.php 控制器文件。

<?php
namespace Controllers;
use ModelsQuestion;
 
class Questions{
    public static function create_question($question,$user_id)
    {
        $question = Question::create(['question'=>$question,'user_id'=>$user_id]);
        return $question;
    }
}
?>

在我们的 Questions 控制器类中，我们创建了 create_question 方法，该方法用于创建新问题。我们使用 Eloquent 模型的 create 方法来创建一个新问题。

让我们从 index.php 文件中调用它来测试它，如以下代码片段所示。

<?php
require 'bootstrap.php';

use ControllersQuestions; 
 
$question = Questions::create_question("Have you ever met your doppelganger?", 1);
?>

运行 index.php 文件后，它应该在 questions 表中创建一个新问题。

任务 3：添加问题答案

在本部分中，我们将了解如何添加问题的答案。

首先，让我们创建包含以下内容的 eloquent/app/controllers/Answers.php 控制器文件。

<?php
namespace Controllers;
use ModelsAnswer;
 
class Answers {
     public static function add_answer($answer,$question_id,$user_id)
     {
        $answer = Answer::create(['answer'=>$answer,'question_id'=>$question_id,'user_id'=>$user_id]);
        return $answer;
    }
}
?>

在我们的 Answers 控制器类中，我们创建了 add_answer 方法，该方法用于创建新答案。

让我们从 index.php 文件中调用它来测试它，如以下代码片段所示。

<?php
require 'bootstrap.php';

use ControllersAnswers; 
 
$answers = Answers::add_answer("This is an answer", 1, 2);
?>

运行 index.php 文件后，它应该在 answers 表中创建一个新答案。

任务 4：对答案进行投票

这些步骤与我们之前执行的步骤几乎相同。

让我们在 eloquent/app/controllers/Answers.php 控制器中添加以下方法。

...
...
public static function upvote_answer($answer_id,$user_id)
{
    $upvote = Upvote::create(['answer_id'=>$answer_id,'user_id'=>$user_id]);
    return $upvote;
}
...
...

您还需要通过添加以下代码在 eloquent/app/controllers/Answers.php 控制器文件中导入 Upvote 模型。

use ModelsUpvote;

最后，我们从 index.php 文件中调用它来测试它，如以下代码片段所示。

<?php
require 'bootstrap.php';

use ControllersAnswers; 
 
$upvote = Answers::upvote_answer(1, 14);
?>

任务 5：获取问题及答案

对于这样的任务，我们可以使用 Eloquent 关系。

关系类型包括一对一、一对多、多对多等。

使用这些关系时，Eloquent 假定模型上存在 modelname_id 形式的外键。对于此任务，关系是一对多关系，因为单个问题可以拥有任意数量的答案。

首先，让我们通过将以下函数添加到我们的 Question 模型来定义这种关系。

...
...
public function answers()
{
    return $this->hasMany('ModelsAnswer');
}
...
...

之后，在 eloquent/app/controllers/Questions.php 控制器文件中，添加以下函数来获取带有答案的问题。

...
...
public static function get_questions_with_answers()
{
    $questions = Question::with('answers')->get()->toArray();
    return $questions;
}
...
...

它检索问题及其相应的答案。

让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';
use ControllersQuestions; 
 
$all = Questions::get_questions_with_answers();
?>

您可以使用 var_dump 或 print_r 函数打印 $all 变量以查看结果。

任务 6：获取所有问题以及提出问题的用户

这将是一对一的关系，因为一个问题有一个用户，所以让我们将以下方法添加到 Question 模型中。

...
...
public function user()
{
    return $this->belongsTo('ModelsUser');
}
...
...

之后，在 eloquent/app/controllers/Questions.php 控制器文件中，添加以下函数。

...
...
public static function get_questions_with_users()
{ 
    $questions = Question::with('user')->get()->toArray();
    return $questions; 
}
...
...

让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';
use ControllersQuestions; 
 
$all_with_users = Questions::get_questions_with_users();
?>

任务 7：获得一个问题并附上答案和点赞

首先，我们定义答案和点赞之间的关系。一个答案有很多赞成票，因此关系是一对多。

让我们将以下函数添加到我们的 Answer 模型中：

...
...
public function upvotes()
{
    return $this->hasMany('ModelsUpvote');
}
...
...

在 eloquent/app/controllers/Questions.php 控制器文件中，我们创建以下函数。

...
...
public static function get_question_answers_upvotes($question_id)
{ 
    $questions = Question::find($question_id)->answers()->with('upvotes')->get()->toArray();
    return $questions;
}
...
...

让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';

use ControllersQuestions; 

$one_question = Questions::get_question_answers_upvotes(1);
?>

我们可以打印 $one_question 变量来查看结果。

任务 8：统计特定用户的所有问题

首先，我们在 eloquent/app/controllers/Users.php 控制器中导入 Question 模型：

use ModelsQuestion;

导入后，我们在同一个文件中添加以下函数。

...
...
public static function question_count($user_id)
{
    $count = Question::where('user_id', $user_id)->count();
    return $count;
}
...
...

最后，让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';
use ControllersUsers; 
 
$user_question_count = Users::question_count(1);
?>

它返回 ID 为 1 的用户添加的问题数。

任务 9：更新用户的答案

使用 Eloquent ORM 进行更新的概念非常简单。首先我们找到一条记录，然后我们变异并保存。

在 eloquent/app/controllers/Answers.php 控制器中，我们添加以下函数：

...
...
public static function update_answer($answer_id,$new_answer)
{
    $answer = Answer::find($answer_id);
    $answer->answer = $new_answer;
    $updated = $answer->save();
    return $updated;
}
...
...

最后，让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';
use ControllersAnswers; 
 
$update_answer = Answers::update_answer(1, "This is an updated answer");
?>

如果更新成功，则返回一个布尔值 - true。

任务 10：删除问题（软删除）

最后，我们将实现 Eloquent SoftDelete 功能。

首先，让我们使用以下语句在 Question 模型中导入 IlluminateDatabaseEloquentSoftDeletes 特征。

use IlluminateDatabaseEloquentSoftDeletes;

导入后我们就可以这样使用了。

use SoftDeletes;

最后，让我们将 deleted_at 添加到模型的 受保护的 $dates 属性中。这些是必需的步骤。

protected $dates = ['deleted_at'];

我们的问题模型现在看起来像这样：

<?php
namespace Models;
 
use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentSoftDeletes;
 
class Question extends Model {
    use SoftDeletes;

    protected $table = 'questions';
    protected $fillable = ['question','user_id'];
    protected $dates = ['deleted_at'];

    public function answers()
    {
        return $this->hasMany('ModelsAnswer');
    }

    public function user()
    {
        return $this->belongsTo('ModelsUser');
    }
}
?>

接下来，继续在 eloquent/app/controllers/Questions.php 控制器中创建 delete_question 方法。

...
...
public static function delete_question($question_id)
{
    $question = Question::find($question_id);
    $deleted = $question->delete();
    return $deleted; 
}
...
...

最后，让我们使用 index.php 文件对其进行测试，如以下代码片段所示。

<?php
require 'bootstrap.php';
use ControllersQuestions; 
 
$delete = Questions::delete_question(1);
?>

恭喜！您刚刚使用 Illuminate 和 Eloquent 构建了一个功能齐全的后端。而且我们不需要编写那么多代码来实现这一切。

结论

Illuminate 还附带查询生成器，您可以使用它进行更复杂的数据库查询，并且绝对是您想要在应用程序中试验和使用的东西。

独立的 Illuminate 数据库中唯一缺少的是数据库迁移，这是 Laravel 的一个可爱功能，以及 Laravel 的微框架 Lumen。您应该考虑在您的应用中同时使用这两者，以利用它们附带的有用功能。

您可以在官方 Eloquent 文档页面上找到有关 Eloquent 的更多信息。

参考文献

• GitHub 上的 Illuminate 数据库
• 雄辩的 ORM 文档

本文已根据 Sajal Soni 的贡献进行了更新。 Sajal 来自印度，他喜欢花时间创建基于开源框架的网站。