Search Bundle Laravel Package

Product Decisions This Supports

• Build vs. Buy: Justifies a buy decision for full-text search in Symfony/Laravel applications where external dependencies (e.g., Elasticsearch, Algolia) are undesirable. Avoids operational overhead of managing third-party services.
• Roadmap: Enables rapid development of search-heavy features (e.g., e-commerce product search, content discovery) without blocking on infrastructure decisions.
• Use Cases:
  • Internal tools needing lightweight, self-hosted search (e.g., admin dashboards, documentation portals).
  • Prototyping search functionality before committing to scalable solutions (e.g., Elasticsearch).
  • Applications with low-to-moderate search volume where MySQL’s MATCH AGAINST suffices.
• Feature Prioritization: Accelerates MVP delivery for search-driven products by reducing backend complexity.

When to Consider This Package

• Adopt if:
  • Your app uses Symfony 6.0+ and PHP 8.1+ with Doctrine ORM.
  • You need basic full-text search without external APIs or databases.
  • Your search queries are simple (e.g., keyword matching, no advanced analytics).
  • You’re self-hosted and want to avoid managed services (cost, latency, or compliance constraints).
  • Your dataset is small-to-medium (performance degrades with large tables).
• Look elsewhere if:
  • You require scalable search (e.g., >100K records) or fuzzy matching (wildcards beyond *).
  • Your app needs geospatial search, facets, or aggregations (use Elasticsearch/Algolia).
  • You’re using Laravel (this is Symfony-specific; Laravel alternatives like Scout or Algolia are better fits).
  • Your team lacks MySQL tuning expertise (performance depends on proper FULLTEXT indexes).
  • You need real-time indexing (this requires manual populate commands).

How to Pitch It (Stakeholders)

For Executives: "This package lets us add search to [Product] without third-party costs or complexity. By leveraging MySQL’s built-in full-text search, we avoid vendor lock-in and reduce operational overhead. Ideal for MVP phases or internal tools where simplicity trumps scalability. Estimated dev time: 2–4 hours for integration vs. weeks with Elasticsearch."

For Engineering: *"Araise Search Bundle provides a lightweight, Doctrine-native full-text search solution for Symfony. Key benefits:

• No external dependencies: Uses MySQL’s MATCH AGAINST (configured via Doctrine DQL).
• Flexible indexing: Annotate entities or configure via YAML; supports custom formatters (e.g., dates) and search hooks.
• Low maintenance: Single CLI command (araise:search:populate) to update indexes.
• Symfony-native: Integrates with existing Doctrine workflows (e.g., repositories, query builders). Trade-offs: Limited to basic search; not suitable for high-scale or complex queries. Recommended for prototypes or small-to-medium datasets."*

For Developers: *"Drop-in search for Doctrine entities with zero setup beyond:

1. Add [Index] annotations to fields.
2. Run php bin/console araise:search:populate.
3. Query via IndexRepository (e.g., $indexRepo->search('query', Post::class)). Pro tip: Use asterisk_search_enabled: true in config for wildcard support (*)."*