PHPackages                             miladsarli/cartsystem - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. miladsarli/cartsystem

ActiveLibrary[Framework](/categories/framework)

miladsarli/cartsystem
=====================

یک سیستم سبد خرید انعطاف پذیر برای اپلیکیشن های لاراول

1.0.3(1y ago)15MITPHPPHP ^8.1

Since Apr 22Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Milad-Sarli/cartsystem)[ Packagist](https://packagist.org/packages/miladsarli/cartsystem)[ RSS](/packages/miladsarli-cartsystem/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (4)Used By (0)

MiladSarli Cart System
======================

[](#miladsarli-cart-system)

یک سیستم سبد خرید انعطاف پذیر برای اپلیکیشن های لاراول

نصب
---

[](#نصب)

برای نصب این پکیج با استفاده از Composer دستور زیر را اجرا کنید:

```
composer require miladsarli/cartsystem
```

پیکربندی
--------

[](#پیکربندی)

پس از نصب، دستور زیر را اجرا کنید تا فرآیند نصب به صورت خودکار انجام شود:

```
php artisan cart:install
```

این دستور به صورت خودکار:

1. فایل‌های کانفیگ را منتشر می‌کند
2. مایگریشن‌ها را کپی می‌کند
3. مدل‌ها را در پوشه `App\Models\Cart` کپی می‌کند
4. کنترلرها را در پوشه `App\Http\Controllers\Cart` کپی می‌کند
5. مسیرها را در پوشه `routes/cart` کپی می‌کند
6. مسیرها را به صورت خودکار در `routes/api.php` اضافه می‌کند

### نصب دستی فایل‌ها

[](#نصب-دستی-فایل‌ها)

اگر می‌خواهید فقط بخشی از فایل‌ها را نصب کنید، می‌توانید از دستورات زیر استفاده کنید:

```
# برای نصب فایل کانفیگ
php artisan vendor:publish --tag=cart-config

# برای نصب مایگریشن‌ها
php artisan vendor:publish --tag=cart-migrations

# برای نصب مدل‌ها
php artisan vendor:publish --tag=cart-models

# برای نصب کنترلرها
php artisan vendor:publish --tag=cart-controllers

# برای نصب مسیرها
php artisan vendor:publish --tag=cart-routes
```

### تنظیم مسیرها به صورت دستی

[](#تنظیم-مسیرها-به-صورت-دستی)

اگر مسیرها به صورت خودکار اضافه نشده‌اند، این خط را به فایل `routes/api.php` اضافه کنید:

```
require base_path('routes/cart/api.php');
```

تنظیمات .env
------------

[](#تنظیمات-env)

تنظیمات زیر را می‌توانید در فایل .env خود تعریف کنید:

```
CART_ROUTE_PREFIX=api/v1
CART_ITEM_EXPIRATION=24
CART_MAX_ITEMS=50
CART_EVENTS_ENABLED=true
CART_PRICE_PRECISION=2
CART_TAX_ENABLED=true
CART_DEFAULT_TAX_RATE=0
CART_MULTI_TENANCY_ENABLED=false
```

نحوه استفاده
------------

[](#نحوه-استفاده)

### افزودن محصول به سبد خرید

[](#افزودن-محصول-به-سبد-خرید)

```
POST /api/v1/cart
{
    "product_id": 1,
    "variant_id": null, // اختیاری
    "quantity": 1,
    "tenant_id": null // اختیاری - برای سیستم‌های چند فروشگاهی
}
```

### دریافت لیست سبد خرید

[](#دریافت-لیست-سبد-خرید)

```
GET /api/v1/cart
```

### بروزرسانی تعداد محصول

[](#بروزرسانی-تعداد-محصول)

```
PUT /api/v1/cart/{cart_id}
{
    "quantity": 2
}
```

### حذف محصول از سبد خرید

[](#حذف-محصول-از-سبد-خرید)

```
DELETE /api/v1/cart/{cart_id}
```

### خالی کردن سبد خرید

[](#خالی-کردن-سبد-خرید)

```
DELETE /api/v1/cart
```

### ثبت نهایی سفارش

[](#ثبت-نهایی-سفارش)

```
POST /api/v1/cart/checkout
{
    "address_id": 1
}
```

امکانات
-------

[](#امکانات)

- مدیریت سبد خرید با پشتیبانی از تنوع محصولات
- محاسبه خودکار قیمت با در نظر گرفتن تخفیف‌ها
- پشتیبانی اختیاری از چند فروشگاه (Multi-tenancy)
- مدیریت تراکنش‌ها
- سیستم آدرس دهی
- پشتیبانی از Soft Delete
- قابلیت تنظیم مدت زمان انقضای سبد خرید
- محدودیت تعداد آیتم در سبد خرید
- پشتیبانی از محاسبه مالیات
- امکان غیرفعال کردن ویژگی‌های اضافی

ساختار فایل‌ها
--------------

[](#ساختار-فایل‌ها)

پس از نصب، فایل‌های پکیج در مسیرهای زیر قرار می‌گیرند:

- کانفیگ: `config/cart.php`
- مایگریشن‌ها: `database/migrations/`
- مدل‌ها: `app/Models/Cart/`
- کنترلرها: `app/Http/Controllers/Cart/`
- مسیرها: `routes/cart/api.php`

لایسنس
------

[](#لایسنس)

این پکیج تحت لایسنس MIT منتشر شده است.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance47

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

392d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c4022660187c3be47390cbc14e0464e3565def62a250bd5c2663dda40ca6f890?d=identicon)[miladsarli](/maintainers/miladsarli)

---

Top Contributors

[![Milad-Sarli](https://avatars.githubusercontent.com/u/150502402?v=4)](https://github.com/Milad-Sarli "Milad-Sarli (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/miladsarli-cartsystem/health.svg)

```
[![Health](https://phpackages.com/badges/miladsarli-cartsystem/health.svg)](https://phpackages.com/packages/miladsarli-cartsystem)
```

###  Alternatives

[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)[ecotone/laravel

Laravel integration for Ecotone

21307.6k3](/packages/ecotone-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)