Download the PHP package diego-ninja/granite without Composer
On this page you can find all versions of the php package diego-ninja/granite. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download diego-ninja/granite
More information about diego-ninja/granite
Files in diego-ninja/granite
Package granite
Short Description A lightweight zero-dependency PHP library for building immutable, serializable objects with validation capabilities.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package granite
🪨 Granite
[
A powerful, zero-dependency PHP library for building immutable, serializable objects with validation and mapping capabilities. Perfect for DTOs, Value Objects, API responses, and domain modeling.
🪶 Pebble - Lightweight Immutable Snapshots
Pebble is a lightweight alternative to Granite for defensive, immutable snapshots without validation overhead — ideal for caching, Eloquent snapshots, and fast comparisons. Nested arrays, userland objects, and dates are copied so later source mutations cannot change the snapshot.
📖 Read Pebble Documentation
✨ Features
- Immutable Objects — Read-only DTOs and Value Objects, thread-safe by design
- Flexible
from()Method — Create from arrays, JSON, named parameters, other Granite objects, or mix them - Comprehensive Validation — 30+ built-in rules including Carbon date validation (Age, Future, Past, BusinessDay...)
- ObjectMapper — Convention-based property mapping between objects with custom transformations
- Smart Serialization — Custom property names, naming conventions, hidden fields, Carbon date formats
- Object Comparison — Deep equality with
equals(), detailed diffs withdiffers() - Performance Optimized — Conservative fast path for simple DTOs, deep immutable WeakMap caching, direct property access
🚀 Quick Start
Installation
Basic Usage
📖 Documentation
Core Concepts
- Enhanced from() Method — Multiple invocation patterns for flexible object creation
- Validation — Comprehensive validation system with 30+ built-in rules including Carbon
- Serialization — Control how objects are converted to/from arrays and JSON with Carbon support
- Object Comparison — Deep equality checks and difference detection
- ObjectMapper — Powerful object-to-object mapping with conventions
- Pebble — Lightweight immutable snapshots with fingerprinting
- Advanced Usage — Patterns for complex applications
- API Reference — Complete API documentation
Guides
- Migration Guide — Migrate from arrays, stdClass, Doctrine, Laravel
- Troubleshooting — Common issues and solutions
📈 Performance & Benchmarks
Granite uses a multi-layer fast path system that detects simple DTOs at class-load time and bypasses the full hydration pipeline (reflection, metadata, type conversion) entirely. For objects that qualify, the overhead vs plain PHP constructors is minimal.
Benchmark Results
Measured on PHP 8.5.10 with OPcache CLI enabled, using the median of 7 repetitions with 100,000 operations each:
| Scenario | µs/op | Improvement |
|---|---|---|
| Plain PHP constructor | 0.147 | control |
Granite::from(array) |
0.284 | — |
Granite::from(JSON) |
1.019 | 6.11x faster |
Granite::from(object) |
1.000 | 5.59x faster |
Granite::from(Granite) |
0.898 | 7.50x faster |
| Array-property DTO hydration | 0.201 | 11.69x faster |
| Validated DTO hydration | 4.691 | 1.96x faster |
Cached array() |
0.040 | 22.58x faster |
Cached nested array() |
0.040 | 31.56x faster |
| General array serialization | 1.175 | 1.39x faster |
| ObjectMapper to plain object | 1.869 | 1.11x faster |
| ObjectMapper to Granite | 1.550 | 1.14x faster |
Improvements compare the same benchmark against the pre-optimization baseline. Full samples and methodology are recorded in the performance optimization plan.
How it works
Granite's performance comes from three layers of optimization:
-
Capability-specific fast paths (
ClassProfile) — Hydration, serialization, and comparison are evaluated independently. Exact array properties can use constructor hydration while still using recursive general serialization. -
WeakMap caching —
array()andjson()results are read before repeating graph analysis and are cached only for deeply immutable graphs. Runtime serialization configuration invalidates cached values. - Compiled metadata — Reflection objects, validation attributes, validators, class date providers, and property transformers are reused across operations.
Classes that need conversion or custom naming use the general pipeline, with cached metadata and early exits for scalar values.
Running the Benchmarks
⚠️ Deprecation Notice
GraniteDTO was already deprecated before v2.0.0, and GraniteVO is deprecated as of v2.0.0, in favor of the unified Granite base class. Both still extend Granite for backward compatibility but will be removed in v3.0.0.
🔧 Requirements
- PHP 8.3+ — Takes advantage of modern PHP features
- No dependencies — Zero external dependencies for maximum compatibility
📦 Installation
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
📄 License
This package is open-sourced software licensed under the MIT license.
🙏 Credits
This project is developed and maintained by 🥷 Diego Rin in his free time.
If you find this project useful, please consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs and issues
- 💡 Suggesting new features
- 🔧 Contributing code improvements
Made with ❤️ for the PHP community
