Skip to content

1.0.0-rc1

Choose a tag to compare

View all tags
@koriym koriym released this 01 Aug 06:27
· 129 commits to 1.x since this release
v1.0.0-rc1
662b7ef
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

1.0.0-rc1 Release Notes

Major Release Candidate - Modernized Architecture

We're excited to announce the first release candidate for Ray.MediaQuery 1.0.0! This major release modernizes the framework with a focus on PHP 8+ attributes, improved separation of concerns, and enhanced developer experience.

What's New

Attributes-Only Support

  • Full migration to PHP 8 Attributes: All @DbQuery and @Pager annotations have been replaced with modern #[DbQuery] and #[Pager] attributes
  • Rector integration: Automatic migration tooling available via vendor/bin/rector process
  • Improved IDE support: Better autocomplete, refactoring, and type checking with native PHP attributes

Separated Web API Functionality

  • New dedicated package: Web API functionality moved to ray/web-query
  • Cleaner architecture: Core database functionality separated from web concerns
  • Focused development: Each package can evolve independently with specialized features

Enhanced Documentation

  • Business Domain Repository (BDR) Pattern: Comprehensive guide to transforming database queries into rich domain objects
  • Japanese documentation: Full localization for Japanese developers
  • Improved README: Clearer examples and better organization

Breaking Changes

Required Migration Steps

For users with Web API queries:

composer require ray/web-query

Update your module configuration to use the new MediaQueryWebModule.

For annotation users:

// Old annotation syntax (deprecated)
/** @DbQuery("user_list") */

// New attribute syntax (required)
#[DbQuery('user_list')]

For CamelCaseTrait users:
Replace with constructor property promotion and StringCase utility.

Removed Components

  • WebQueryInterceptor, WebApiQuery, WebQueryConfig
  • MediaQueryWebModule, WebApiQueryInterface
  • WebQuery annotation, WebApiList qualifier
  • CamelCaseTrait (replaced with StringCase utility)
  • Dependencies: guzzlehttp/guzzle, psr/http-message, doctrine/annotations

Migration Guide

DB-only users: No changes required - your existing code continues to work!

Comprehensive migration support:

  • Detailed migration guide in MIGRATION.md
  • Automated tooling via Rector
  • Backward compatibility preserved for core database functionality

Current Status

This is a Release Candidate - we're seeking community feedback before the final 1.0.0 release. The API is stable and production-ready, but we welcome testing and feedback from the community.

Assets 2
Loading