0

0

在 Laravel 中实现最近浏览商品功能及常见问题解决

霞舞

霞舞

发布时间:2025-09-14 14:57:00

|

308人浏览过

|

来源于php中文网

原创

在 Laravel 中实现最近浏览商品功能及常见问题解决

本文详细介绍了如何在 Laravel 7+ 中利用 Cookie 实现“最近浏览商品”功能。教程涵盖了从商品数据存储、Cookie 管理(包括 JSON 编码/解码、去重、数量限制)到前端 Blade 模板展示的完整流程。特别强调了在操作 Cookie 时保持键名一致性的重要性,以避免常见的逻辑错误,并提供了完整的示例代码和实现细节。

1. 最近浏览商品功能概述

“最近浏览商品”功能是电商网站中常见的用户体验优化手段,它能够记录用户访问过的商品,并在后续访问中展示给用户,方便用户回溯和决策。在 laravel 应用中,利用 cookie 是实现这一功能的轻量级且有效的方式,尤其适用于非登录用户。

2. 后端逻辑实现:存储与管理 Cookie

核心逻辑位于控制器中,负责获取当前商品信息,更新 Cookie 中存储的最近浏览列表,并确保列表的唯一性和数量限制。

2.1 获取当前商品信息并初始化数据

首先,我们需要获取当前正在查看的商品的相关信息,例如 ID、标题和 URL。这些信息将作为单个浏览记录存储在 Cookie 中。

// app/Http/Controllers/ProductController.php

use Illuminate\Support\Facades\Cookie;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function show(Request $request, ProductMaterial $product_material)
    {
        // ... 其他业务逻辑,例如获取商品详情 ...

        $num_to_store = 5; // 设置Cookie中存储的最大商品数量
        $minutes_to_store = 60 * 24; // 设置Cookie的过期时间,例如24小时

        // 构建当前商品的详细信息
        $current_page = [
            'id'    => $product_material->id,
            'title' => $product_material->category->title . ' ' . $product_material->title, // 假设有分类标题
            'url'   => $request->url(),
        ];

        // ... 后续Cookie处理逻辑
    }
}

2.2 读取、更新与写入 Cookie

接下来是核心的 Cookie 处理逻辑。我们需要从 Cookie 中读取现有数据,解析 JSON,处理当前商品,然后重新编码并写入 Cookie。

// 承接上文 ProductController@show 方法

        // 关键点:使用正确的Cookie键名 'recently_viewed_content' 获取数据
        $recent = Cookie::get('recently_viewed_content');
        $recent = $recent ? json_decode($recent, true) : []; // 如果Cookie不存在或为空,则初始化为空数组

        // 遍历现有记录,如果当前商品已存在,则移除旧记录,确保唯一性
        foreach ($recent as $key => $val) {
            if ($val['url'] == $current_page['url']) {
                unset($recent[$key]);
            }
        }

        // 将当前商品添加到数组的末尾(最新浏览的商品)
        // 使用时间戳作为键可以方便地进行排序和识别
        $recent[time()] = $current_page;

        // 限制存储的商品数量
        // 如果数量超过预设值,则截取最新浏览的N个商品
        if (count($recent) > $num_to_store) {
            // array_slice 的第三个参数 true 保持数组的键名
            $recent = array_slice($recent, count($recent) - $num_to_store, $num_to_store, true);
        }

        // 将更新后的数组编码为JSON字符串,并加入到Cookie队列中
        Cookie::queue('recently_viewed_content', json_encode($recent), $minutes_to_store);

        // 为了在当前请求中立即使用,可以再次从Cookie中获取并解码
        // 确保获取的键名与设置的键名一致
        $recently_viewed_content = json_decode(Cookie::get('recently_viewed_content'), true);

        // ... 将 $recently_viewed_content 传递给视图
        return view('products.show', compact('product_material', 'recently_viewed_content'));

关键注意事项:

Symanto Text Insights
Symanto Text Insights

基于心理语言学分析的数据分析和用户洞察

下载
  • Cookie 键名一致性: 在 Cookie::get() 和 Cookie::queue() 中,务必使用完全相同的键名(例如 recently_viewed_content)。这是导致原始问题中只保存一个商品的核心原因。如果获取时使用了错误的键名,将始终获取到空值,导致每次都从头开始添加商品。
  • JSON 编码/解码: Cookie 只能存储字符串。因此,复杂的数据结构(如数组)需要通过 json_encode() 转换为字符串进行存储,并通过 json_decode() 解析回数组进行操作。
  • 去重逻辑: 在添加新商品前,遍历现有列表并移除重复项,确保每个商品只出现一次,并将其移动到最新浏览的位置。
  • 数量限制: 使用 array_slice() 配合 count() 可以有效地限制 Cookie 中存储的商品数量,避免 Cookie 过大。

3. 前端展示:Blade 模板

在 Blade 模板中,我们可以轻松地获取并展示最近浏览的商品列表。

{{-- resources/views/products/show.blade.php --}}

@if(isset($recently_viewed_content) && !empty($recently_viewed_content))
    

最近浏览

    @php // 对数组进行逆向排序,使最新浏览的商品显示在最前面 // krsort() 保持键名,按键名(此处为时间戳)降序排序 krsort($recently_viewed_content); @endphp @foreach($recently_viewed_content as $rvc)
  • {{ $rvc['title'] }}
  • @endforeach
@endif

注意事项:

  • 存在性检查: 在使用 $recently_viewed_content 之前,务必进行 isset() 和 !empty() 检查,以防止在 Cookie 不存在或为空时出现错误。
  • 排序: 使用 krsort() 可以根据存储时使用的时间戳键进行降序排序,从而使最近浏览的商品显示在列表顶部。

4. 总结

通过上述步骤,我们可以在 Laravel 应用中高效地实现“最近浏览商品”功能。核心在于后端控制器中对 Cookie 的正确管理,包括 JSON 数据的编码与解码、去重逻辑、数量限制,以及最重要的——在获取和设置 Cookie 时使用一致的键名。前端 Blade 模板则负责以用户友好的方式展示这些数据。对于需要更复杂功能(如跨设备同步、长期存储)的场景,可以考虑使用会话(Session)或数据库来替代 Cookie。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

313

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

270

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

362

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

362

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

80

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

62

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

62

2025.08.05

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

400

2023.08.07

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

10

2025.12.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 7.8万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号