Macroable Laravel Package

Product Decisions This Supports

• Developer Productivity & Code Reusability: Enables teams to extend Hyperf’s core classes (e.g., collections, strings, or custom objects) with reusable, domain-specific macros—reducing boilerplate and accelerating feature development.
• Consistency in Custom Logic: Standardizes how custom behaviors (e.g., query builders, validation helpers, or domain-specific transformations) are applied across the codebase, aligning with Laravel’s macro pattern.
• Roadmap for Hyperf Adoption: Justifies investing in Hyperf as a Laravel alternative by leveraging familiar patterns (e.g., macros) for PHP developers migrating from Laravel or building new high-performance applications.
• Build vs. Buy: Avoids reinventing macro functionality from scratch, saving engineering time while maintaining flexibility to customize behavior.
• Use Cases:
  • Extending Hyperf’s Collection class with domain-specific methods (e.g., calculateRevenue() for e-commerce).
  • Adding reusable validation or transformation logic to request/response objects.
  • Simplifying complex operations in microservices (e.g., custom query scopes or payload transformations).

When to Consider This Package

• Adopt if:
  • Your team is using Hyperf and needs to extend core classes with reusable logic (e.g., collections, strings, or custom objects).
  • You prioritize developer velocity and want to avoid repetitive code while keeping logic centralized.
  • Your application requires domain-specific extensions (e.g., custom query macros, validation helpers) that align with Laravel’s macro pattern.
  • You’re migrating from Laravel and want to leverage familiar patterns in Hyperf.
• Look elsewhere if:
  • Your team is not using Hyperf (this package is Hyperf-specific).
  • You need enterprise-grade support (low stars/dependents may indicate limited community adoption).
  • Your use case requires highly specialized macros that aren’t covered by the package’s core functionality (may need custom development).
  • You’re evaluating alternative frameworks (e.g., Symfony, Swoole) that don’t support this pattern natively.

How to Pitch It (Stakeholders)

For Executives: "This package lets our Hyperf-based applications extend core functionality with reusable, domain-specific macros—just like Laravel’s macro system. It’s a lightweight way to boost developer productivity by eliminating boilerplate code for common operations (e.g., collections, validation, or queries). With minimal overhead, we can standardize custom logic across the codebase, reduce technical debt, and accelerate feature delivery—all while leveraging Hyperf’s high performance. It’s a strategic fit if we’re committed to Hyperf, as it aligns with Laravel’s familiar patterns for teams migrating or building new systems."

For Engineering: *"The hyperf/macroable package brings Laravel’s macro system to Hyperf, enabling us to dynamically extend classes like Collection, String, or custom objects with reusable methods. For example:

• Collections: Add groupByDate() or calculateMetrics() without subclassing.
• Requests/Responses: Inject domain-specific transformations (e.g., sanitizePayload()).
• Query Builders: Define reusable scopes or conditions. This avoids code duplication, makes logic easier to maintain, and keeps our Hyperf apps consistent with Laravel’s ecosystem. The MIT license and active development (recent 3.2.x releases) make it a low-risk choice for Hyperf projects."*