diff --git a/example.php b/example.php index 208f1b3..27912eb 100644 --- a/example.php +++ b/example.php @@ -7,7 +7,8 @@ - Gatcha + Basic Usage Example + @@ -39,9 +40,10 @@ 'item 21' => 8.3, ])->spin()."" ?> -

+

+ diff --git a/src/Roll.php b/src/Roll.php index b305dc5..94646c5 100644 --- a/src/Roll.php +++ b/src/Roll.php @@ -2,6 +2,8 @@ /* Author:Irfa Ardiansyah Simple Items Gatcha with PHP + v2.1 + https://github.com/irfaardy/php-gacha */ namespace Irfa\Gatcha; @@ -12,32 +14,68 @@ class Roll extends Roulette { private static $items; + /** + * Put items to $items. + */ public static function put($items) { self::$items = $items; return new static(); } + + /** + * Spin Roullete. + * + * @return string + */ public static function spin() { return self::getItem(); } + + /** + * Spin Roullete json result. + * + * @return json + */ public static function jsonSpin() { $ret = self::getItem(); return self::jsonItem($ret); } + + /** + * Add dropup rate. + * + * @param string $item + * @param float $rate + * @return mixed + */ public static function dropUp($items, $rate) { $items_bucket = self::$items; self::putDropUp(self::itemDropUp($items_bucket, $items, $rate)); return new static(); } + + /** + * Get Spinned items. + * + * @return string + */ private static function getItem() { $ret = self::get(self::$items); self::$items = null; return $ret; } + + /** + * put dropup item to $items variable. + * + * @param array $arr + * @return void + */ private static function putDropUp($arr) { foreach ($arr as $k => $v) { self::$items[$k] = $v; diff --git a/src/Roulette/RateUp.php b/src/Roulette/RateUp.php index e29057e..53abcdd 100644 --- a/src/Roulette/RateUp.php +++ b/src/Roulette/RateUp.php @@ -2,6 +2,8 @@ /* Author:Irfa Ardiansyah Simple Items Gatcha with PHP + v2.1 + https://github.com/irfaardy/php-gacha */ namespace Irfa\Gatcha\Roulette; @@ -9,11 +11,28 @@ class RateUp { + /** + * Add drop up rate to items. + * + * @param mixed $item_list + * @param array $items + * @param float $rate + * @return array + */ protected static function _itemDropUp($item_list, $items, $rate) { $rt = new RateUp(); return $rt->calc_rate($item_list, $items, $rate); } + + /** + * Calculate Drop Up Rate. + * + * @param mixed $item_list + * @param array $items + * @param float $rate + * @return array + */ private function calc_rate($item_list, $items, $rate) { $item = []; diff --git a/src/Roulette/Roulette.php b/src/Roulette/Roulette.php index bd46209..3a30272 100644 --- a/src/Roulette/Roulette.php +++ b/src/Roulette/Roulette.php @@ -2,6 +2,8 @@ /* Author:Irfa Ardiansyah Simple Items Gatcha with PHP + v2.1 + https://github.com/irfaardy/php-gacha */ namespace Irfa\Gatcha\Roulette; @@ -9,15 +11,37 @@ use Irfa\Gatcha\Roulette\RateUp; class Roulette extends RateUp { - + + /** + * encode to Json. + * + * @param string $dt + * @return json + */ protected static function jsonItem($dt) { $data['data'] = ['item' => $dt]; return json_encode($data); } + + /** + * Add drop up rate to items. + * + * @param mixed $item_list + * @param array $items + * @param float $rate + * @return array + */ protected static function itemDropUp($item_list, $items, $rate) { return self::_itemDropUp($item_list, $items, $rate); } + + /** + * Get Item. + * + * @param array $item + * @return string + */ protected static function get($items) { if (is_array($items)) {