README

Laravel 简单钱包包。此包受到了 laravel-wallet 包的启发。如果您需要完整的钱包功能，请使用 laravel-wallet。我制作此包是因为我需要一些修改过的简单钱包功能，而 laravel-wallet 在当时不支持它们，比如现金返还功能或支持一个（核心）钱包，该钱包包含所有购买的总和。您还可以锁定钱包余额或部分余额，甚至锁定整个钱包，然后在之后释放。

特性

• 存款
• 取款
• 礼物（用户之间）
• 系统礼物（系统到用户）
• 购买
• 现金返还
• 退款
• 锁定余额
• 锁定/完全锁定钱包
• 交易历史记录
• 多钱包
• 货币兑换
• 强制交易（负余额）

安装

使用包管理器 composer 安装简单钱包包。

composer require yeknava/simple-wallet

使用方法

在终端运行此命令

php artisan vendor:publish

将 HasWallet 特性添加到具有钱包的模型中。

<?php

use Yeknava\SimpleWallet\HasWallet;

class User extends Model {
    use HasWallet;

    protected static function boot()
    {
        parent::boot();
        self::walletBoot();
    }
}

$user = User::first();
$user->balance(); // float(0.0)

$user->deposit(100);
$user->balance(); // float(100.0)

$user->withdraw(10);
$user->balance(); // float(90.0)

$system = User::where('type', 'system')->first();

$user->withdraw(10, ['desc'=>'monthly_fee'], null, null, $system->wallet());
$user->balance(); // float(80.0)
$system->balance(); // float(10.0)

$user2 = User::last();
$user2->balance(); // float(0.0)
$user->transfer(10, $user2->wallet());
$user->balance(); // float(70.0)
$user2->balance(); // float(10.0)
$user2->forceTransfer(20, $user->wallet());
$user2->balance(); // float(-10.0)
$user->balance(); // float(90.0)

$user->lockBalance(10);
$user->balance(); // float(80.0)
$user->blocked(); // float(10.0)
$user->releaseBalance(5); // float(10.0)
$user->balance(); // float(85.0)
$user->blocked(); // float(5.0)

$user->lockWallet(); // lock for pay but available for being paid 
$user->transfer(10, $user2->wallet()); // error
$user->deposit(10); // success
$user->fullLockWallet(); // lock for pay or being paid
$user->deposit(10); // error
$user->releaseWallet();
$user->transfer(10, $user2->wallet()); // success

// purchase an item with 50 price which user2 is owner of it and with 5 cashback for payer
$user->balance(); // float(85.0)
$user2->balance(); // float(0.0)
$user->purchase(50, "sample_service", $user2->wallet(), null, ['fee'=>2], 5); 
$user->balance(); // float(40.0)
$user2->balance(); // float(45.0)

$payment = $user1->transactions()->where('service_id', 'sample_service')->first();
$user1->refund($payment);
$user->balance(); // float(85.0)
$user2->balance(); // float(0.0)

$user1NewWallet = $user1->createWallet([], 'wallet2'); //new wallet with 'wallet2' slug
$user1NewWallet->balance(); // float(0.0)
$user->balance(); // float(85.0)
$user1NewWallet->makeDefault();
$user->balance(); // float(0.0)

配置

<?php

use Yeknava\SimpleWallet\Samples\UsdRateServiceSample;

return [
    'default_currency' => 'irt',

    'currencies' => [
        'irr' => 'IRR',
        'irt' => 'IRT',
        'usd' => 'USD',
    ],

    'rates' => [
        'irr' => [
            'irt' => 0.1,
            'usd' => 0.0067
        ],
        'irt' => [
            'irr' => 10,
            'usd' => 0.067
        ],
        'usd' => UsdRateServiceSample::class
    ],

    'wallet_default_slug' => 'wallet',

    // if true, wallet will be created on calling any wallet
    // specific methods in case holder has not any wallet
    'create_wallet_on_fetch' => true 
];

贡献

欢迎拉取请求。对于重大更改，请首先打开一个问题来讨论您想要进行更改的内容。

许可证

MIT