Weave Code
Math Laravel Package
moontoast/math
PHP math utilities for Laravel and general use, offering convenient helpers for precise calculations, percentages, rounding, and numeric formatting. Lightweight and easy to integrate into apps where consistent arithmetic and number handling matter.
moontoast/math is a lightweight PHP library for working with math expressions and numeric operations with a clean, developer-friendly API. It’s designed to help you evaluate formulas and handle common calculations without pulling in heavy dependencies.
Use it in Laravel or any PHP project when you need reliable expression parsing and convenient math utilities for dynamic inputs (e.g., user-defined formulas, configuration-driven calculations).
- Parse and evaluate string-based math expressions
- Supports common operators, precedence, and parentheses
- Handy helpers for numeric calculations and conversions
- Simple, dependency-light package suitable for production
- Works well alongside Laravel services, validation, and config
Frequently asked questions about Math
- How do I install moontoast/math in a Laravel project?
- Use Composer to install it with `composer require moontoast/math`. No additional Laravel-specific setup is required, though you may register it as a service provider or facade for cleaner syntax. The package works standalone or alongside Laravel’s service container.
- Does moontoast/math support Laravel’s service container or facades?
- Yes, you can bind the package to Laravel’s container in `AppServiceProvider` or create a facade (e.g., `Math::sqrt()`) for fluent syntax. The README typically includes examples for both approaches. Facades are optional but improve readability in Blade or controller logic.
- What Laravel versions does moontoast/math officially support?
- The package is PHP 5.3+ compatible, so it works with Laravel 5.x through 10.x. However, it lacks native PHP 8.x features like typed properties, so newer Laravel versions may require wrapper abstractions for full compatibility. Test thoroughly if using Laravel 9+.
- Can I use moontoast/math for user-defined math expressions (e.g., dynamic formulas)?
- Yes, the package excels at parsing and evaluating string-based math expressions with support for operators, precedence, and parentheses. It’s ideal for scenarios like user-configurable calculations or formula-driven workflows in Laravel apps, such as pricing engines or statistical tools.
- How does moontoast/math handle large numbers or arbitrary precision?
- The package includes a `BigInteger` class for arbitrary-precision arithmetic, which is critical for financial systems, cryptography, or scientific computing. Unlike PHP’s `float`, it avoids precision loss but requires custom serialization (e.g., storing as strings in databases) and validation for overflow.
- Is moontoast/math suitable for production Laravel apps, or should I use BCMath/GMP instead?
- It’s production-ready for lightweight needs, but BCMath or GMP may be better for performance-critical or high-throughput apps. Benchmark both: `moontoast/math` is pure PHP (no extensions), while GMP/BCMath are native and faster. Use `moontoast/math` if you prioritize portability or avoid extensions.
- How do I store large numbers from moontoast/math in a Laravel database?
- Store `BigInteger` values as strings or JSON in database columns (e.g., `TEXT` or `JSON` types in MySQL). For Eloquent models, use accessors/mutators or Laravel casts to convert between `BigInteger` objects and database-friendly formats. Avoid numeric columns to prevent precision loss.
- Are there alternatives to moontoast/math for Laravel math operations?
- For basic math, PHP’s built-in functions or `bcmath` suffice. For arbitrary precision, consider `php-gmp` (faster but extension-dependent) or `symfony/math` (more feature-rich but heavier). `moontoast/math` stands out for its lightweight design and expression-parsing capabilities, making it ideal for dynamic formulas.
- How do I test moontoast/math in a Laravel project?
- Mock the package in unit tests using Laravel’s service container bindings. Focus on edge cases like overflow, division by zero, or invalid expressions. For integration tests, validate interactions with databases (e.g., serialization/deserialization) or APIs where math results are exposed.
- Will moontoast/math work with Laravel’s validation or form requests?
- Yes, you can extend Laravel’s validator with custom rules to accept `BigInteger` objects or serialized strings. For example, add a rule like `BigInteger|string` to validate user inputs or configuration values. The package’s helpers can also be used in form request logic for dynamic calculations.
Weaver
How can I help you explore Laravel packages today?