exiguous ecommerce

？ exiguous ecommerce

exiguous ecommerce是一个超级简单的电子商务库，它使用平面文件并采用非常简约的方法。

安装

只需运行以下 Composer 命令即可下载/安装exiguous ecommerce并创建相关的自动加载文件。

 composer require divineomega/exiguous-ecommerce

如果您的框架尚未这样做，则必须将require_once "vendor/autoload.php"添加到您希望使用exiguous ecommerce的任何文件中。

配置

exiguous ecommerce将其所有数据存储在data目录中。该包中提供了一个示例data目录。

在使用之前，您应该将data目录复制到另一个位置，然后将该位置指定为您的项目环境。如果您使用 Laravel，可以通过在.env文件中设置EXIGUOUS_ECOMMERCE_DATA_DIRECTORY变量来完成此操作，如下所示。

 EXIGUOUS_ECOMMERCE_DATA_DIRECTORY=/var/www/ecommerce-site/path-to-data-directory/

如果您没有使用支持此功能的框架，则可以使用标准 PHP 函数putenv来设置此环境变量。或者，您可以使用 dotenv-loader 向项目添加.env文件支持。

请注意，重要的是EXIGUOUS_ECOMMERCE_DATA_DIRECTORY变量设置时带有尾部斜杠。

出于安全原因，您应该将data目录放置在无法通过 Web 访问的位置。如果数据目录意外放置在可通过 Web 访问的位置，则会提供一个.htaccess文件，该文件应拒绝 Web 用户在最常见的 Web 服务器配置中访问该目录的内容。

快速入门示例

获取产品和类别：

 $ category =  DivineOmega  ExiguousEcommerce Category:: findBySlug ( " fluffy-things " );
$ products = $ category -> products ();

foreach ( $ products as $ product ) {
    echo $ product -> data -> name ;
}

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );
$ categories = $ product -> categories ();

$ mainCategoryName = $ categories [ 0 ]-> data -> name ;

获取当前用户的购物篮并向其中添加产品：

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> addProduct ( $ product ); // Add one Teddy Bear

$ basket -> addProduct ( $ product , 2 ); // Add another two Teddy Bears!

var_dump ( $ basket -> items ); // Outputs an array of, you guessed it, basket items! ^_^

// ^ This would show 1 basket item with a quantity of 3 teddy bears.

从购物篮中取出产品：

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> removeProduct ( $ product ); // Removes all teddy bears from the basket

设置/抵消购物篮中产品的数量：

 $ product =  DivineOmega  ExiguousEcommerce Product:: findBySlug ( " teddy-bear " );

$ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> addProduct ( $ product ); // Add one Teddy Bear

$ basket -> setProductQuantity ( $ product , 10 ); // Set the number of Teddy Bears in the basket to ten

$ basket -> offsetProductQuantity ( $ product , 10 ); // Add ten more Teddy Bears

$ basket -> offsetProductQuantity ( $ product , - 5 ); // Remove five of those Teddy Bears

将购物篮迁移到订单：

 $ basket =  DivineOmega  ExiguousEcommerce Basket:: findCurrent ();

$ basket -> convertToOrder ();

获取和使用设置：

 // Retrieves settings from the core.json file within the .settings directory
$ coreSettings =  DivineOmega  ExiguousEcommerce Settings:: find ( ' core ' );

echo $ coreSettings -> data -> primaryCurrency ; // Output the ecommerce's primary currency setting