abdulbaset/convert-numbers

A PHP package to convert numbers to words and currencies in multiple languages

Maintainers

Details

github.com/AbdulbasetRS/Convert-Numbers

Homepage

Source

Issues

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 1

Forks: 0

Open Issues: 0

1.0.0 2025-01-29 16:23 UTC

Requires

  • php: >=7.4

MIT b3d7121dfefee767c38e897d79e738d76338c713

currency converterPHP Librarymulti-languagenumber conversionnumber-to-wordsarabic numbersenglish numbersPHP Packagenumbers to wordscurrency to wordsnumber-to-textwords convertercurrency formatter

This package is auto-updated.

Last update: 2025-03-04 11:46:35 UTC

README

Thumbnail

Convert Numbers

A comprehensive PHP package for number conversion, supporting multiple languages and various conversion types.

Installation

Install the package via Composer:

composer require abdulbaset/convert-numbers

Usage

Basic Number Conversion

use Abdulbaset\ConvertNumbers\ConvertNumbers;

// English (default)
echo ConvertNumbers::toWords(42); // "forty-two"
echo ConvertNumbers::toWords(1234.56); // "one thousand two hundred thirty-four point five six"

// Arabic
echo ConvertNumbers::toWords(42, 'ar'); // "اثنان و أربعون"
echo ConvertNumbers::toWords(1234.56, 'ar'); // "ألف و مائتان و أربعة و ثلاثون فاصلة خمسة ستة"

// French
echo ConvertNumbers::toWords(42, 'fr'); // "quarante-deux"

Currency Conversion

// Basic currency to words
echo ConvertNumbers::currencyToWords(1234.56, 'USD');
// "one thousand two hundred thirty-four dollars and fifty-six cents only"

// Arabic currency
echo ConvertNumbers::currencyToWords(1234.56, 'EGP', 'ar');
// "ألف و مائتان و أربعة و ثلاثون جنيه مصري و ستة و خمسون قرش فقط لا غير"

// Currency formatting
echo ConvertNumbers::currencyFormat(1234567.89, 'USD', 'en', true); // "1,234,567.89 $"
echo ConvertNumbers::currencyFormat(1234567.89, 'EGP', 'ar', true); // "١٬٢٣٤٬٥٦٧٫٨٩ ج.م"

File Size Formatting

// Basic file size formatting
echo ConvertNumbers::toFileSize(1024); // "1.00 KB"
echo ConvertNumbers::toFileSize(1024 * 1024); // "1.00 MB"

// Arabic formatting
echo ConvertNumbers::toFileSize(1024, 'ar'); // "١٫٠٠ كيلوبايت"
echo ConvertNumbers::toFileSize(1024 * 1024, 'ar'); // "١٫٠٠ ميجابايت"

// French formatting
echo ConvertNumbers::toFileSize(1024, 'fr'); // "1,00 Ko"
echo ConvertNumbers::toFileSize(1024 * 1024, 'fr'); // "1,00 Mo"

// Custom decimal places
echo ConvertNumbers::toFileSize(1234567, 'en', 3); // "1.177 MB"

Architecture

The package follows SOLID principles and clean architecture:

  1. Single Responsibility Principle (SRP)

    • Each class has a single responsibility
    • Language classes handle language-specific conversions
    • Currency classes manage currency-specific logic
    • Utility classes for formatting and conversion

  2. Open/Closed Principle (OCP)

    • Easy to add new languages by extending LanguageAbstract
    • New currencies can be added by extending CurrencyAbstract
    • No modification needed to existing code

  3. Interface Segregation Principle (ISP)

    • Separate interfaces for different functionalities
    • ConverterInterface for number conversion
    • CurrencyInterface for currency operations
    • FileSizeInterface for file size formatting

  4. Dependency Inversion Principle (DIP)

    • High-level modules depend on abstractions
    • Easy to swap implementations

Features

1. Number to Words Conversion

  • Convert integers and decimal numbers to words
  • Support for negative numbers
  • Decimal point handling
  • Language-specific formatting

2. Currency Handling

  • Convert currency amounts to words
  • Format currency with proper separators
  • Optional currency symbol display
  • Support for multiple currencies:
    • USD (US Dollar)
    • EUR (Euro)
    • EGP (Egyptian Pound)
    • SAR (Saudi Riyal)

3. File Size Formatting

  • Convert bytes to human-readable formats
  • Automatic unit selection (B, KB, MB, GB, TB, PB)
  • Language-specific unit names
  • Customizable decimal places

4. Multi-language Support

  • Arabic (ar)
  • English (en)
  • French (fr)

5. Number Formatting

  • Language-specific decimal separators
  • Thousands separators
  • Arabic numeral conversion

Use Cases

Here are some practical scenarios where this package can be useful:

📄 Invoices & Legal Documents

  • Convert numbers to words in invoices and contracts for better clarity.
  • Display financial amounts in words to ensure legal accuracy.

💰 Financial & Accounting Applications

  • Format and display monetary values properly.
  • Convert currency values into readable words for multi-language support.

🛍 CMS & E-commerce Platforms

  • Improve user experience by displaying formatted numbers in different languages.
  • Show file sizes in a human-readable format for media uploads.

🌍 Multi-language Applications

  • Convert numeric values to words in different languages without extra dependencies.
  • Provide better localization for global users.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

Change Log

For a detailed list of changes and updates in each version, see the Change Log.

License

This package is open-sourced software licensed under the LICENSE license.

Support

For support:

Donations 💖

Maintaining this package takes time and effort. If you’d like to support its development and keep it growing, you can:

  • 🌟 Star this repository
  • 📢 Sharing it with others
  • 🛠️ Contribute by reporting issues or suggesting features
  • ☕ Buy me a coffee
  • ❤️ Become a sponsor on GitHub Sponsors
  • 💵 Make a one-time donation via PayPal

Your support means a lot to me! Thank you for making this possible. 🙏