Measure Bundle Laravel Package

Product Decisions This Supports

• Unit Conversion for E-Commerce/PIM Systems: Enables dynamic unit conversions (e.g., inches ↔ cm, kg ↔ lbs) for product attributes, supporting multi-market or multi-unit requirements without manual calculations.
• Customizable Measurement Families: Extend beyond default units (length, weight, temperature) to add domain-specific families (e.g., "Capacitance" for electronics, "Volume" for liquids) via YAML config.
• Build vs. Buy: Avoid reinventing unit conversion logic for Symfony/Laravel apps, especially if the team lacks time to build a robust, extensible solution from scratch.
• Roadmap for Localization: Foundation for future localization features (e.g., auto-converting units based on user region) or compliance tools (e.g., food nutrition labels).
• Data Migration: Simplify bulk updates of product attributes with legacy units (e.g., converting all "feet" to "meters" in a database).

When to Consider This Package

• Avoid if:
  • Your app needs real-time currency conversion (use a dedicated API like ExchangeRate-API).
  • You require scientific/advanced math (e.g., complex physics units; consider libraries like UnitConversion).
  • Your stack is not Symfony/Laravel (package is tightly coupled to Symfony’s DI container).
  • You need active maintenance (last release: 2016; no dependents).
• Look elsewhere if:
  • You prioritize modern PHP (requires PHP ≥5.3.3; no PHP 8.x support).
  • Your use case is simple (e.g., hardcoded conversions for 2–3 units; use a lightweight library like PHP-Unit-Converter).
  • You need database-backed configurations (package relies on YAML files; extensions would require custom dev work).

How to Pitch It (Stakeholders)

For Executives: "This package lets us standardize unit conversions across global product listings—e.g., automatically converting product dimensions from inches to centimeters for EU markets—without custom dev work. It’s a lightweight, MIT-licensed solution that reduces errors in manual data entry and supports future localization efforts. Low risk: minimal maintenance overhead, and we can extend it for niche use cases (e.g., electronics specs)."

For Engineering: *"The MeasureBundle provides a Symfony-compatible service to handle unit conversions via YAML configs, with support for custom families and operations. Key trade-offs:

• Pros: Extensible (add new units/families via config), integrates with Symfony’s DI, and handles edge cases (e.g., division by zero).
• Cons: Outdated (2016), no PHP 8.x support, and requires manual config management. We’d need to:
  1. Test thoroughly (coverage is 100% but real-world use cases may vary).
  2. Extend for our needs (e.g., database-backed configs, API wrappers).
  3. Monitor alternatives (e.g., spatie/array-to-object + custom logic). Recommendation: Pilot for a non-critical feature (e.g., product attributes) to validate performance and extensibility before wider adoption."*