Deprecate annotation-specific properties in the Sluggable extension annotation/attribute classes

[mbabker]

When attributes support was added, the way slug handlers were configured was changed between annotations and attributes. With annotations support now fully deprecated, it doesn't make sense to continue supporting annotation-specific config paths, so this PR deprecates the annotation style slug handler configuration. Specifically, this will:

• Deprecate the Slug attribute's $handlers property, slug handlers are now configured through property-level attributes
• Deprecate the SlugHandlerOption class entirely, it is unused by the attribute driver in favor of providing the options as an associative array on the SlugHandler attribute

Below example (taken right out of the docs) is the same configuration for a field using both annotations and attributes to give a visual reference.

/**
 * @ORM\Column(type="string", unique=true)
 * @Gedmo\Slug(
 *   fields={"title"},
 *   handlers={
 *     @Gedmo\SlugHandler(
 *       class="Gedmo\Sluggable\Handler\TreeSlugHandler",
 *       options={
 *         @Gedmo\SlugHandlerOption(name="parentRelationField", value="category"),
 *         @Gedmo\SlugHandlerOption(name="separator", value="/")
 *       }
 *     )
 *   }
 * )
 */
#[ORM\Column(type: Types::STRING, unique: true)]
#[Gedmo\Slug(fields: ['title'])]
#[Gedmo\SlugHandler(class: TreeSlugHandler::class, options: ['parentRelationField' => 'category', 'separator' => '/'])]
public ?string $slug = null;

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 78.66%. Comparing base (0ad4856) to head (c19083f).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2837   +/-   ##
=======================================
  Coverage   78.66%   78.66%           
=======================================
  Files         167      167           
  Lines        8746     8746           
=======================================
  Hits         6880     6880           
  Misses       1866     1866           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[phansys]

Thanks @mbabker!

Could you please add an entry at CHANGELOG.md for these deprecations?

[mbabker]

Could you please add an entry at CHANGELOG.md for these deprecations?

Added

[phansys]

Thank you @mbabker!