©
Ce document utilise Manuel du site Web PHP chinois Libérer
购物车类允许将项目添加到用户浏览您的网站时保持活动的会话。这些物品可以以标准的“购物车”格式检索和显示,允许用户更新数量或从购物车中移除物品。
重要
购物车图书馆已被拒绝,不应使用。目前仅保留用于向后兼容。
请注意,购物车类仅提供核心“购物车”功能。它不提供运输,信用卡授权或其他处理组件。
使用购物车类
什么是行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,您将创建一个代码类似于下面显示的代码的视图文件。
请注意,这个例子使用了表单助手。
<?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中的信息,您必须将包含行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的原因是,可以通过购物车管理具有不同选项的相同产品。
例如,假设有人购买两个相同的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 |
---|