Shopping Cart Class

购物车类允许将项目添加到用户浏览您的网站时保持活动的会话。这些物品可以以标准的“购物车”格式检索和显示，允许用户更新数量或从购物车中移除物品。

重要

购物车图书馆已被拒绝，不应使用。目前仅保留用于向后兼容。

请注意，购物车类仅提供核心“购物车”功能。它不提供运输，信用卡授权或其他处理组件。

• 使用购物车类
  • 初始化购物车类
  • 将商品添加到购物车
  • 将多个项目添加到购物车
  • 显示购物车
  • 更新购物车
    • 什么是行ID？
• 类参考

使用购物车类

初始化购物车类

重要

Cart类使用CodeIgniter的会话类将购物车信息保存到数据库，因此在使用Cart类之前，您必须按照会话文档中的说明设置数据库表，并在您的application / config / config.php中设置会话首选项文件来利用数据库。

要在控制器构造函数中初始化购物车类，请使用以下$this->load->library()方法：

$this->load->library('cart');

加载后，Cart对象将可用：

$this->cart

注意

Cart类将自动加载和初始化会话类，因此除非您在应用程序的其他地方使用会话，否则不需要加载Session类。

将商品添加到购物车

要将商品添加到购物车，只需将包含商品信息的数组传递给$this->cart->insert()方法，如下所示：

$data = array(
        'id'      => 'sku_123ABC',
        'qty'     => 1,
        'price'   => 39.95,
        'name'    => 'T-Shirt',
        'options' => array('Size' => 'L', 'Color' => 'Red')
);

$this->cart->insert($data);

重要

上面的前四个数组索引（id，qty，price和name）是必需的。如果您忽略其中的任何一项，则数据将不会保存到购物车。第五个索引（选项）是可选的。它旨在用于您的产品具有与之相关联的选项的情况。如上所示，使用数组作为选项。

五个保留索引是：

• id - 商店中的每个产品都必须具有唯一标识符。通常这将是一个“SKU”或其他这样的标识符。
• 数量 - 正在购买的数量。
• 价格 - 物品的价格。
• 名称 - 项目的名称。
• 选项 - 识别产品所需的任何其他属性。这些必须通过数组传递。

除上述五个索引外，还有两个保留字：rowid和小计。这些由Cart类内部使用，因此请勿在将数据插入购物车时将这些词用作索引名称。

你的数组可能包含额外的数据。你在数组中包含的任何内容都将存储在会话中。但是，最好将所有产品中的数据标准化，以便使表格中的信息更容易显示。

$data = array(
        'id'      => 'sku_123ABC',
        'qty'     => 1,
        'price'   => 39.95,
        'name'    => 'T-Shirt',
        'coupon'         => 'XMAS-50OFF'
);

$this->cart->insert($data);

insert()如果您成功插入单个项目，该方法将返回$ rowid。

将多个项目添加到购物车

通过使用多维数组，如下所示，可以在一个动作中将多个产品添加到购物车。在希望允许用户从同一页面上的多个项目中进行选择的情况下，这非常有用。

$data = array(
        array(
                'id'      => 'sku_123ABC',
                'qty'     => 1,
                'price'   => 39.95,
                'name'    => 'T-Shirt',
                'options' => array('Size' => 'L', 'Color' => 'Red')
        ),
        array(
                'id'      => 'sku_567ZYX',
                'qty'     => 1,
                'price'   => 9.95,
                'name'    => 'Coffee Mug'
        ),
        array(
                'id'      => 'sku_965QRS',
                'qty'     => 1,
                'price'   => 29.95,
                'name'    => 'Shot Glass'
        )
);

$this->cart->insert($data);

显示cart

要显示购cart，您将创建一个代码类似于下面显示的代码的视图文件。

请注意，这个例子使用了表单助手。

<?php echo form_open('path/to/controller/update/method'); ?>

<table cellpadding="6" cellspacing="1" style="width:100%" border="0">

<tr>
        <th>QTY</th>
        <th>Item Description</th>
        <th style="text-align:right">Item Price</th>
        <th style="text-align:right">Sub-Total</th>
</tr>

<?php $i = 1; ?>

<?php foreach ($this->cart->contents() as $items): ?>

        <?php echo form_hidden($i.'[rowid]', $items['rowid']); ?>

        <tr>
                <td><?php echo form_input(array('name' => $i.'[qty]', 'value' => $items['qty'], 'maxlength' => '3', 'size' => '5')); ?></td>
                <td>
                        <?php echo $items['name']; ?>

                        <?php if ($this->cart->has_options($items['rowid']) == TRUE): ?>

                                <p>
                                        <?php foreach ($this->cart->product_options($items['rowid']) as $option_name => $option_value): ?>

                                                <strong><?php echo $option_name; ?>:</strong> <?php echo $option_value; ?><br />

                                        <?php endforeach; ?>
                                </p>

                        <?php endif; ?>

                </td>
                <td style="text-align:right"><?php echo $this->cart->format_number($items['price']); ?></td>
                <td style="text-align:right">$<?php echo $this->cart->format_number($items['subtotal']); ?></td>
        </tr>

<?php $i++; ?>

<?php endforeach; ?>

<tr>
        <td colspan="2"> </td>
        <td class="right"><strong>Total</strong></td>
        <td class="right">$<?php echo $this->cart->format_number($this->cart->total()); ?></td>
</tr>

</table>

<p><?php echo form_submit('', 'Update your Cart'); ?></p>

更新cart

要更新cart中的信息，您必须将包含行ID和一个或多个预定义属性的数组传递给$this->cart->update()方法。

注意

如果数量设置为零，则该物品将从购物车中移除。

$data = array(
        'rowid' => 'b99ccdf16028f015540f341130b6d8ec',
        'qty'   => 3
);

$this->cart->update($data);

// Or a multi-dimensional array

$data = array(
        array(
                'rowid'   => 'b99ccdf16028f015540f341130b6d8ec',
                'qty'     => 3
        ),
        array(
                'rowid'   => 'xw82g9q3r495893iajdh473990rikw23',
                'qty'     => 4
        ),
        array(
                'rowid'   => 'fh4kdkkkaoe30njgoe92rkdkkobec333',
                'qty'     => 2
        )
);

$this->cart->update($data);

您也可以在插入项目时更新您之前定义的任何属性，例如选项，价格或其他自定义字段。

$data = array(
        'rowid'  => 'b99ccdf16028f015540f341130b6d8ec',
        'qty'    => 1,
        'price'  => 49.95,
        'coupon' => NULL
);

$this->cart->update($data);

什么是行ID？

行ID是在将商品添加到购物车时由购物车代码生成的唯一标识符。创建唯一ID的原因是，可以通过购物车管理具有不同选项的相同产品。

例如，假设有人购买两个相同的T恤（相同的产品ID），但尺寸不同。产品ID（和其他属性）对于两种尺寸都是相同的，因为它们是同一件衬衫。唯一的区别是尺寸。因此，购物车必须具有识别这种差异的手段，以便两种尺寸的衬衫可以独立管理。它通过创建基于产品ID和与其关联的任何选项的唯一“行ID”来实现。

在几乎所有情况下，更新购物车都是用户通过“查看购物车”页面所做的事情，因此对于开发者来说，您不可能永远不必关心“行ID”，除非确保您的“查看购物车”页面在隐藏表单域中包含此信息，并确保update()在提交更新表单时将其传递给方法。请检查上面的“查看购物车”页面的结构以获取更多信息。

类参考

class CI_Cart$product_id_rules = '.a-z0-9_-'

这些是我们用来验证产品ID的正则表达式规则 - 默认情况下是字母数字，短划线，下划线或句点

$product_name_rules = 'w -.:'

这些是我们用来验证产品ID和产品名称的正则表达式规则 - 默认情况下是字母数字，破折号，下划线，冒号或句点

$product_name_safe = TRUE

是否仅允许安全的产品名称。默认为TRUE。

insert([$items = array()])

参数：	$ items（array） - 要插入购物车的项目
返回：	成功为TRUE，失败为FALSE
返回类型：	布尔

• $ items（array） - 要插入购物车的项目

Returns:  TRUE on success, FALSE on failure

Return type:  bool

Insert items into the cart and save it to the session table. Returns TRUE on success and FALSE on failure.

update([$items = array()])

参数：	$ items（array） - 要在购物车中更新的项目
返回：	成功为TRUE，失败为FALSE
返回类型：	布尔

• $ items（array） - 要在购物车中更新的项目

Returns:  TRUE on success, FALSE on failure

Return type:  bool

此方法允许更改给定项目的属性。通常情况下，如果用户在结帐前更改数量，则会从“查看购物车”页面中调用。该数组必须包含每个项目的rowid。

remove($rowid)

参数：	$ rowid（int） - 要从购物车中移除的物品的ID
返回：	成功为TRUE，失败为FALSE
返回类型：	布尔

• $ rowid（int） - 要从购物车中移除的物品的ID

Returns:  TRUE on success, FALSE on failure

Return type:  bool

允许您通过传递`$ rowid`来从购物车中删除商品。

total()

返回：	总金额
返回类型：	INT

total_items()

返回：	购物车中的物品总量
返回类型：	INT

contents([$newest_first = FALSE])

参数：	$ newest_first（bool） - 是否先用最新的项目排列数组
返回：	购物车内容的数组
返回类型：	排列

• $ newest_first（bool） - 是否先用最新的项目排列数组

Returns:  An array of cart contents

Return type:  array

返回包含购物车中所有内容的数组。您可以通过传递数组来排序返回数组的顺序TRUE将内容从最新到最旧排序，否则将从最旧到最新排序。

get_item($row_id)

参数：	$ row_id（int） - 要检索的行ID
返回：	项目数据的数组
返回类型：	排列

• $ row_id（int） - 要检索的行ID

Returns:  Array of item data

Return type:  array

返回包含与指定行ID匹配的项的数据的数组，如果不存在此类项，则返回FALSE。

has_options($row_id = '')

参数：	$ row_id（int） - 要检查的行ID
返回：	如果选项存在则为TRUE，否则为FALSE
返回类型：	布尔

• $ row_id（int） - 要检查的行ID

Returns:  TRUE if options exist, FALSE otherwise

Return type:  bool

如果购物车中的特定行包含选项，则返回TRUE（布尔值）。这个方法被设计成在`content（）`循环中使用，因为你必须将rowid传递给这个方法，如上面的显示购物车示例所示。

product_options([$row_id = ''])

参数：	$ row_id（int） - 行ID
返回：	一系列产品选项
返回类型：	排列

• $row_id (int) – Row ID

返回：产品选项数组

Return type:  array

Returns an array of options for a particular product. This method is designed to be used in a loop with `contents()`, since you must pass the rowid to this method, as shown in the Displaying the Cart example above.

destroy()

Return type:	void