Laravel Bcmath Cast Laravel Package

Product Decisions This Supports

• Precision-Critical Financial Systems: Enables seamless, high-accuracy decimal arithmetic (e.g., currency, taxes, inventory pricing) without manual bcmath() function calls, reducing bugs and maintenance overhead.
• Roadmap Alignment with PHP 8.4: Justifies adoption of PHP 8.4 for new projects or migrations, leveraging native BCMath\Number for cleaner code while future-proofing against floating-point errors.
• Build vs. Buy: Avoids reinventing wheel for arbitrary-precision arithmetic in Eloquent models; lightweight alternative to custom solutions or third-party libraries (e.g., briannesbitt/Carbon, moneyphp/money).
• Use Cases:
  • E-commerce platforms (pricing, discounts, multi-currency).
  • Accounting/ERP systems (audit trails, rounding rules).
  • Scientific/engineering apps requiring exact decimal calculations.

When to Consider This Package

• Adopt if:
  • Your app requires arbitrary-precision decimals (e.g., financial, actuarial).
  • You’re using Laravel 11+ and PHP 8.4+ (non-negotiable).
  • Your team values cleaner syntax over raw bcmath() functions (e.g., $total = $price * $quantity vs. bcadd(bcmul(...))).
  • You need Eloquent integration without coupling to external libraries (e.g., GMP, BCMath extensions).
• Look elsewhere if:
  • You’re on older PHP/Laravel versions (no PHP 8.4 support).
  • Your use case is non-decimal (e.g., integers, scientific notation).
  • You need full monetary libraries (e.g., ISO 4217 currency codes, exchange rates) → consider moneyphp/money.
  • Your team lacks PHP 8.4 adoption bandwidth (requires migration effort).

How to Pitch It (Stakeholders)

For Executives: "This package lets our Laravel apps handle precise decimal math (like currency) with simple arithmetic—no more error-prone bcmath() functions. It’s a lightweight, future-proof upgrade for financial systems, cutting dev time and bugs while aligning with PHP 8.4. Low risk (MIT license, minimal dependencies), high reward for exact calculations."

For Engineers: *"PHP 8.4’s BCMath\Number enables intuitive decimal ops (e.g., $total = $price * $quantity), but Laravel’s Eloquent needs a bridge. This package adds AsDecimal casts to models, so:

• Cleaner code: Replace bcadd(bcmul(...)) with $model->price * $model->quantity.
• Precision guaranteed: No floating-point rounding errors.
• Zero trade-offs: Works alongside existing casts, no ORM changes. Requires PHP 8.4/Laravel 11, but worth it for math-heavy apps."