Attributes Laravel Package

Product Decisions This Supports

• Metadata-Driven Development: Enables declarative configuration via PHP 8 Attributes (e.g., defining API routes, validation rules, or middleware without annotations or XML/YAML).
• Laravel Ecosystem Integration: Supports "build vs. buy" for custom metadata handling (e.g., replacing manual arrays or third-party packages like doctrine/annotations).
• Roadmap for PHP 8+ Features: Aligns with modern PHP practices (e.g., replacing legacy annotation parsers or custom reflection logic).
• Use Cases:
  • Dynamic route/middleware resolution (e.g., @Route, @Middleware).
  • Runtime validation (e.g., @Validate for DTOs).
  • Dependency injection hints (e.g., @Inject for service locator patterns).
  • Plugin/extension systems (e.g., @Extension for modular architectures).

When to Consider This Package

• Adopt if:
  • Your team uses PHP 8+ and wants to leverage native Attributes for metadata.
  • You’re replacing Doctrine Annotations, Symfony Attributes, or custom reflection logic.
  • You need a lightweight, Laravel-compatible alternative to heavy frameworks (e.g., Symfony’s Attribute system).
  • Your use case requires runtime attribute resolution (e.g., dynamic class scanning, AOP-like behavior).
• Look elsewhere if:
  • You’re on PHP < 8.0 (Attributes require PHP 8+).
  • You need enterprise-grade support (this package has minimal adoption; prefer Symfony’s Attribute or Doctrine’s Common).
  • Your metadata needs are static (e.g., compile-time generation via PHP 8.1 Attributes + Attribute::TARGET_CLASS).
  • You require active maintenance (low stars/dependents suggest niche or experimental status).

How to Pitch It (Stakeholders)

For Executives: "This package lets us replace verbose annotation parsers or manual metadata handling with native PHP 8 Attributes—reducing boilerplate, improving type safety, and future-proofing our codebase. For example, we could auto-generate API routes or validation rules from class attributes, cutting dev time by 30% while aligning with modern PHP standards. Low risk: MIT-licensed and Laravel-compatible."

For Engineers: *"Windwalker/Attributes provides a clean, reflection-based way to resolve PHP 8 Attributes at runtime—ideal for:

• Dynamic routing: Replace @Route annotations with native #[Route].
• Validation: Attach rules to DTOs via #[Validate].
• Middleware: Auto-apply middleware via #[Middleware]. It’s lighter than Symfony’s Attribute system and integrates seamlessly with Laravel. Tradeoff: Early-stage (0 dependents), but the API is stable and MIT-licensed. Proposal: Pilot in a non-critical module first."*