使用 Tinker 来调试 Laravel 应用程序的数据以及使用 Tinker 一些总结

今天我们将讨论如何使用Laravel的一些鲜为人知的功能来快速读取Laravel应用程序中的数据。我们可以使用Laravel的手工内置php artisan tinker工具来处理数据库中的应用程序和事物。

Laravel artisan的tinker程序是一个 REPL (read-eval-print-loop)。repl翻译为read-eval-print-loop(交互式命令行界面)，它是一个交互式语言shell。它可以让你输入一段代码去执行，并把执行结果直接打印到命令行界面里。

快速简便的方式查看数据库中的数据

输入下面命令行，可以直接看到结果

// see the count of all users
App\User::count();

// find a specific user and see their attributes
App\User::where('username', 'samuel')->first();

// find the relationships of a user
$user = App\User::with('posts')->first();
$user->posts;

使用php artisan tinker，我们可以很快做到这点。Tinker是Laravel自带的repl，基于PsySH。它使我们能够与我们的应用程序进行交互，dd()并die()停下来。我们中的很多人都知道当我们的代码中存在print_r()和dd()时发生的痛苦。

在使用Tinker之前，我们先创建一个演示项目。我们称之为ScotchTest。如果您的计算机上安装了laravel安装程序，请运行此命令。

laravel new ScotchTest

对于那些在他们的计算机上没有Laravel安装程序的人，可以使用composer来创建一个新的Laravel项目。

composer create-project laravel/laravel ScotchTest --prefer-dist
或者指定laravel版本
composer create-project laravel/laravel=5.3 ScotchTest --prefer-dist

1. 数据库设置：运行迁移

安装我们的演示Laravel项目后，我们需要创建一个数据库并设置迁移。对于本文我们将使用默认的Laravel迁移。因此我们将.env文件配置为指向您为此测试创建的数据库。默认迁移包括创建一个users表和一个password_resets表。

php artisan migrate

迁移我们的数据库后，我们应该看到类似的信息

2. 填充我们的数据库

默认情况下，Laravel提供了一个模型工厂model factory我们可以使用它来为我们的数据库创建种子。

现在让我们开始使用Tinker。

php artisan tinker

这条命令会打开一个 REPL 窗口供我们使用。刚才我们已经执行过 migration, 现在我们可以直接在 REPL 中使用模型工厂来填充数据。

factory(App\User::class, 10)->create();

十个新用户的集合应显示在您的终端上。然后我们可以检查数据库以查看用户是否真正创建。

App\User::all();

为了让我们的数据库中的用户总数，我们可以直接调用count的User模型。

App\User::count();

在执行完 App\User::all() 和 App\User::count()
之后，我的输出是这个样子的，你们的输出应该和我差不多，仅仅是生成的内容不同。

3. 创建一个新用户

通过 REPL，我们还可以创建一个新用户。你应该已经注意到，我们在 REPL 使用的命令跟我们在 laravel 中所写的代码是一样的。所以创建一个新用户的代码：

$user = new App\User;
$user->name = "imax";
$user->email = "imax@gmail.com";
$user->password = bcrypt("12345");
$user->save();

现在输入 $user，可以看到

4. 删除一个用户

要删除 id 为 1 的用户：

$user = App\User::find(1);
$user->delete();

5. 查阅某个类/方法的注释文档

通过 tinker，你可以在 REPL 中查看某个类/方法的注释文档。但是文档内容取决于这个类/方法是否有一个文档注释块（DocBlocks）。

doc <functionName> # replace <functionName> with function name or class FQN

比如，查阅 dd的注释文档

6. 查看源码

我们还可以在repl使用过程中检查一个函数或类的源代码

show <functionName>

例如，调用show在dd此给我们。

7. 总结

Laravel Tinker是一款工具，可以帮助我们轻松地与我们的应用程序进行交互，而无需启动本地服务器。想想你想从你的项目中删除的几行文字中测试一个简单的功能，只需要使用php artisan tinker就可以了。

8. 遇到的一些问题和解决办法

8.1 关于使用tinker使用中文报错的问题

如果你用的是Laravel的5.3的版本, 想要插入中文的测试数据,会发生如下的报错信息

解决办法

1.修改
~/www/laravel/vendor/fzaninotto/faker/src/Faker/Factory.php
的const DEFAULT_LOCALE = 'en_US';
改为const DEFAULT_LOCALE = 'zh_CN';

2.复制
~/www/laravel/vendor/fzaninotto/faker/src/Faker/Provider/en_US/Text.php

到zh_CN目录下

3.并把对应的命名空间的名称修改为namespace Faker\Provider\zh_CN;
4.我们重新执行php artisan tinker，用工厂模型创建10条数据看一下。

php artisan tinker

factory(App\User::class, 10)->create();

再次验证一下

$user = new App\User();
$user->name = "大熊猫";

8.2 关于windows`cmd`终端`Tinker`中文乱码的问题

# 将终端改成UTF8字符
先输入 CHCP 65001
然后打开【属性】，将字体改为【Lucida Console】

8.3 Tinker对于修改器仍然有效

    // 在User模型设置修改器
    public function setNameAttribute($value)
    {
        $this->attributes['name'] = strtolower($value);
    }

8.4 Tinker为后台添加管理员

一般后台管理平台，都是禁用掉注册功能的。
那怎么添加一个管理员账号呢。

参考步骤三其实就可以了。

不过除了使用bcrypt（）加密，
还可以使用Hash::mark()

$user->password = Hash::make('serct');

原文链接使用Tinker来调试Laravel应用程序的数据以及使用Tinker一些总结
参考资料[1] Tinker with the Data in Your Laravel Apps with Php Artisan Tinker
参考资料[2] 使用 Php Artisan Tinker 来调试你的 Laravel
参考资料[3] Laravel框架填充中文数据测试数据