php-units-of-measure/php-units-of-measure

v2.2.0 (April 30th, 2025)

• Drop support of PHP < 7.4
• Add isUnitDefined(), listAllUnits(), getOriginalValue(), and getOriginalUnit() methods to the Physical Quantity parent class
• Add new Power Physical Quantity
• Add Imperial Gallons to the Volume quantity
• Move to Github Actions, away from Travis CI
• Use Docker containers instead of Vagrant/VBox instances for dev environments
• Add local dev scripts for lint, test, and shell, in ./scripts/

• Drop support of PHP < 7.4
• Add isUnitDefined(), listAllUnits(), getOriginalValue(), and getOriginalUnit() methods to the Physical Quantity parent class
• Add new Power Physical Quantity
• Add Imperial Gallons to the Volume quantity
• Move to Github Actions, away from Travis CI
• Use Docker containers instead of Vagrant/VBox instances for dev environments
• Add local dev scripts for lint, test, and shell, in ./scripts/

• Added getUnitDefinitions() method to PhysicalQuantity classes, to get a raw list of UnitofMeasure objects defined on that quantity
• Added UPPERCASE templating support for autogenerated metric units to support names like MEGA_METERS, for example.
• New Quantity physical quantity, with mole as the standard unit, to represent the Amount of Substance SI base quantity.
• New SolidAngle physical quantity, with steradian as the standard unit, to represent the solid angle quantity
• Additional aliases for Area units
• Additional units for time: decade, century, and millenium
• Additional units for volume: teaspoon, tablespoon, gallon, quart, fluid ounce, and pint

• Migrated package from triplepoint/php-units-of-measure to php-units-of-measure/php-units-of-measure.
• New physical quantity: Energy
• New units of measure:
  • Area: are and decare
  • Length: nautical mile, mil, AU
  • Mass: stone, also slightly changed definitions of lb and oz
  • Time: yr, and jyr
  • Velocity: km/h, ft/s, mph, knot
• Automated CI testing now includes HHVM and PHP 7
• Removed the heavy vagrant git submodule, it was a silly thing.
• Expanded the Readme for better contribution and installation instructions.

• Registered units of measure are now properties of PhysicalQuantity classes, and not individual instances of those classes. As such, registering a new unit with a given PhysicalQuantity will make that unit immediately available to all inntances of that class.
  • PhysicalQuantity classes no longer define their units in their constructor, and instead have a new initialize() static method
  • The previously-existing registerUnitOfMeasure() method on physical quantity objects has been replaced with a new static addUnit() method
  • The HasSoUnitsTrait method addMissingSIPrefixedUnits is now static
• Added the toNativeUnit() method, to return values in their native unit of measure
• Added the isEquivalentQuantity() method, to support future situations where it's not obvious whether two physical quantities represent the same quantity type
• getSupportedUnits() is no longer available on physical quantities
• The PhysicalQuantity parent class is now named AbstractPhysicalQuantity
• Add a new DemonstrationTests test file, to demonstrate and test typical use cases
• All library exceptions extend from AbstractPhysicalQuantityException, making catching easier
• Added an interface for PhysicalQuantities, to support future work where not all physical quantity classes necessarily have the same parent

• Registered units of measure are now properties of PhysicalQuantity classes, and not individual instances of those classes. As such, registering a new unit with a given PhysicalQuantity will make that unit immediately available to all inntances of that class.
  • PhysicalQuantity classes no longer define their units in their constructor, and instead have a new initialize() static method
  • The previously-existing registerUnitOfMeasure() method on physical quantity objects has been replaced with a new static addUnit() method
  • The HasSoUnitsTrait method addMissingSIPrefixedUnits is now static
• Added the toNativeUnit() method, to return values in their native unit of measure
• Added the isEquivalentQuantity() method, to support future situations where it's not obvious whether two physical quantities represent the same quantity type
• getSupportedUnits() is no longer available on physical quantities
• The PhysicalQuantity parent class is now named AbstractPhysicalQuantity
• Add a new DemonstrationTests test file, to demonstrate and test typical use cases
• All library exceptions extend from AbstractPhysicalQuantityException, making catching easier
• Added an interface for PhysicalQuantities, to support future work where not all physical quantity classes necessarily have the same parent

• Loosened Composer requirement on PHP version to >=5.3.0 (was previously 5.3.5).

• Loosened Composer requirement on PHP version to >=5.3.0 (was previously 5.3.5).

• Added information in the README about the new SI prefix units generation

• Add support for automatically generating metric-prefixed units from a single base unit
• Throw an exception on registering units of measure with names or aliases that collide with existing units on that quantity
• Disallow values that aren't numerical and unit names that aren't strings (ie, type checking)
• Add new method getSupportedUnits() to Physical Quantities
• Add new method getAliases() to Units of Measure
• Add arcminute and arcsecond as angle units
• Add all SI prefix units to meters, kilograms, seconds, amps, kelvin, candela, pascal, bar, radians, degrees, and arcseconds

• Drop support for PHP 5.3
• Moved to PSR-4 namespace convention
• Drop support for an array of names passed in the constructor as a way to specify aliases for UnitOfMeasure objects; addAlias() now required.
• Add UnitOfMeasure::nativeUnitFactory() and UnitOfMeasure::linearUnitFactory() convenience factory methods
• Add optional spelling for 'metres' and 'litres'
• Add Vagrant-based testing virtual machine, for convenience

• New units of measure on Area: hectares, international acres
• New units of measure on Temperature: Rankin, Delisle, Newton, Réaumur, Rømer
• Improved unit test coverage

Adds new quantity Angle, and expands the units for Time.

• New physical quantity: Angle
• Additional units of measure on Time