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

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

在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()

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

Live PPT

一款AI智能化生成演示内容的在线工具。只需输入一句话、粘贴一段内容、或者导入文件，AI生成高质量PPT。

下载

所以，安全处理

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

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

use App\Models\Product;

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

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

可以看到，

where()

orderBy()

latest()

oldest()

first()

关键在于，

first()

where

orderBy

where

orderBy

first()