cline/volume

Volume and dimensional calculation utilities for PHP 8.4+

1.0.1 2025-10-30 14:10 UTC

Requires

• php: ^8.4.0

Requires (Dev)

• cline/php-cs-fixer: ^1.0.5
• driftingly/rector-laravel: ^2.1.1
• ergebnis/composer-normalize: ^2.49@dev
• laravel/pint: ^1.25.1
• orchestra/testbench: ^10.6
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-laravel: ^3.2
• pestphp/pest-plugin-type-coverage: ^3.6.1
• phpstan/phpstan: ^2.1.31
• rector/rector: ^2.2.7
• symfony/var-dumper: ^7.3.5

MIT

• Brian Faust

• php
• dimensions
• measurements
• calculations
• volume
• cubic-meters
• square-meters

README

This library provides volume and dimensional calculation utilities for PHP 8.4+. It offers a flexible volume() function that returns a chainable Volume object with methods for unit conversions including cubic meters, floor meters, and loading meters.

Requirements

Requires PHP 8.4+

Installation

composer require cline/volume

Quick Start

use function Cline\Volume\volume;

// Create from array (default: centimeters)
$vol = volume([120, 80, 100]);

// Get measurements
$vol->centimeters()->value(); // 960000 cm³
$vol->meters()->value();      // 0.96 m³
$vol->loadingMeters()->value(); // 0.4 ldm
$vol->floorMeters()->value(); // 0.96 m²

Documentation

• Basic Usage - Creating volumes, unit conversions, and working with value objects
• Loading Meters - LDM calculations for cargo transportation
• Floor Meters - Footprint area calculations
• Validation - Input validation rules and error handling
• Examples - Real-world usage patterns

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.