Files
amneziavpnphp/migrations
infosave2007 b6cf9cbab7 Add traffic limit functionality
- Add traffic_limit field to vpn_clients table (migration 007)
- Add traffic limit management methods in VpnClient class
- Add API endpoints: set-traffic-limit, traffic-limit-status, overlimit
- Add UI for setting limits when creating clients
- Add traffic limit column in clients table with visual indicators
- Add automatic traffic limit check via cron (bin/check_traffic_limits.php)
- Add translations for traffic limits (6 languages)
- Update README with traffic limit documentation
2025-11-08 09:56:25 +03:00
..
2025-11-08 09:56:25 +03:00

Database Migrations

This directory contains SQL migration files that are automatically executed when the database container is first initialized.

Execution Order

Migration files are executed in alphabetical order by MySQL's Docker entrypoint. Files are numbered to ensure correct execution sequence:

  1. 001_init.sql - Main database schema and tables
  2. 002_translations_ru.sql - Russian translations
  3. 003_translations_es.sql - Spanish translations
  4. 004_translations_de.sql - German translations
  5. 005_translations_fr.sql - French translations
  6. 006_translations_zh.sql - Chinese translations

Adding New Migrations

When creating new migration files:

  1. Use numerical prefix (e.g., 007_add_feature.sql)
  2. Ensure the number is higher than existing migrations
  3. Use descriptive names
  4. Always use ON DUPLICATE KEY UPDATE for INSERT statements to make migrations idempotent

Manual Execution

To manually run migrations in an existing database:

# Single migration
docker compose exec db mysql -uroot -prootpassword amnezia_panel < migrations/001_init.sql

# All migrations in order
for file in migrations/*.sql; do
  echo "Executing $file..."
  docker compose exec -T db mysql -uroot -prootpassword amnezia_panel < "$file"
done

Regenerating Translation Migrations

To regenerate translation migrations from the current database:

# Export translations for a specific language
docker compose exec -T db mysql -uroot -prootpassword amnezia_panel \
  --default-character-set=utf8mb4 \
  -e "SELECT CONCAT('(''', language_code, ''', ''', translation_key, ''', ''', 
      REPLACE(translation_value, '''', ''''''), '''),') 
      FROM translations WHERE language_code = 'ru' ORDER BY translation_key;" \
  | grep -v "CONCAT" > /tmp/translations_ru.sql

# Then wrap with INSERT statement and ON DUPLICATE KEY UPDATE