Laravel Natural Where Laravel Package

Product Decisions This Supports

• Feature delivery: Enables expressive query composition through a naturalOrWhere macro, reducing boilerplate for conditional OR clauses in admin filters, reporting, and search endpoints.
• Roadmap and platform strategy: The release supports Laravel 13 while retaining Laravel 5.6 and Laravel 8 compatibility, making it viable for mixed-version estates and reducing migration friction during framework upgrades.
• Build vs. buy: For teams that repeatedly need natural orWhere composition, adopting this package avoids maintaining a custom macro. For one-off query needs, Laravel’s native query builder is sufficient.
• Developer experience: The fix ensuring naturalOrWhere returns the query builder result improves chainability and composability, reducing workaround code and making query logic easier to test and maintain.

When to Consider This Package

• Adopt when the product runs on Laravel 5.6 through Laravel 13 and needs a consistent, reusable naturalOrWhere macro across legacy and modern services.
• Consider it when teams want fewer custom query-builder helpers and more predictable composition in complex filtering logic.
• Look elsewhere if requirements include full natural-language query parsing, user-facing query input, advanced search semantics, or security-sensitive query construction.
• Avoid adoption if standard where/orWhere already covers your use cases, or if the package’s maintenance cadence and test coverage cannot be validated.

How to Pitch It (Stakeholders)

• Executives: A low-risk, narrow-scope dependency that improves developer productivity and reduces framework-upgrade friction by supporting Laravel 5.6 through 13.
• Engineering: v3.1.0 adds Laravel 13 support and fixes naturalOrWhere to return the query builder result, improving chainability. Evaluate test coverage, maintenance activity, and compatibility matrix before standardizing on it.