الخرائط Associative Arrays

Associative Arrays

مفهوم ~18 دقيقة

الخرائط — Associative Arrays

الـ associative array تربط مفتاحاً بقيمة. بدلاً من قائمة مرتبة، لديك خريطة مثل status["nginx"]="running". يجب تعريفها أولاً بـdeclare -A status. هذه البنية مفيدة عندما تريد ربط اسم خدمة بحالتها، أو اسم ملف بعدد، أو خيار بوصف.

تحتاج Bash 4 أو أحدث لهذه الميزة. على macOS القديم قد تكون Bash الافتراضية 3.2، لذلك قابلية النقل مهمة. بما أن هذا مسار تعلم Bash حديث، نستخدمها، لكن في سكربتات إنتاجية متعددة الأنظمة تحقق من الإصدار أو استخدم صيغة أبسط.

فحص الإصدار على macOS

macOS يُشحن بـBash 3.2 افتراضياً (لأسباب ترخيص). declare -A لا تعمل عليه. إذا شغّلت سكربتاً يستخدمها على Bash 3.2، ستحصل على خطأ غامض. أضف فحصاً صريحاً في بداية أي سكربت يعتمد على هذه الميزة:

script.sh

#!/usr/bin/env bash

# تحقق من إصدار Bash — Check Bash version
if (( BASH_VERSINFO[0] < 4 )); then
  echo "هذا السكربت يحتاج Bash 4+. إصدارك: $BASH_VERSION" >&2
  echo "على macOS:" >&2
  echo "    brew install bash" >&2
  echo "    /opt/homebrew/bin/bash $0" >&2
  exit 2
fi

# الآن آمن لاستخدام declare -A
declare -A config=(
  ["env"]="production"
  ["region"]="sa"
)
echo "env=${config[env]}"

Output:

تثبيت Bash 4+ على macOS

brew install bash

بعد التثبيت يكون في /opt/homebrew/bin/bash (Apple Silicon) أو /usr/local/bin/bash (Intel). غيّر السطر الأول من سكربتاتك:

#!/usr/bin/env bash

env bash يختار أول bash في $PATH، وإذا أضفت مجلد Homebrew لأول $PATH (ما تفعله الإعدادات الافتراضية لـHomebrew)، ستُشغّل Bash 4+ تلقائياً.

للتحقق من الإصدار المستخدم فعلاً:

bash --version

عند المرور على المفاتيح، استخدم "${!map[@]}". الترتيب غير مضمون دائماً، لذلك لا تعتمد عليه لتقرير يحتاج ترتيباً ثابتاً إلا إذا رتبت المفاتيح.

مثال عملي

script.sh

#!/usr/bin/env bash
set -euo pipefail

# اربط خدمة بحالتها — Map service to status
declare -A status=(
	["nginx"]="running"
	["backup"]="idle"
	["worker"]="degraded"
)

for service in "${!status[@]}"; do
	echo "$service=${status[$service]}"
done

Output:

لاحظ أن قراءة القيمة تستخدم المفتاح: ${status[$service]}. اقتبس المفتاح إذا كان يأتي من متغير.

متى تكفي؟

إذا كانت الخريطة صغيرة وتعيش داخل السكربت، هذا مناسب. إذا كانت البيانات تتغير كثيراً أو تحتاج بحثاً وتحديثاً وحفظاً دائماً، استخدم ملفاً منظماً أو قاعدة بيانات.

تحدي — Challenge

#!/usr/bin/env bash
set -euo pipefail

declare -A users=(
	["aziz"]="admin"
)

# اطبع role=<القيمة> — Print role=<value>