Skip to content

Breaking Changes in 2.0.0

⚠️ IMPORTANT: Read Before Upgrading

Version 2.0.0 introduces breaking changes that require action before upgrading from 1.x.

Prerequisites

1. Process All Pending Queue Items (REQUIRED)

Before upgrading, you MUST process all pending translation queue items:

# Check for pending items
drush queue:list

# Process all pending items
drush queue:run tmgmt_laratranslate_worker

# Verify queue is empty
drush queue:list

⚠️ WARNING: Any unprocessed queue items will be LOST after the upgrade. These job items will remain stuck in "Active" state with no way to complete.

2. Install New Dependency (REQUIRED)

Version 2.0.0 requires the sm (Symfony Messenger) module:

composer require drupal/sm
# Enable the module AFTER upgrading TMGMT Lara Translate to 2.0.0
drush en sm

What Changed

Architecture Change

  • Removed: Drupal Queue API (tmgmt_laratranslate_worker queue)
  • Added: Symfony Messenger for asynchronous processing
  • Impact: Old queue items cannot be automatically migrated

New Features in 2.0.0

  • Modern message-based architecture
  • Built-in retry mechanisms with exponential backoff
  • Support for multiple transport backends (Redis, AMQP, SQS)
  • Better monitoring and debugging capabilities

Upgrade Checklist

  • [ ] Process all pending queue items: drush queue:run tmgmt_laratranslate_worker
  • [ ] Verify queue is empty: drush queue:list
  • [ ] Backup your database (recommended)
  • [ ] Update composer: composer require drupal/tmgmt_laratranslate:^2.0
  • [ ] Enable SM module: drush en sm
  • [ ] Run database updates: drush updb
  • [ ] Clear caches: drush cr
  • [ ] Verify messenger is working: drush messenger:info

Post-Upgrade

New Monitoring Commands

# Check messenger status
drush messenger:info

# Process messages manually
drush messenger:consume async --limit=10

# Check for failed messages
drush messenger:failed:show

Rollback Plan

If you need to rollback to 1.x:

  1. Restore database from backup
  2. Downgrade module: composer require drupal/tmgmt_laratranslate:^1.0
  3. Re-process any queue items that were pending at backup time

Support

For issues during upgrade: - Check logs: drush watchdog:show --type=tmgmt_laratranslate - Review troubleshooting guide - Report issues: Drupal.org issue queue