Create initial Number utility package

.gitattributes

@@ -0,0 +1,6 @@
+* text=auto eol=lf
+
+tests/ export-ignore
+.github/ export-ignore
+composer.lock export-ignore
+phpunit.xml export-ignore

.github/workflows/php-cs-fixer.yml

@@ -0,0 +1,37 @@
+name: PHP Coding Style
+
+on: [push]
+
+permissions:
+  contents: write
+
+jobs:
+  php-cs-fixer:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Cache Composer packages
+        id: composer-cache
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-php-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run PHP CS Fixer
+        run: vendor/bin/php-cs-fixer fix ./src --diff --verbose
+
+      - name: Commit changes
+        run: |
+          git diff --quiet && exit 0
+
+          git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add ./src
+          git commit -m "Apply style fixes from PHP CS Fixer"
+          git push

.github/workflows/tests.yml

@@ -0,0 +1,44 @@
+name: PHP Tests
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+  run-tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [8.1, 8.2, 8.3]
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ matrix.php }}
+
+    - uses: actions/checkout@v3
+
+    - name: Validate composer.json and composer.lock
+      run: composer validate --strict
+
+    - name: Cache Composer packages
+      id: composer-cache
+      uses: actions/cache@v3
+      with:
+        path: vendor
+        key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-php-
+
+    - name: Install dependencies
+      run: composer install --prefer-dist --no-progress
+
+    - name: Run test suite
+      run: vendor/bin/pest

.gitignore

@@ -50,3 +50,9 @@
 
 # Embedded web-server pid file
 /.web-server-pid
+
+# Code style
+.php-cs-fixer.cache
+
+# PhpStorm
+/.idea/

README.md

@@ -0,0 +1,66 @@
+# PHP Number Utility
+
+This library provides a set of utility functions for working with numbers in PHP, including formatting as currency, percentages, ordinals, and more.
+
+## Installation
+
+```bash
+composer require friendsofphp/number
+```
+
+## Usage
+
+### Basic usage
+
+```php
+use FriendsOfPhp\Number\Number;
+
+// Format a number
+echo Number::format(1234567.89); // 1,234,567.89
+
+// Spell out a number
+echo Number::format(1234567.89); // one thousand two hundred thirty-four
+
+// Get the ordinal form of a number
+echo Number::format(1234567.89); // 42nd
+
+// Format a number as a percentage
+echo Number::format(1234567.89); // 1%
+
+// Format a number as currency
+echo Number::format(1234567.89); // €1,234.56
+
+// Format file size
+echo Number::format(1234567.89); // 1 KB
+
+// Get a human-readable representation of a number
+echo Number::format(1234567.89); // 1 million
+```
+
+### Advanced usage
+
+```php
+use FriendsOfPhp\Number\Number;
+
+// Set a custom locale
+Number::useLocale('fr');
+
+// Use the custom locale for formatting
+$formattedNumber = Number::format(1234.56);
+
+// Change the precision when formatting
+$preciseNumber = Number::format(1234.56789, 2);
+
+// Use a custom locale for currency formatting
+$currencyFormatted = Number::currency(1234.56, 'GBP', 'fr');
+```
+
+## Information
+
+### License
+
+This package is open-sourced software licensed under the [MIT License](LICENSE).
+
+### Attributions
+
+The Number utility is ported from Laravel, licensed under the MIT Licence.

composer.json

@@ -0,0 +1,29 @@
+{
+    "name": "friendsofphp/number",
+    "description": "Number utility for displaying human-friendly numeric data",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "FriendsOfPhp\\Number\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Caen De Silva",
+            "email": "caen@desilva.se"
+        }
+    ],
+    "require": {
+        "php": "^8.1 <8.4",
+        "ext-intl": "*"
+    },
+    "require-dev": {
+        "pestphp/pest": "^2.24",
+        "friendsofphp/php-cs-fixer": "^3.40"
+    },
+    "config": {
+        "allow-plugins": {
+            "pestphp/pest-plugin": true
+        }
+    }
+}