Files
firefly-iii/app/Support/Steam.php

799 lines
32 KiB
PHP
Raw Normal View History

<?php
2022-12-24 05:06:39 +01:00
/**
* Steam.php
2020-02-16 13:56:52 +01:00
* Copyright (c) 2019 james@firefly-iii.org
*
* This file is part of Firefly III (https://github.com/firefly-iii).
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
2017-10-21 08:40:00 +02:00
*
* This program is distributed in the hope that it will be useful,
2017-10-21 08:40:00 +02:00
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
2017-10-21 08:40:00 +02:00
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
declare(strict_types=1);
namespace FireflyIII\Support;
use Carbon\Carbon;
2025-08-06 20:15:02 +02:00
use Exception;
2021-09-18 10:20:19 +02:00
use FireflyIII\Exceptions\FireflyException;
use FireflyIII\Models\Account;
2025-08-06 20:15:02 +02:00
use FireflyIII\Models\AccountMeta;
2015-07-10 07:39:59 +02:00
use FireflyIII\Models\Transaction;
2020-03-20 04:37:45 +01:00
use FireflyIII\Models\TransactionCurrency;
2025-02-04 19:43:53 +01:00
use FireflyIII\Support\Facades\Amount;
use FireflyIII\Support\Http\Api\ExchangeRateConverter;
2025-08-10 06:53:08 +02:00
use FireflyIII\Support\Singleton\PreferencesSingleton;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
2025-02-23 12:47:04 +01:00
use Illuminate\Support\Str;
use ValueError;
2025-05-27 17:06:15 +02:00
use function Safe\parse_url;
2025-08-06 20:15:02 +02:00
use function Safe\preg_replace;
2025-05-27 17:06:15 +02:00
/**
2017-11-15 12:25:49 +01:00
* Class Steam.
*/
class Steam
{
2025-05-04 17:41:26 +02:00
/**
* https://stackoverflow.com/questions/1642614/how-to-ceil-floor-and-round-bcmath-numbers
*/
public function bcround(?string $number, int $precision = 0): string
2024-12-22 08:43:12 +01:00
{
2025-05-04 17:41:26 +02:00
if (null === $number) {
return '0';
}
if ('' === trim($number)) {
return '0';
}
// if the number contains "E", it's in scientific notation, so we need to convert it to a normal number first.
if (false !== stripos($number, 'e')) {
$number = sprintf('%.12f', $number);
}
2024-12-22 08:43:12 +01:00
2025-05-04 17:41:26 +02:00
// Log::debug(sprintf('Trying bcround("%s",%d)', $number, $precision));
if (str_contains($number, '.')) {
if ('-' !== $number[0]) {
2025-08-10 06:53:08 +02:00
return bcadd($number, '0.' . str_repeat('0', $precision) . '5', $precision);
2025-05-04 17:41:26 +02:00
}
2025-08-10 06:53:08 +02:00
return bcsub($number, '0.' . str_repeat('0', $precision) . '5', $precision);
2024-12-22 08:43:12 +01:00
}
2025-05-04 17:41:26 +02:00
return $number;
}
public function filterAccountBalances(array $total, Account $account, bool $convertToPrimary, ?TransactionCurrency $currency = null): array
2025-05-04 17:41:26 +02:00
{
Log::debug(sprintf('filterAccountBalances(#%d)', $account->id));
$return = [];
foreach ($total as $key => $value) {
$return[$key] = $this->filterAccountBalance($value, $account, $convertToPrimary, $currency);
2024-12-22 20:32:58 +01:00
}
2025-05-04 17:41:26 +02:00
Log::debug(sprintf('end of filterAccountBalances(#%d)', $account->id));
2025-05-04 17:41:26 +02:00
return $return;
}
public function filterAccountBalance(array $set, Account $account, bool $convertToPrimary, ?TransactionCurrency $currency = null): array
2025-05-04 17:41:26 +02:00
{
Log::debug(sprintf('filterAccountBalance(#%d)', $account->id), $set);
if (0 === count($set)) {
Log::debug(sprintf('Return empty array for account #%d', $account->id));
return [];
}
$primaryCurrency = Amount::getPrimaryCurrency();
if ($convertToPrimary) {
if ($primaryCurrency->id === $currency?->id) {
Log::debug(sprintf('Unset [%s] for account #%d (no longer unset "pc_balance")', $primaryCurrency->code, $account->id));
unset($set[$primaryCurrency->code]);
2025-05-04 17:41:26 +02:00
}
// todo rethink this logic.
if ($currency instanceof TransactionCurrency && $primaryCurrency->id !== $currency->id) {
2025-05-04 17:41:26 +02:00
Log::debug(sprintf('Unset balance for account #%d', $account->id));
unset($set['balance']);
}
2025-05-27 17:06:15 +02:00
if (!$currency instanceof TransactionCurrency) {
2025-05-04 17:41:26 +02:00
Log::debug(sprintf('Unset balance for account #%d', $account->id));
unset($set['balance']);
}
}
if (!$convertToPrimary) {
2025-05-27 17:06:15 +02:00
if (!$currency instanceof TransactionCurrency) {
2025-08-01 13:48:32 +02:00
Log::debug(sprintf('Unset pc_balance and make primaryCurrency balance the balance for account #%d', $account->id));
$set['balance'] = $set[$primaryCurrency->code] ?? '0';
unset($set[$primaryCurrency->code]);
2025-05-04 17:41:26 +02:00
}
2025-05-27 17:06:15 +02:00
if ($currency instanceof TransactionCurrency) {
Log::debug(sprintf('Unset [%s] + [%s] balance for account #%d', $primaryCurrency->code, $currency->code, $account->id));
unset($set[$primaryCurrency->code], $set[$currency->code]);
2025-05-04 17:41:26 +02:00
}
}
// put specific value first in array.
if (array_key_exists('pc_balance', $set)) {
$set = ['pc_balance' => $set['pc_balance']] + $set;
2025-05-04 17:41:26 +02:00
}
if (array_key_exists('balance', $set)) {
$set = ['balance' => $set['balance']] + $set;
}
Log::debug(sprintf('Return #%d', $account->id), $set);
return $set;
}
public function filterSpaces(string $string): string
{
$search = [
"\u{0001}", // start of heading
"\u{0002}", // start of text
"\u{0003}", // end of text
"\u{0004}", // end of transmission
"\u{0005}", // enquiry
"\u{0006}", // ACK
"\u{0007}", // BEL
"\u{0008}", // backspace
"\u{000E}", // shift out
"\u{000F}", // shift in
"\u{0010}", // data link escape
"\u{0011}", // DC1
"\u{0012}", // DC2
"\u{0013}", // DC3
"\u{0014}", // DC4
"\u{0015}", // NAK
"\u{0016}", // SYN
"\u{0017}", // ETB
"\u{0018}", // CAN
"\u{0019}", // EM
"\u{001A}", // SUB
"\u{001B}", // escape
"\u{001C}", // file separator
"\u{001D}", // group separator
"\u{001E}", // record separator
"\u{001F}", // unit separator
"\u{007F}", // DEL
"\u{00A0}", // non-breaking space
"\u{1680}", // ogham space mark
"\u{180E}", // mongolian vowel separator
"\u{2000}", // en quad
"\u{2001}", // em quad
"\u{2002}", // en space
"\u{2003}", // em space
"\u{2004}", // three-per-em space
"\u{2005}", // four-per-em space
"\u{2006}", // six-per-em space
"\u{2007}", // figure space
"\u{2008}", // punctuation space
"\u{2009}", // thin space
"\u{200A}", // hair space
"\u{200B}", // zero width space
"\u{202F}", // narrow no-break space
"\u{3000}", // ideographic space
"\u{FEFF}", // zero width no -break space
"\x20", // plain old normal space,
' ',
];
// clear zalgo text
2025-05-27 17:06:15 +02:00
$string = preg_replace('/(\pM{2})\pM+/u', '\1', $string);
$string = preg_replace('/\s+/', '', $string);
2025-05-04 17:41:26 +02:00
return str_replace($search, '', $string);
}
public function finalAccountBalanceInRange(Account $account, Carbon $start, Carbon $end, bool $convertToPrimary): array
{
2024-12-22 20:32:58 +01:00
// expand period.
2025-02-08 10:51:52 +01:00
$start->startOfDay();
$end->endOfDay();
2024-12-26 05:11:32 +01:00
Log::debug(sprintf('finalAccountBalanceInRange(#%d, %s, %s)', $account->id, $start->format('Y-m-d H:i:s'), $end->format('Y-m-d H:i:s')));
2024-12-22 20:32:58 +01:00
// set up cache
2025-08-10 06:53:08 +02:00
$cache = new CacheProperties();
$cache->addProperty($account->id);
2024-12-22 20:32:58 +01:00
$cache->addProperty('final-balance-in-range');
$cache->addProperty($start);
$cache->addProperty($convertToPrimary);
$cache->addProperty($end);
if ($cache->has()) {
return $cache->get();
}
2025-08-10 06:53:08 +02:00
$balances = [];
$formatted = $start->format('Y-m-d');
/*
* To make sure the start balance is correct, we need to get the balance at the exact end of the previous day.
* Since we just did "startOfDay" we can do subDay()->endOfDay() to get the correct moment.
* THAT will be the start balance.
*/
2025-08-10 06:53:08 +02:00
$request = clone $start;
$request->subDay()->endOfDay();
Log::debug(sprintf('finalAccountBalanceInRange: Call finalAccountBalance with date/time "%s"', $request->toIso8601String()));
2025-08-10 06:53:08 +02:00
$startBalance = $this->finalAccountBalance($account, $request);
$primaryCurrency = Amount::getPrimaryCurrencyByUserGroup($account->user->userGroup);
$accountCurrency = $this->getAccountCurrency($account);
$hasCurrency = $accountCurrency instanceof TransactionCurrency;
$currency = $accountCurrency ?? $primaryCurrency;
2024-12-26 05:11:32 +01:00
Log::debug(sprintf('Currency is %s', $currency->code));
2025-02-05 06:29:07 +01:00
2025-02-08 10:51:52 +01:00
2025-02-05 06:29:07 +01:00
// set start balances:
$startBalance[$currency->code] ??= '0';
if ($hasCurrency) {
$startBalance[$accountCurrency->code] ??= '0';
}
2024-12-26 05:11:32 +01:00
if (!$hasCurrency) {
Log::debug(sprintf('Also set start balance in %s', $primaryCurrency->code));
$startBalance[$primaryCurrency->code] ??= '0';
2024-12-26 05:11:32 +01:00
}
2025-08-10 06:53:08 +02:00
$currencies = [
$currency->id => $currency,
$primaryCurrency->id => $primaryCurrency,
2024-12-22 20:32:58 +01:00
];
2025-02-05 06:29:07 +01:00
$balances[$formatted] = $startBalance;
2024-12-26 05:11:32 +01:00
Log::debug('Final start balance: ', $startBalance);
2025-02-05 06:29:07 +01:00
// sums up the balance changes per day.
2025-02-08 10:51:52 +01:00
Log::debug(sprintf('Date >= %s and <= %s', $start->format('Y-m-d H:i:s'), $end->format('Y-m-d H:i:s')));
2025-08-10 06:53:08 +02:00
$set = $account->transactions()
->leftJoin('transaction_journals', 'transactions.transaction_journal_id', '=', 'transaction_journals.id')
->where('transaction_journals.date', '>=', $start->format('Y-m-d H:i:s'))
->where('transaction_journals.date', '<=', $end->format('Y-m-d H:i:s'))
->groupBy('transaction_journals.date')
->groupBy('transactions.transaction_currency_id')
->orderBy('transaction_journals.date', 'ASC')
->whereNull('transaction_journals.deleted_at')
->get(
[ // @phpstan-ignore-line
'transaction_journals.date',
'transactions.transaction_currency_id',
DB::raw('SUM(transactions.amount) AS sum_of_day'),
]
);
$currentBalance = $startBalance;
$converter = new ExchangeRateConverter();
/** @var Transaction $entry */
foreach ($set as $entry) {
2025-02-05 06:29:07 +01:00
// get date object
2025-08-10 06:53:08 +02:00
$carbon = new Carbon($entry->date, $entry->date_tz);
$carbonKey = $carbon->format('Y-m-d');
2025-02-05 06:29:07 +01:00
// make sure sum is a string:
2025-08-10 06:53:08 +02:00
$sumOfDay = (string)($entry->sum_of_day ?? '0');
2025-06-08 05:55:22 +02:00
// #10426 make sure sum is not in scientific notation.
2025-08-10 06:53:08 +02:00
$sumOfDay = $this->floatalize($sumOfDay);
2024-12-26 05:11:32 +01:00
2025-02-05 06:29:07 +01:00
// find currency of this entry, does not have to exist.
$currencies[$entry->transaction_currency_id] ??= TransactionCurrency::find($entry->transaction_currency_id);
2025-01-05 07:31:26 +01:00
2025-02-05 06:29:07 +01:00
// make sure this $entry has its own $entryCurrency
2025-01-04 19:25:43 +01:00
/** @var TransactionCurrency $entryCurrency */
2025-08-10 06:53:08 +02:00
$entryCurrency = $currencies[$entry->transaction_currency_id];
2024-12-26 05:11:32 +01:00
2025-02-08 07:16:56 +01:00
Log::debug(sprintf('Processing transaction(s) on moment %s', $carbon->format('Y-m-d H:i:s')));
// add amount to current balance in currency code.
2025-08-10 06:53:08 +02:00
$currentBalance[$entryCurrency->code] ??= '0';
2025-08-06 20:15:02 +02:00
$currentBalance[$entryCurrency->code] = bcadd($sumOfDay, (string)$currentBalance[$entryCurrency->code]);
2024-12-26 05:11:32 +01:00
// if not requested to convert to primary currency, add the amount to "balance", do nothing else.
if (!$convertToPrimary) {
2025-08-06 20:15:02 +02:00
$currentBalance['balance'] = bcadd((string)$currentBalance['balance'], $sumOfDay);
}
// if convert to primary currency add the converted amount to "pc_balance".
// if there is a request to convert, convert to "pc_balance" and use "balance" for whichever amount is in the primary currency.
if ($convertToPrimary) {
$pcSumOfDay = $converter->convert($entryCurrency, $primaryCurrency, $carbon, $sumOfDay);
2025-08-06 20:15:02 +02:00
$currentBalance['pc_balance'] = bcadd((string)($currentBalance['pc_balance'] ?? '0'), $pcSumOfDay);
2025-07-27 07:36:23 +02:00
// if it's the same currency as the entry, also add to balance (see other code).
if ($currency->id === $entryCurrency->id) {
2025-08-06 20:15:02 +02:00
$currentBalance['balance'] = bcadd((string)$currentBalance['balance'], $sumOfDay);
}
}
2025-07-27 07:36:23 +02:00
// add to final array.
2025-08-10 06:53:08 +02:00
$balances[$carbonKey] = $currentBalance;
2025-02-08 07:16:56 +01:00
Log::debug(sprintf('Updated entry [%s]', $carbonKey), $currentBalance);
}
$cache->store($balances);
2024-12-26 08:53:16 +01:00
Log::debug('End of method');
return $balances;
}
2025-08-07 05:52:56 +02:00
public function accountsBalancesOptimized(Collection $accounts, Carbon $date, ?TransactionCurrency $primary = null, ?bool $convertToPrimary = null): array
2025-08-06 20:15:02 +02:00
{
2025-08-09 16:31:11 +02:00
Log::debug(sprintf('accountsBalancesOptimized: Called with date/time "%s"', $date->toIso8601String()));
2025-08-10 06:53:08 +02:00
$result = [];
$convertToPrimary ??= Amount::convertToPrimary();
$primary ??= Amount::getPrimaryCurrency();
2025-08-10 06:53:08 +02:00
$currencies = $this->getCurrencies($accounts);
2025-08-06 20:15:02 +02:00
// balance(s) in all currencies for ALL accounts.
2025-08-10 06:53:08 +02:00
$array = Transaction::whereIn('account_id', $accounts->pluck('id')->toArray())
->leftJoin('transaction_journals', 'transaction_journals.id', '=', 'transactions.transaction_journal_id')
->leftJoin('transaction_currencies', 'transaction_currencies.id', '=', 'transactions.transaction_currency_id')
->where('transaction_journals.date', '<=', $date->format('Y-m-d H:i:s'))
->get(['transactions.account_id', 'transaction_currencies.code', 'transactions.amount'])->toArray();
2025-08-06 20:15:02 +02:00
/** @var Account $account */
foreach ($accounts as $account) {
// filter array back to this account:
2025-08-10 06:53:08 +02:00
$filtered = array_filter($array, function ($item) use ($account) {
2025-08-06 20:15:02 +02:00
return (int)$item['account_id'] === $account->id;
});
2025-08-10 06:53:08 +02:00
$currency = $currencies[$account->id];
2025-08-06 20:15:02 +02:00
// this array is PER account, so we wait a bit before we change code here.
2025-08-10 06:53:08 +02:00
$return = [
2025-08-06 20:15:02 +02:00
'pc_balance' => '0',
'balance' => '0', // this key is overwritten right away, but I must remember it is always created.
];
// balance(s) in all currencies.
2025-08-10 06:53:08 +02:00
$others = $this->groupAndSumTransactions($filtered, 'code', 'amount');
2025-08-06 20:15:02 +02:00
// Log::debug('All balances are (joined)', $others);
// if there is no request to convert, take this as "balance" and "pc_balance".
2025-08-10 06:53:08 +02:00
$return['balance'] = $others[$currency->code] ?? '0';
2025-08-06 20:15:02 +02:00
if (!$convertToPrimary) {
unset($return['pc_balance']);
// Log::debug(sprintf('Set balance to %s, unset pc_balance', $return['balance']));
}
// if there is a request to convert, convert to "pc_balance" and use "balance" for whichever amount is in the primary currency.
if ($convertToPrimary) {
$return['pc_balance'] = $this->convertAllBalances($others, $primary, $date); // todo sum all and convert.
// Log::debug(sprintf('Set pc_balance to %s', $return['pc_balance']));
}
// either way, the balance is always combined with the virtual balance:
2025-08-10 06:53:08 +02:00
$virtualBalance = (string)('' === (string)$account->virtual_balance ? '0' : $account->virtual_balance);
2025-08-06 20:15:02 +02:00
if ($convertToPrimary) {
// the primary currency balance is combined with a converted virtual_balance:
$converter = new ExchangeRateConverter();
$pcVirtualBalance = $converter->convert($currency, $primary, $date, $virtualBalance);
$return['pc_balance'] = bcadd($pcVirtualBalance, $return['pc_balance']);
// Log::debug(sprintf('Primary virtual balance makes the primary total %s', $return['pc_balance']));
}
if (!$convertToPrimary) {
// if not, also increase the balance + primary balance for consistency.
$return['balance'] = bcadd($return['balance'], $virtualBalance);
// Log::debug(sprintf('Virtual balance makes the (primary currency) total %s', $return['balance']));
}
$final = array_merge($return, $others);
$result[$account->id] = $final;
// Log::debug('Final balance is', $final);
}
2025-08-06 20:15:02 +02:00
return $result;
}
/**
* Returns smaller than or equal to, so be careful with END OF DAY.
*
* Returns the balance of an account at exact moment given. Array with at least one value.
2025-02-05 06:03:57 +01:00
* Always returns:
* "balance": balance in the account's currency OR user's primary currency if the account has no currency
2025-02-05 06:03:57 +01:00
* "EUR": balance in EUR (or whatever currencies the account has balance in)
*
* If the user has $convertToPrimary:
* "balance": balance in the account's currency OR user's primary currency if the account has no currency
* --> "pc_balance": balance in the user's primary currency, with all amounts converted to the primary currency.
2025-02-05 06:03:57 +01:00
* "EUR": balance in EUR (or whatever currencies the account has balance in)
*/
public function finalAccountBalance(Account $account, Carbon $date, ?TransactionCurrency $primary = null, ?bool $convertToPrimary = null): array
{
2025-02-08 07:16:56 +01:00
2025-08-10 06:53:08 +02:00
$cache = new CacheProperties();
2024-12-31 08:17:35 +01:00
$cache->addProperty($account->id);
$cache->addProperty($date);
if ($cache->has()) {
Log::debug(sprintf('CACHED finalAccountBalance(#%d, %s)', $account->id, $date->format('Y-m-d H:i:s')));
// return $cache->get();
2024-12-31 08:17:35 +01:00
}
// Log::debug(sprintf('finalAccountBalance(#%d, %s)', $account->id, $date->format('Y-m-d H:i:s')));
if (null === $convertToPrimary) {
$convertToPrimary = Amount::convertToPrimary($account->user);
}
if (!$primary instanceof TransactionCurrency) {
$primary = Amount::getPrimaryCurrencyByUserGroup($account->user->userGroup);
}
// account balance thing.
2025-08-10 06:53:08 +02:00
$currencyPresent = isset($account->meta) && array_key_exists('currency', $account->meta) && null !== $account->meta['currency'];
if ($currencyPresent) {
$accountCurrency = $account->meta['currency'];
}
if (!$currencyPresent) {
2024-12-31 08:17:35 +01:00
$accountCurrency = $this->getAccountCurrency($account);
}
2025-08-10 06:53:08 +02:00
$hasCurrency = null !== $accountCurrency;
$currency = $hasCurrency ? $accountCurrency : $primary;
$return = [
2025-08-06 20:15:02 +02:00
'pc_balance' => '0',
'balance' => '0', // this key is overwritten right away, but I must remember it is always created.
2025-02-04 19:43:53 +01:00
];
2025-02-05 06:03:57 +01:00
// balance(s) in all currencies.
2025-08-10 06:53:08 +02:00
$array = $account->transactions()
->leftJoin('transaction_journals', 'transaction_journals.id', '=', 'transactions.transaction_journal_id')
->leftJoin('transaction_currencies', 'transaction_currencies.id', '=', 'transactions.transaction_currency_id')
->where('transaction_journals.date', '<=', $date->format('Y-m-d H:i:s'))
->get(['transaction_currencies.code', 'transactions.amount'])->toArray();
$others = $this->groupAndSumTransactions($array, 'code', 'amount');
// Log::debug('All balances are (joined)', $others);
// if there is no request to convert, take this as "balance" and "pc_balance".
2025-02-05 06:29:07 +01:00
$return['balance'] = $others[$currency->code] ?? '0';
if (!$convertToPrimary) {
unset($return['pc_balance']);
// Log::debug(sprintf('Set balance to %s, unset pc_balance', $return['balance']));
2025-02-04 19:43:53 +01:00
}
// if there is a request to convert, convert to "pc_balance" and use "balance" for whichever amount is in the primary currency.
if ($convertToPrimary) {
2025-08-02 07:16:30 +02:00
$return['pc_balance'] = $this->convertAllBalances($others, $primary, $date); // todo sum all and convert.
// Log::debug(sprintf('Set pc_balance to %s', $return['pc_balance']));
2025-02-04 19:43:53 +01:00
}
// either way, the balance is always combined with the virtual balance:
2025-08-10 06:53:08 +02:00
$virtualBalance = (string)('' === (string)$account->virtual_balance ? '0' : $account->virtual_balance);
2025-02-04 19:43:53 +01:00
if ($convertToPrimary) {
// the primary currency balance is combined with a converted virtual_balance:
$converter = new ExchangeRateConverter();
$pcVirtualBalance = $converter->convert($currency, $primary, $date, $virtualBalance);
$return['pc_balance'] = bcadd($pcVirtualBalance, $return['pc_balance']);
// Log::debug(sprintf('Primary virtual balance makes the primary total %s', $return['pc_balance']));
2025-02-04 19:43:53 +01:00
}
if (!$convertToPrimary) {
// if not, also increase the balance + primary balance for consistency.
2025-02-05 06:29:07 +01:00
$return['balance'] = bcadd($return['balance'], $virtualBalance);
// Log::debug(sprintf('Virtual balance makes the (primary currency) total %s', $return['balance']));
}
2025-08-10 06:53:08 +02:00
$final = array_merge($return, $others);
// Log::debug('Final balance is', $final);
2024-12-31 08:17:35 +01:00
$cache->store($final);
2025-02-04 19:43:53 +01:00
return $final;
}
2025-05-04 17:41:26 +02:00
public function getAccountCurrency(Account $account): ?TransactionCurrency
2024-12-26 05:11:32 +01:00
{
2025-08-10 06:53:08 +02:00
$type = $account->accountType->type;
$list = config('firefly.valid_currency_account_types');
2025-05-04 17:41:26 +02:00
// return null if not in this list.
if (!in_array($type, $list, true)) {
return null;
}
$result = $account->accountMeta()->where('name', 'currency_id')->first();
if (null === $result) {
return null;
2024-12-25 11:59:15 +01:00
}
2025-08-06 20:15:02 +02:00
return TransactionCurrency::find((int)$result->data);
2024-12-25 11:59:15 +01:00
}
2025-05-04 17:41:26 +02:00
private function groupAndSumTransactions(array $array, string $group, string $field): array
2024-12-26 05:11:32 +01:00
{
2025-05-04 17:41:26 +02:00
$return = [];
2025-05-04 17:41:26 +02:00
foreach ($array as $item) {
$groupKey = $item[$group] ?? 'unknown';
2025-08-06 20:15:02 +02:00
$return[$groupKey] = bcadd($return[$groupKey] ?? '0', (string)$item[$field]);
2024-12-25 11:59:15 +01:00
}
2025-05-04 17:41:26 +02:00
return $return;
}
2024-12-25 11:59:15 +01:00
private function convertAllBalances(array $others, TransactionCurrency $primary, Carbon $date): string
2025-05-04 17:41:26 +02:00
{
$total = '0';
$converter = new ExchangeRateConverter();
2025-08-10 06:53:08 +02:00
$singleton = PreferencesSingleton::getInstance();
2025-05-04 17:41:26 +02:00
foreach ($others as $key => $amount) {
2025-08-10 06:53:08 +02:00
$preference = $singleton->getPreference($key);
$currency = $preference ?? TransactionCurrency::where('code', $key)->first();
2024-12-25 11:59:15 +01:00
if (null === $currency) {
2025-05-04 17:41:26 +02:00
continue;
2024-12-25 11:59:15 +01:00
}
2025-08-10 06:53:08 +02:00
if (null === $preference) {
$singleton->setPreference($key, $currency);
}
2025-08-10 06:54:04 +02:00
$current = $amount;
if ($currency->id !== $primary->id) {
$current = $converter->convert($currency, $primary, $date, $amount);
Log::debug(sprintf('Convert %s %s to %s %s', $currency->code, $amount, $primary->code, $current));
2025-08-10 06:53:08 +02:00
}
$total = bcadd($current, $total);
2024-12-25 11:59:15 +01:00
}
2025-05-04 17:41:26 +02:00
return $total;
2024-12-25 11:59:15 +01:00
}
2023-05-29 13:56:55 +02:00
/**
2023-02-22 18:14:14 +01:00
* @throws FireflyException
*/
public function getHostName(string $ipAddress): string
{
2024-12-22 06:33:37 +01:00
$host = '';
2023-02-22 18:14:14 +01:00
try {
$hostName = gethostbyaddr($ipAddress);
} catch (Exception $e) {
2024-12-22 06:33:37 +01:00
app('log')->error($e->getMessage());
$hostName = $ipAddress;
}
2025-08-06 20:15:02 +02:00
if ('' !== (string)$hostName && $hostName !== $ipAddress) {
2024-12-22 06:33:37 +01:00
$host = $hostName;
2023-02-22 18:14:14 +01:00
}
2023-12-20 19:35:52 +01:00
2025-08-06 20:15:02 +02:00
return (string)$host;
2023-02-22 18:14:14 +01:00
}
2016-04-05 22:00:03 +02:00
public function getLastActivities(array $accounts): array
2016-01-20 15:23:36 +01:00
{
$list = [];
2025-08-10 06:53:08 +02:00
$set = auth()->user()->transactions()
->whereIn('transactions.account_id', $accounts)
->groupBy(['transactions.account_id', 'transaction_journals.user_id'])
->get(['transactions.account_id', DB::raw('MAX(transaction_journals.date) AS max_date')]) // @phpstan-ignore-line
2023-12-20 19:35:52 +01:00
;
2016-01-20 15:23:36 +01:00
2023-11-05 19:41:37 +01:00
/** @var Transaction $entry */
2016-01-20 15:23:36 +01:00
foreach ($set as $entry) {
2025-08-10 06:53:08 +02:00
$date = new Carbon($entry->max_date, config('app.timezone'));
2020-07-17 18:52:34 +02:00
$date->setTimezone(config('app.timezone'));
2025-08-06 20:15:02 +02:00
$list[(int)$entry->account_id] = $date;
2016-01-20 15:23:36 +01:00
}
return $list;
}
/**
* Get user's locale.
*/
public function getLocale(): string // get preference
{
$locale = app('preferences')->get('locale', config('firefly.default_locale', 'equal'))->data;
2023-11-28 05:31:26 +01:00
if (is_array($locale)) {
$locale = 'equal';
}
if ('equal' === $locale) {
$locale = $this->getLanguage();
}
2025-08-06 20:15:02 +02:00
$locale = (string)$locale;
2023-11-28 05:31:26 +01:00
// Check for Windows to replace the locale correctly.
2023-12-20 19:35:52 +01:00
if ('WIN' === strtoupper(substr(PHP_OS, 0, 3))) {
2025-05-27 17:06:15 +02:00
return str_replace('_', '-', $locale);
}
return $locale;
}
/**
2023-06-21 12:34:58 +02:00
* Get user's language.
*
* @throws FireflyException
*/
public function getLanguage(): string // get preference
{
$preference = app('preferences')->get('language', config('firefly.default_language', 'en_US'))->data;
if (!is_string($preference)) {
throw new FireflyException(sprintf('Preference "language" must be a string, but is unexpectedly a "%s".', gettype($preference)));
}
2023-12-20 19:35:52 +01:00
2023-10-14 07:04:07 +02:00
return str_replace('-', '_', $preference);
2023-06-21 12:34:58 +02:00
}
public function getLocaleArray(string $locale): array
{
return [
sprintf('%s.utf8', $locale),
sprintf('%s.UTF-8', $locale),
];
}
2022-03-29 14:59:58 +02:00
/**
* Returns the previous URL but refuses to send you to specific URLs.
*
* - outside domain
* - to JS files, API or JSON routes
*
* Uses the session's previousUrl() function as inspired by GitHub user @z1r0-
*
* session()->previousUrl() uses getSafeUrl() so we can safely return it:
*/
public function getSafePreviousUrl(): string
{
2023-12-29 09:01:42 +01:00
// Log::debug(sprintf('getSafePreviousUrl: "%s"', session()->previousUrl()));
2022-03-29 14:59:58 +02:00
return session()->previousUrl() ?? route('index');
}
/**
* Make sure URL is safe.
*/
public function getSafeUrl(string $unknownUrl, string $safeUrl): string
{
2023-12-29 09:01:42 +01:00
// Log::debug(sprintf('getSafeUrl(%s, %s)', $unknownUrl, $safeUrl));
2025-08-10 06:53:08 +02:00
$returnUrl = $safeUrl;
$unknownHost = parse_url($unknownUrl, PHP_URL_HOST);
$safeHost = parse_url($safeUrl, PHP_URL_HOST);
2022-03-29 14:59:58 +02:00
if (null !== $unknownHost && $unknownHost === $safeHost) {
$returnUrl = $unknownUrl;
}
// URL must not lead to weird pages
$forbiddenWords = ['jscript', 'json', 'debug', 'serviceworker', 'offline', 'delete', '/login', '/attachments/view'];
2025-02-23 12:47:04 +01:00
if (Str::contains($returnUrl, $forbiddenWords)) {
2025-05-27 17:06:15 +02:00
return $safeUrl;
2022-03-29 14:59:58 +02:00
}
return $returnUrl;
}
public function negative(string $amount): string
{
2021-04-05 06:14:13 +02:00
if ('' === $amount) {
return '0';
}
2022-03-26 18:13:02 +01:00
$amount = $this->floatalize($amount);
2017-11-15 12:25:49 +01:00
if (1 === bccomp($amount, '0')) {
2025-05-27 17:06:15 +02:00
return bcmul($amount, '-1');
}
return $amount;
}
2017-06-20 21:04:25 +02:00
/**
2023-06-21 12:34:58 +02:00
* https://framework.zend.com/downloads/archives
*
* Convert a scientific notation to float
* Additionally fixed a problem with PHP <= 5.2.x with big integers
*/
public function floatalize(string $value): string
{
2025-08-10 06:53:08 +02:00
$value = strtoupper($value);
2023-06-21 12:34:58 +02:00
if (!str_contains($value, 'E')) {
return $value;
}
Log::debug(sprintf('Floatalizing %s', $value));
2023-06-21 12:34:58 +02:00
2025-08-06 20:15:02 +02:00
$number = substr($value, 0, (int)strpos($value, 'E'));
2023-06-21 12:34:58 +02:00
if (str_contains($number, '.')) {
2025-08-06 20:15:02 +02:00
$post = strlen(substr($number, (int)strpos($number, '.') + 1));
$mantis = substr($value, (int)strpos($value, 'E') + 1);
2023-06-21 12:34:58 +02:00
if ($mantis < 0) {
2025-08-06 20:15:02 +02:00
$post += abs((int)$mantis);
2023-06-21 12:34:58 +02:00
}
2023-12-20 19:35:52 +01:00
2023-06-21 12:34:58 +02:00
// TODO careless float could break financial math.
2025-08-06 20:15:02 +02:00
return number_format((float)$value, $post, '.', '');
2023-06-21 12:34:58 +02:00
}
2023-12-20 19:35:52 +01:00
2023-06-21 12:34:58 +02:00
// TODO careless float could break financial math.
2025-08-06 20:15:02 +02:00
return number_format((float)$value, 0, '.', '');
2023-06-21 12:34:58 +02:00
}
public function opposite(?string $amount = null): ?string
2017-06-20 21:04:25 +02:00
{
2018-04-02 14:50:17 +02:00
if (null === $amount) {
2018-03-24 14:05:29 +01:00
return null;
}
2020-10-23 19:11:25 +02:00
return bcmul($amount, '-1');
2017-06-20 21:04:25 +02:00
}
2018-07-15 10:00:08 +02:00
public function phpBytes(string $string): int
2015-07-19 14:30:20 +02:00
{
$string = str_replace(['kb', 'mb', 'gb'], ['k', 'm', 'g'], strtolower($string));
2015-07-19 14:30:20 +02:00
2020-10-24 16:59:56 +02:00
if (false !== stripos($string, 'k')) {
2015-07-19 14:30:20 +02:00
// has a K in it, remove the K and multiply by 1024.
$bytes = bcmul(rtrim($string, 'k'), '1024');
2015-07-19 14:30:20 +02:00
2025-08-06 20:15:02 +02:00
return (int)$bytes;
2015-07-19 14:30:20 +02:00
}
2020-10-24 16:59:56 +02:00
if (false !== stripos($string, 'm')) {
2015-07-19 14:30:20 +02:00
// has a M in it, remove the M and multiply by 1048576.
$bytes = bcmul(rtrim($string, 'm'), '1048576');
2015-07-19 14:30:20 +02:00
2025-08-06 20:15:02 +02:00
return (int)$bytes;
2015-07-19 14:30:20 +02:00
}
2020-10-24 16:59:56 +02:00
if (false !== stripos($string, 'g')) {
// has a G in it, remove the G and multiply by (1024)^3.
$bytes = bcmul(rtrim($string, 'g'), '1073741824');
2025-08-06 20:15:02 +02:00
return (int)$bytes;
}
2025-08-06 20:15:02 +02:00
return (int)$string;
2015-07-19 14:30:20 +02:00
}
2017-02-11 09:34:04 +01:00
public function positive(string $amount): string
{
2021-04-05 06:14:13 +02:00
if ('' === $amount) {
return '0';
}
2023-12-20 19:35:52 +01:00
2022-05-04 20:32:51 +02:00
try {
2023-12-20 19:35:52 +01:00
if (-1 === bccomp($amount, '0')) {
2022-05-04 20:32:51 +02:00
$amount = bcmul($amount, '-1');
}
} catch (ValueError $e) {
2023-12-29 09:01:42 +01:00
Log::error(sprintf('ValueError in Steam::positive("%s"): %s', $amount, $e->getMessage()));
Log::error($e->getTraceAsString());
2023-12-20 19:35:52 +01:00
2022-05-04 20:32:51 +02:00
return '0';
2017-02-11 09:34:04 +01:00
}
return $amount;
}
2025-08-06 20:15:02 +02:00
private function getCurrencies(Collection $accounts): array
{
2025-08-07 05:55:15 +02:00
$currencies = [];
$accountCurrencies = [];
$accountPreferences = [];
$primary = Amount::getPrimaryCurrency();
$currencies[$primary->id] = $primary;
2025-08-06 20:15:02 +02:00
2025-08-10 06:53:08 +02:00
$ids = $accounts->pluck('id')->toArray();
$result = AccountMeta::whereIn('account_id', $ids)->where('name', 'currency_id')->get();
2025-08-06 20:15:02 +02:00
/** @var AccountMeta $item */
foreach ($result as $item) {
2025-08-07 05:52:56 +02:00
$integer = (int)$item->data;
if (0 !== $integer) {
$accountPreferences[(int)$item->account_id] = $integer;
}
2025-08-06 20:15:02 +02:00
}
2025-08-07 05:55:15 +02:00
// collect those currencies, skip primary because we already have it.
2025-08-10 06:53:08 +02:00
$set = TransactionCurrency::whereIn('id', $accountPreferences)->where('id', '!=', $primary->id)->get();
2025-08-06 20:15:02 +02:00
foreach ($set as $item) {
$currencies[$item->id] = $item;
}
/** @var Account $account */
foreach ($accounts as $account) {
$accountId = $account->id;
$currencyPresent = isset($account->meta) && array_key_exists('currency', $account->meta) && null !== $account->meta['currency'];
if ($currencyPresent) {
$currencyId = $account->meta['currency']->id;
2025-08-10 06:53:08 +02:00
$currencies[$currencyId] ??= $account->meta['currency'];
2025-08-06 20:15:02 +02:00
$accountCurrencies[$accountId] = $account->meta['currency'];
}
2025-08-07 05:52:56 +02:00
if (!$currencyPresent && !array_key_exists($accountId, $accountPreferences)) {
2025-08-06 20:15:02 +02:00
$accountCurrencies[$accountId] = $primary;
}
2025-08-07 05:52:56 +02:00
if (!$currencyPresent && array_key_exists($accountId, $accountPreferences)) {
$accountCurrencies[$accountId] = $currencies[$accountPreferences[$account->id]];
2025-08-06 20:15:02 +02:00
}
}
2025-08-06 20:15:02 +02:00
return $accountCurrencies;
}
2015-03-29 08:14:32 +02:00
}