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