Laravel模型第一记录？第一条数据如何获取？-Laravel-PHP中文网

答案：在Laravel中，first()用于获取查询结果的第一条记录，若无排序则默认按主键升序；oldest()则按created_at升序获取最早记录，适合时间维度查询；两者均返回null或抛出异常（firstOrFail）处理空结果，实际使用中可结合where和orderBy实现精确查询。

laravel模型第一记录？第一条数据如何获取？

在Laravel中，想要获取模型的第一条记录，最直接且常用的方法就是使用

first()

登录后复制

。它会从查询结果集中取出第一条数据，如果没有任何记录符合条件，则返回

null

登录后复制

。此外，如果你想获取最早创建的记录，

oldest()

登录后复制

方法也是一个非常实用的选择，它会根据

created_at

登录后复制

字段进行排序。

解决方案

获取Laravel模型的第一条记录，通常我们会直接调用查询构建器或Eloquent模型上的

first()

登录后复制

方法。这个方法非常直观，它会执行查询并返回匹配条件的第一条记录的模型实例。

例如，如果你有一个

User

登录后复制

模型，想要获取数据库中的第一个用户：

use App\Models\User;

$firstUser = User::first();

if ($firstUser) {
    echo "第一位用户的名字是：" . $firstUser->name;
} else {
    echo "数据库中没有用户记录。";
}

登录后复制

这里需要注意一点，

first()

登录后复制

方法在没有显式指定排序条件时，其返回的“第一条”记录，通常是数据库默认的排序结果，在大多数情况下，这会是按照主键（

id

登录后复制

）升序排列的第一条。但如果你想确保获取的是最早创建的记录，那么

oldest()

登录后复制

方法就更明确了：

use App\Models\User;

$oldestUser = User::oldest()->first(); // 或者直接 User::oldest()

if ($oldestUser) {
    echo "最早创建的用户的名字是：" . $oldestUser->name;
} else {
    echo "数据库中没有用户记录。";
}

登录后复制

oldest()

登录后复制

方法实际上会在内部添加一个

orderBy('created_at', 'asc')

登录后复制

的排序条件，确保你拿到的是时间线上最早的数据。

Laravel中，

first()

登录后复制

方法和

oldest()

登录后复制

方法究竟有何不同？

这确实是很多初学者容易混淆的地方，甚至我刚开始用Laravel的时候也琢磨过一阵子。简单来说，它们的核心目的都是获取单条记录，但在“第一条”的定义上，有着微妙而重要的区别。

first()

登录后复制

方法，它会返回查询结果集中的第一个元素。重点来了，如果你的查询之前没有明确指定

orderBy

登录后复制

子句，那么

first()

登录后复制

通常会依赖数据库的默认排序。在MySQL这样的关系型数据库里，这往往意味着它会按照表的主键（通常是

id

登录后复制

字段）的升序来取第一条。但请记住，这并不是一个绝对的保证，因为数据库的默认行为可能因配置或表结构而异。所以，如果你对“第一条”的定义有明确的排序要求，最好是显式地加上

orderBy

登录后复制

。

举个例子：

// 假设User表有id, name, created_at字段
// 此时first()通常会按id升序取第一条
$userById = User::first();

// 如果你先按name降序，再取first()
$userByNameDesc = User::orderBy('name', 'desc')->first();

登录后复制

这里的

$userByNameDesc

登录后复制

就是按名字倒序排列后的第一条记录，而不是按

id

登录后复制

排序的。

而

oldest()

登录后复制

方法就明确多了，它的设计初衷就是为了获取“最老”的记录。它会在内部自动添加

orderBy('created_at', 'asc')

登录后复制

这个排序条件。所以，无论你之前有没有加其他的

orderBy

登录后复制

，只要你调用了

oldest()

登录后复制

，它就会以

created_at

登录后复制

字段的升序来确定“第一条”记录。这对于那些需要根据创建时间来判断数据顺序的场景，简直是量身定制。

// 这会明确地按created_at升序取第一条记录
$oldestUser = User::oldest()->first();
// 其实 User::oldest() 本身就返回一个Query Builder实例，
// 内部已经包含了 orderBy('created_at', 'asc')
// 所以直接 $oldestUser = User::oldest(); 也是可以的，它会自动调用 first()

登录后复制

所以，我的建议是：如果你只是想从一个无序或默认排序的集合中随便取一个，或者你已经通过

orderBy

登录后复制

明确了排序，那么用

first()

登录后复制

。但如果你明确知道你想要的是基于

created_at

登录后复制

字段的最早记录，那就毫不犹豫地用

oldest()

登录后复制

，它能让你的代码意图更清晰。

当数据库中没有记录时，

first()

登录后复制

方法会返回什么？又该如何安全处理？

这是一个非常实际的问题，在开发中我们经常会遇到。当

first()

登录后复制

方法执行查询，但数据库中没有任何符合条件的记录时，它会非常“礼貌”地返回

null

登录后复制

。这意味着你不会得到一个模型实例，而是一个空值。

如果不对此进行处理，直接尝试访问

null

登录后复制

的属性，比如

$user->name

登录后复制

，就会抛出

Attempt to read property "name" on null

登录后复制

这样的错误，导致程序崩溃。这在生产环境中是绝对不能接受的。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

所以，安全处理

null

登录后复制

返回值至关重要。最常见的做法就是在使用

first()

登录后复制

的返回值之前，先进行一个简单的

if

登录后复制

判断：

use App\Models\Product;

$product = Product::where('status', 'active')->first();

if ($product) {
    // 记录存在，可以安全地访问其属性
    echo "找到的第一个活跃产品是：" . $product->name;
} else {
    // 没有找到记录
    echo "没有找到任何活跃产品。";
}

登录后复制

这种方式清晰明了，也是我个人最推荐的日常处理方式。

不过，在某些特定场景下，你可能希望如果记录不存在，就直接抛出一个异常，而不是返回

null

登录后复制

。比如，你正在处理一个必须存在的资源，如果找不到就说明逻辑出了问题。这时候，

firstOrFail()

登录后复制

方法就派上用场了。

firstOrFail()

登录后复制

的工作方式与

first()

登录后复制

类似，但如果找不到任何记录，它不会返回

null

登录后复制

，而是会抛出一个

Illuminate\Database\Eloquent\ModelNotFoundException

登录后复制

异常。这个异常可以被Laravel的异常处理器捕获，通常会默认返回一个404 HTTP响应，非常适合RESTful API中资源未找到的场景。

use App\Models\User;
use Illuminate\Database\Eloquent\ModelNotFoundException;

try {
    $user = User::where('id', 999)->firstOrFail(); // 假设ID 999不存在
    echo "找到用户：" . $user->name;
} catch (ModelNotFoundException $e) {
    echo "抱歉，ID为999的用户未找到。";
    // 实际项目中，这里可能返回一个404响应，或者记录日志
}

登录后复制

使用

firstOrFail()

登录后复制

的好处在于，它将“记录不存在”的逻辑提升为异常处理，使得核心业务逻辑更加专注于“记录存在”的情况，代码会显得更简洁。当然，这要求你的应用有完善的异常捕获机制。

在实际项目中，如何结合条件查询和排序，精确获取我们想要的“第一条”记录？

在真实的业务场景中，我们很少会只是简单地获取“数据库中的第一条”记录。更多时候，我们需要的“第一条”是基于特定条件过滤后，再按照某种逻辑排序的那个。Laravel的查询构建器和Eloquent ORM在这方面提供了非常强大的链式调用能力，让我们可以非常灵活地组合各种条件。

比如说，我们想获取某个用户发布的最新的那篇文章。这里就涉及到两个关键点：一是“某个用户发布”，二是“最新的”。

use App\Models\Post;

$userId = 123; // 假设我们要找的用户ID

$latestPostByUser = Post::where('user_id', $userId) // 筛选条件：属于特定用户
                        ->latest()                  // 排序条件：按created_at降序（最新）
                        ->first();                  // 获取排序后的第一条

if ($latestPostByUser) {
    echo "用户ID {$userId} 最新发布的文章标题是：" . $latestPostByUser->title;
} else {
    echo "用户ID {$userId} 还没有发布任何文章。";
}

登录后复制

这里

latest()

登录后复制

方法是

orderBy('created_at', 'desc')

登录后复制

的一个便捷写法，它确保了我们拿到的是最新创建的记录。

再举一个例子，假设我们有一个

Product

登录后复制

模型，我们想找出库存量大于0，并且价格最低的那个产品。

use App\Models\Product;

$cheapestAvailableProduct = Product::where('stock', '>', 0) // 筛选条件：库存大于0
                                   ->orderBy('price', 'asc') // 排序条件：按价格升序
                                   ->first();                // 获取排序后的第一条

if ($cheapestAvailableProduct) {
    echo "价格最低的在库产品是：" . $cheapestAvailableProduct->name . "，价格：" . $cheapestAvailableProduct->price;
} else {
    echo "目前没有库存的商品。";
}

登录后复制

可以看到，