Skip to content

Releases: iamgerwin/toon-php

v2.0.2 - Documentation Enhancement

09 Nov 05:12
@iamgerwin iamgerwin
v2.0.2
6b46c18

Choose a tag to compare

View all tags
v2.0.2 - Documentation Enhancement Latest
Latest

TOON PHP v2.0.2 - Documentation Enhancement

Latest Release | PHP 8.1-8.4 Support

Enhanced documentation release with comprehensive API reference and examples for better developer experience.

📚 What's New

Added

  • Comprehensive DOCUMENTATION.md with complete API reference
  • Detailed examples covering all features and use cases
  • Performance benchmarks and cost calculations
  • Best practices guide for optimal usage
  • Error handling documentation with troubleshooting tips

Changed

  • Enhanced documentation structure for better user onboarding
  • Improved code examples with real-world scenarios (ChatGPT integration, e-commerce, user profiles)

🚀 Features

  • ✅ Full Enum Support (BackedEnum, UnitEnum)
  • ✅ Modern PHP 8.1+ Syntax (constructor promotion, match expressions, arrow functions)
  • ✅ 30-60% Token Savings vs JSON
  • ✅ Zero Dependencies (pure PHP)
  • ✅ PHPStan Level 6 (strict static analysis)
  • ✅ 100% Test Coverage (29 tests, 63 assertions)
  • ✅ PSR-12 Compliant

📦 Installation

# Automatic (recommended for PHP 8.1+)
composer require iamgerwin/toon-php

# Force v2.x
composer require iamgerwin/toon-php:^2.0

📊 Performance

Based on official TOON benchmarks:

Use Case JSON Tokens TOON Tokens Savings
E-commerce Orders 3,245 2,170 33.1%
User Lists 150 82 45.3%
Product Catalogs 320 180 43.8%

At OpenAI's GPT-4 pricing ($0.03/1K tokens):

  • 1M API calls = $3,000 (JSON) → $1,500 (TOON)
  • Annual savings: $1,500+

🎨 Quick Example

use iamgerwin\Toon\Toon;

// Encode with enum support (PHP 8.1+)
enum Status: string {
    case Active = 'active';
    case Pending = 'pending';
}

$order = [
    'id' => 123,
    'status' => Status::Active,
    'amount' => 99.99
];

$toon = Toon::encode($order);
// Output:
//   id: 123
//   status: active
//   amount: 99.99

// Tabular format for uniform datasets
$users = [
    ['id' => 1, 'name' => 'Alice', 'role' => 'admin'],
    ['id' => 2, 'name' => 'Bob', 'role' => 'user'],
];

echo Toon::tabular($users);
// Output:
// [2]{id,name,role}:
//   1,Alice,admin
//   2,Bob,user

📚 Documentation

🔄 Versions

  • v2.x (This Release): PHP 8.1-8.4 with modern features - Recommended
  • v1.x: PHP 7.0-8.0 compatibility - Legacy Support

Made with ❤️ for the PHP and AI community

Assets 2
Loading

v2.0.1 - Modern PHP 8.1+ (Latest)

09 Nov 04:53
@iamgerwin iamgerwin
v2.0.1
9bafb47

Choose a tag to compare

View all tags
v2.0.1 - Modern PHP 8.1+ (Latest)

TOON PHP v2.0.1 - Modern PHP Support (Latest)

Recommended for all new projects | PHP 8.1-8.4

A lightweight, blazing-fast TOON (Token-Oriented Object Notation) library for PHP that cuts your LLM API costs by 30-60%.

🎯 Version Information

  • PHP Support: 8.1, 8.2, 8.3, 8.4
  • Branch: main
  • Status: ✅ Latest & Default

📦 Installation

# Automatic (recommended)
composer require iamgerwin/toon-php

# Force v2.x
composer require iamgerwin/toon-php:^2.0

✨ What's New in v2.0.1

Changed

  • Updated PHP requirement to 8.1+ for enum support
  • Enhanced documentation with version strategy
  • Clarified versioning: v2.x (PHP 8.1+) is recommended & default, v1.x (PHP 7.0-8.0) for legacy support

🚀 Features

  • ✅ Full Enum Support (BackedEnum, UnitEnum)
  • ✅ Modern PHP 8.1+ Syntax (constructor promotion, match expressions, arrow functions)
  • ✅ 30-60% Token Savings vs JSON
  • ✅ Zero Dependencies (pure PHP)
  • ✅ PHPStan Level 6 (strict static analysis)
  • ✅ 100% Test Coverage (29 tests, 63 assertions)
  • ✅ PSR-12 Compliant

📊 Performance

Based on official TOON benchmarks:

Use Case JSON Tokens TOON Tokens Savings
E-commerce Orders 3,245 2,170 33.1%
User Lists 150 82 45.3%
Product Catalogs 320 180 43.8%

At OpenAI's GPT-4 pricing ($0.03/1K tokens):

  • 1M API calls = $3,000 (JSON) → $1,500 (TOON)
  • Annual savings: $1,500+

🎨 Quick Example

use iamgerwin\Toon\Toon;

// Encode with enum support (PHP 8.1+)
enum Status: string {
    case Active = 'active';
    case Pending = 'pending';
}

$order = [
    'id' => 123,
    'status' => Status::Active,
    'amount' => 99.99
];

$toon = Toon::encode($order);
// Output:
//   id: 123
//   status: active
//   amount: 99.99

// Tabular format
$users = [
    ['id' => 1, 'name' => 'Alice', 'role' => 'admin'],
    ['id' => 2, 'name' => 'Bob', 'role' => 'user'],
];

echo Toon::tabular($users);
// Output:
// [2]{id,name,role}:
//   1,Alice,admin
//   2,Bob,user

📚 Documentation

🔄 Versions

  • v2.x (This Release): PHP 8.1-8.4 with modern features - Recommended
  • v1.x: PHP 7.0-8.0 compatibility - Legacy Support

📋 Full Changelog

See CHANGELOG.md for complete details.

Made with ❤️ for the PHP and AI community

Loading

v2.0.0 - Initial Release (Superseded)

09 Nov 03:18
@iamgerwin iamgerwin
v2.0.0
f3e1555

Choose a tag to compare

View all tags
v2.0.0 - Initial Release (Superseded)

⚠️ Superseded by v2.0.1

This release has been superseded by v2.0.1.

Please use v2.0.1 instead, which updates the PHP requirement to 8.1+ for proper enum support.

Migration

# Update to latest
composer require iamgerwin/toon-php:^2.0.1

Original v2.0.0 Release Notes

Initial release with full TOON format support for PHP 8.0-8.4.

Features

  • 🚀 Complete TOON format encoding/decoding
  • 🔒 Type safe with PHPStan level 6
  • 📦 Zero dependencies
  • 🎯 30-60% token savings vs JSON
  • 🧪 100% test coverage (29 tests passing)
  • 🎨 Multiple formatting modes (compact, readable, tabular)
  • ✨ PHP 8.0-8.4 support

Note

This version required PHP 8.0+. The requirement was updated to PHP 8.1+ in v2.0.1 to properly support enums.

Please upgrade to v2.0.1.

Loading

v1.0.1 - Documentation Alignment (Legacy)

09 Nov 05:13
@iamgerwin iamgerwin
v1.0.1
7ca5f67

Choose a tag to compare

View all tags
v1.0.1 - Documentation Alignment (Legacy)

TOON PHP v1.0.1 - Legacy PHP Support (Documentation Update)

Legacy Support for PHP 7.0-8.0 | For modern features, see v2.x

Documentation alignment release for legacy PHP 7.0-8.0 support with enhanced clarity and upgrade paths.

📚 What's New

Changed

  • Enhanced documentation alignment with main branch v2.0.2
  • Improved README structure for better legacy version clarity
  • Updated version references and upgrade paths

Documentation

  • Aligned documentation with latest package capabilities
  • Added clearer migration paths to v2.x for PHP 8.1+ users
  • Enhanced examples and usage patterns

🎯 Version Information

  • PHP Support: 7.0, 7.1, 7.2, 7.3, 7.4, 8.0
  • Branch: legacy
  • Status: 🔧 Legacy Support (Maintenance Mode)

📦 Installation

# Automatic (Composer selects v1.x for PHP 7.0-8.0)
composer require iamgerwin/toon-php

# Force v1.x
composer require iamgerwin/toon-php:^1.0

✨ Features

  • ✅ Complete TOON encoding/decoding for PHP 7.0-8.0
  • ✅ 30-60% Token Savings vs JSON
  • ✅ Zero Dependencies (pure PHP)
  • ✅ PHPStan Level 6 (strict static analysis)
  • ✅ 100% Test Coverage (32 tests, 66 assertions)
  • ✅ PSR-12 Compliant
  • ✅ Traditional PHP Syntax (compatible with PHP 7.0)

⚠️ Limitations

  • ❌ No Enum Support (PHP 8.1+ feature)
  • Uses traditional syntax (no constructor promotion, match expressions, or arrow functions)

📊 Performance

Same token savings as v2.x:

Use Case JSON Tokens TOON Tokens Savings
E-commerce Orders 3,245 2,170 33.1%
User Lists 150 82 45.3%
Product Catalogs 320 180 43.8%

At OpenAI's GPT-4 pricing ($0.03/1K tokens):

  • 1M API calls = $3,000 (JSON) → $1,500 (TOON)
  • Annual savings: $1,500+

🎨 Quick Example

use iamgerwin\Toon\Toon;

// Simple encoding (no enums)
$order = [
    'id' => 123,
    'status' => 'active',  // String instead of enum
    'amount' => 99.99
];

$toon = Toon::encode($order);
// Output:
//   id: 123
//   status: active
//   amount: 99.99

// Tabular format
$users = [
    ['id' => 1, 'name' => 'Alice', 'role' => 'admin'],
    ['id' => 2, 'name' => 'Bob', 'role' => 'user'],
];

echo Toon::tabular($users);
// Output:
// [2]{id,name,role}:
//   1,Alice,admin
//   2,Bob,user

📚 Documentation

⬆️ Upgrade to v2.x

If you're on PHP 8.1+, upgrade to v2.x for:

  • ✅ Full enum support
  • ✅ Modern PHP syntax
  • ✅ Active development
  • ✅ Comprehensive DOCUMENTATION.md

🔄 Versions

  • v2.x: PHP 8.1-8.4 with modern features - Recommended
  • v1.x (This Release): PHP 7.0-8.0 compatibility - Legacy Support

Legacy Support for PHP 7.0-8.0 | Made with ❤️ for the PHP and AI community

Loading

v1.0.0 - Legacy PHP 7.0-8.0 Support

09 Nov 04:53
@iamgerwin iamgerwin
v1.0.0
351b315

Choose a tag to compare

View all tags
v1.0.0 - Legacy PHP 7.0-8.0 Support

TOON PHP v1.0.0 - Legacy PHP Support

Legacy Support for PHP 7.0-8.0 | For modern features, see v2.x

A lightweight, blazing-fast TOON (Token-Oriented Object Notation) library for PHP that cuts your LLM API costs by 30-60%. This is the legacy version supporting PHP 7.0 through 8.0.

🎯 Version Information

  • PHP Support: 7.0, 7.1, 7.2, 7.3, 7.4, 8.0
  • Branch: legacy
  • Status: 🔧 Legacy Support (Maintenance Mode)

📦 Installation

# Automatic (Composer selects v1.x for PHP 7.0-8.0)
composer require iamgerwin/toon-php

# Force v1.x
composer require iamgerwin/toon-php:^1.0

✨ Features

  • ✅ Complete TOON encoding/decoding for PHP 7.0-8.0
  • ✅ 30-60% Token Savings vs JSON
  • ✅ Zero Dependencies (pure PHP)
  • ✅ PHPStan Level 6 (strict static analysis)
  • ✅ 100% Test Coverage (32 tests, 66 assertions)
  • ✅ PSR-12 Compliant
  • ✅ Traditional PHP Syntax (compatible with PHP 7.0)

⚠️ Limitations

  • ❌ No Enum Support (PHP 8.1+ feature)
  • Uses traditional syntax (no constructor promotion, match expressions, or arrow functions)

📊 Performance

Same token savings as v2.x:

Use Case JSON Tokens TOON Tokens Savings
E-commerce Orders 3,245 2,170 33.1%
User Lists 150 82 45.3%
Product Catalogs 320 180 43.8%

At OpenAI's GPT-4 pricing ($0.03/1K tokens):

  • 1M API calls = $3,000 (JSON) → $1,500 (TOON)
  • Annual savings: $1,500+

🎨 Quick Example

use iamgerwin\Toon\Toon;

// Simple encoding (no enums)
$order = [
    'id' => 123,
    'status' => 'active',  // String instead of enum
    'amount' => 99.99
];

$toon = Toon::encode($order);
// Output:
//   id: 123
//   status: active
//   amount: 99.99

// Tabular format
$users = [
    ['id' => 1, 'name' => 'Alice', 'role' => 'admin'],
    ['id' => 2, 'name' => 'Bob', 'role' => 'user'],
];

echo Toon::tabular($users);
// Output:
// [2]{id,name,role}:
//   1,Alice,admin
//   2,Bob,user

📚 Documentation

🔄 Versions

  • v2.x: PHP 8.1-8.4 with modern features - Recommended
  • v1.x (This Release): PHP 7.0-8.0 compatibility - Legacy Support

⬆️ Upgrade to v2.x

If you're on PHP 8.1+, upgrade to v2.x for:

  • ✅ Full enum support
  • ✅ Modern PHP syntax
  • ✅ Active development

📋 Technical Details

PHP 7 Compatibility Changes

  • Removed enum support (PHP 8.1+ feature)
  • Traditional constructor syntax (no property promotion)
  • Docblock type annotations instead of mixed type hints
  • If/else conditionals instead of match expressions
  • Traditional closures instead of arrow functions
  • strpos() instead of str_contains()
  • ToonDelimiter as constants class instead of enum

📋 Full Changelog

See CHANGELOG.md for complete details.

Legacy Support for PHP 7.0-8.0 | Made with ❤️ for the PHP and AI community

Loading