exiguous ecommerce

? exiguous ecommerce

exiguous ecommerceは非常にシンプルな e コマース ライブラリであり、フラット ファイルを使用し、非常に最小限のアプローチを採用しています。

インストール

次の Composer コマンドを実行して、 exiguous ecommerceダウンロード/インストールし、関連する自動ロード ファイルを作成するだけです。

 composer require divineomega/exiguous-ecommerce

フレームワークがまだそうしていない場合は、 exiguous ecommerce使用するファイルにrequire_once "vendor/autoload.php"を追加する必要があります。

構成

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 アクセス可能な場所に誤って配置された場合に備えて、ほとんどの一般的な Web サーバー構成で Web ユーザーがディレクトリのコンテンツにアクセスすることを拒否する.htaccessファイルが提供されます。

クイックスタートの例

製品とカテゴリを取得する:

 $ 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