PHPackages ricardokovalski/installments-calculator - 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. ricardokovalski/installments-calculator ActiveLibrary ricardokovalski/installments-calculator ======================================= Biblioteca para calcular juros em parcelamentos. v1.0.2(4y ago)01031MITPHPPHP >=5.6CI failing Since May 15Pushed 4y ago1 watchersCompare [ Source](https://github.com/ricardokovalski/installments-calculator)[ Packagist](https://packagist.org/packages/ricardokovalski/installments-calculator)[ RSS](/packages/ricardokovalski-installments-calculator/feed)WikiDiscussions main Synced yesterday READMEChangelog (4)Dependencies (4)Versions (5)Used By (1) ricardokovalski/installments-calculator ======================================= [](#ricardokovalskiinstallments-calculator) **Uma biblioteca PHP para calcular juros de parcelamentos.** [![Source Code](https://camo.githubusercontent.com/0007e06c8a6181af822ec27393eb3d80702d4dd28e618cb44e7b882ebe465c7f/687474703a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d7269636172646f6b6f76616c736b692f696e7374616c6c6d656e742d2d63616c63756c61746f722d626c75652e737667)](https://github.com/ricardokovalski/installments-calculator) [![PHP Programming Language](https://camo.githubusercontent.com/cab1c40991c77e8b5c990f35e62a75ab8e5e5c5c8feeb6b15c348403e218616b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d2533453d352e362d3737376262332e737667)](https://php.net) [![Source Code](https://camo.githubusercontent.com/63a3042f2a3fc0132e24236ee6cc7ebb21ee784229cafc90e0f47f84e959e5a3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f7269636172646f6b6f76616c736b692f696e7374616c6c6d656e74732d63616c63756c61746f722e737667)](https://github.com/ricardokovalski/installments-calculator/releases) [![Author](https://camo.githubusercontent.com/13ee1d4743665be497ac24068eef02fea52c9a2ad0e8855cea8805d534ff5dad/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d407269636172646f6b6f76616c736b692d626c75652e737667)](https://github.com/ricardokovalski) [![Read License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](https://github.com/ricardokovalski/installments-calculator/blob/main/LICENSE) Sobre ----- [](#sobre) ricardokovalski/installments-calculator é uma biblioteca PHP que serve para calcular juros de parcelamentos. Instalação ---------- [](#instalação) Instale este pacote como uma dependência usando [Composer](https://getcomposer.org). ``` composer require ricardokovalski/installments-calculator ``` Uso básico ---------- [](#uso-básico) ### InstallmentCalculationConfig [](#installmentcalculationconfig) Para obtermos uma coleção com as parcelas calculadas, inicialmente devemos instanciar um objeto InstallmentCalculationConfig. Esse objeto requer um tipo de juros em seu construtor. Com a classe InterestCalculation, podemos instanciar um tipo de juros qualquer, ou seja, Financial, Compound e Simple. ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); ``` Ainda no objeto InstallmentCalculationConfig, podemos modificar algumas configurações padrões, por exemplo: ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $interestCompound = InterestCalculation::Compound(1.99); $installmentCalculationConfig->resetInterest($interestCompound); ``` No exemplo acima, resetamos o tipo de juros para Compound, sendo que inicialmente, InstallmentCalculationConfig havia sido instanciada com o tipo Financial. Além de resetar o tipo de juros, podemos definir o número máximo de pacelas. Por padrão, esse número máximo de parcelas é 12. ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $installmentCalculationConfig->resetNumberMaxInstallments(6); ``` No exemplo acima, acabamos de resetar o número máximo de pacelas para 6. Outras opções que temos disponível é de limitar o parcelamento em uma valor mínimo e se este estiver configurado para limitar, podemos definir o valor limite. Por padrão, já está habilitado esse limite no valor de 5.00. ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $installmentCalculationConfig->appendLimitValueInstallment(5.00); ``` No exemplo anterior, adicionamos mais 5.00 ao valor limite, ou seja, agora as parcelas serão calculadas até que a última parcela não seja inferior à 10.00. Caso queira que não se tenha esse limite configurado, basta desativar. ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $installmentCalculationConfig->resetLimitInstallments(false); ``` ### InstallmentCalculation [](#installmentcalculation) Para obter uma coleção de parcelas calculadas. ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $installmentCalculationConfig->resetLimitValueInstallment(10.00); $installmentCalculation = new InstallmentCalculation($installmentCalculationConfig); $installmentCalculation->appendTotalPurchase(343.90); $installmentCalculation->calculate(); $collection = $installmentCalculation->getCollection(); ``` ### Formatters [](#formatters) #### MonetaryFormatterConfig [](#monetaryformatterconfig) ``` use RicardoKovalski\InstallmentsCalculator\Adapters\MonetaryFormatterConfig; use RicardoKovalski\InstallmentsCalculator\Enums\IsoCodes; use RicardoKovalski\InstallmentsCalculator\Enums\Locale; $formatterConfig = MonetaryFormatterConfig::BRL(Locale::PT_BR); $formatterConfig->resetLocale(Locale::EN_US) ->resetCurrencyIsoCode(IsoCodes::USD) ->resetFractionDigits(3); ``` #### MonetaryFormatter [](#monetaryformatter) ``` use RicardoKovalski\InstallmentsCalculator\Adapters\MonetaryFormatter; use RicardoKovalski\InstallmentsCalculator\Adapters\MonetaryFormatterConfig; use RicardoKovalski\InstallmentsCalculator\Enums\Locale; $formatterConfig = MonetaryFormatterConfig::BRL(Locale::PT_BR); $decimalFormatter = MonetaryFormatter::toDecimal($formatterConfig); $intlCurrencyFormatter = MonetaryFormatter::toIntlCurrency($formatterConfig); $intlDecimalFormatter = MonetaryFormatter::toIntlDecimal($formatterConfig); ``` ### Exemplo completo [](#exemplo-completo) ``` use RicardoKovalski\InstallmentsCalculator\Adapters\InterestCalculation; use RicardoKovalski\InstallmentsCalculator\Adapters\MonetaryFormatter; use RicardoKovalski\InstallmentsCalculator\Adapters\MonetaryFormatterConfig; use RicardoKovalski\InstallmentsCalculator\Enums\Locale; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculation; use RicardoKovalski\InstallmentsCalculator\InstallmentCalculationConfig; $interest = InterestCalculation::Financial(2.99); $installmentCalculationConfig = new InstallmentCalculationConfig($interest); $installmentCalculationConfig->resetLimitValueInstallment(10.00); $installmentCalculation = new InstallmentCalculation($installmentCalculationConfig); $installmentCalculation->appendTotalPurchase(343.90); $installmentCalculation->calculate(); $collection = $installmentCalculation->getCollection(); $formatterConfig = MonetaryFormatterConfig::BRL(Locale::PT_BR); $intlCurrencyFormatter = MonetaryFormatter::toIntlCurrency($formatterConfig); foreach ($collection as $installment) { $intlCurrencyFormatter->format($installment->getValueInstallment()); } ``` Copyright and License --------------------- [](#copyright-and-license) The ricardokovalski/installments-calculator library is copyright © [Ricardo Kovalski](https://github.com/ricardokovalski)and licensed for use under the terms of the MIT License (MIT). Please see [LICENSE](LICENSE) for more information. ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community9 Small or concentrated contributor base Maturity50 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 ~29 days Total 4 Last Release 1735d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b6f26053587d0d30779f0864360da904b5227317480dc2ee00773ca8d1b7e280?d=identicon)[ricardokovalski](/maintainers/ricardokovalski) --- Top Contributors [![ricardokovalski](https://avatars.githubusercontent.com/u/13839909?v=4)](https://github.com/ricardokovalski "ricardokovalski (85 commits)") --- Tags calculationscalculatorinstallmentinstallmentsinstallments-calculatorinterestinterest-calculatorinterest-ratescalculatorinstallmentinstallmentscalculationsinterestinterest-calculatorinstallments-calculatorinterest-rates ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/ricardokovalski-installments-calculator/health.svg) ``` [![Health](https://phpackages.com/badges/ricardokovalski-installments-calculator/health.svg)](https://phpackages.com/packages/ricardokovalski-installments-calculator) ``` ### Alternatives [nxp/math-executor Simple math expressions calculator 2281.7M7](/packages/nxp-math-executor)[markrogoyski/ipv4-subnet-calculator Network calculator for subnet mask and other classless (CIDR) network information. 177813.7k6](/packages/markrogoyski-ipv4-subnet-calculator)[madorin/matex PHP Mathematical expression parser and evaluator 1161.2M1](/packages/madorin-matex)[ballen/distical A distance (Lat/Long) calculation library for PHP 40180.2k2](/packages/ballen-distical)[ionux/phactor Phactor is a high-performance PHP implementation of the elliptic curve math functions required to generate & verify private/public (asymmetric) EC keypairs and ECDSA signatures based on secp256k1 curve parameters. This library also includes a class to generate Service Identification Numbers (SINs) based on the published Identity Protocol v1 spec. 5275.0k30](/packages/ionux-phactor)[vovke/loan-payments-calculator PHP library for payment schedule calculations, using various strategies and configurations. 156.6k](/packages/vovke-loan-payments-calculator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)