متغيرات البيئة

متغيرات البيئة تخزن قيم التكوين خارج الكود. هذا أمر حاسم لتطوير الذكاء الاصطناعي حيث ستعمل مع مفاتيح API التي يجب أن تبقى سرية.

لماذا لا نضع المفاتيح في الكود؟

# لا تفعل هذا أبداً!
client = OpenAI(api_key="sk-abc123...")  # مكشوف في الكود!

إذا قمت بإرسال هذا إلى git، سيتم اختراق مفتاحك. متغيرات البيئة تحل هذا.

استخدام ملفات .env

حزمة python-dotenv تحمّل المتغيرات من ملف .env.

التثبيت

pip install python-dotenv

إنشاء ملف .env

# ملف .env (في جذر مشروعك)
OPENAI_API_KEY=sk-your-key-here
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEBUG=true

التحميل في بايثون

from dotenv import load_dotenv
import os

# تحميل المتغيرات من ملف .env
load_dotenv()

# الوصول إلى المتغيرات
api_key = os.getenv("OPENAI_API_KEY")
debug = os.getenv("DEBUG", "false")  # "false" هي القيمة الافتراضية

أفضل ممارسات الأمان

1. أضف .env إلى .gitignore

# .gitignore
.env
.env.local
*.env

2. أنشئ قالباً

شارك ملف .env.example بدون قيم حقيقية:

# .env.example
OPENAI_API_KEY=your-key-here
ANTHROPIC_API_KEY=your-key-here

3. تحقق من المتغيرات المطلوبة

import os
import sys

required_vars = ["OPENAI_API_KEY"]

for var in required_vars:
    if not os.getenv(var):
        print(f"خطأ: {var} غير معيّن")
        sys.exit(1)

مرجع سريع

المهمة	الأمر
تثبيت dotenv	pip install python-dotenv
تحميل .env	load_dotenv()
الحصول على متغير	os.getenv("KEY")
الحصول مع قيمة افتراضية	os.getenv("KEY", "default")

لقد أكملت وحدة إعداد البيئة! بعد ذلك، سنغوص في هياكل بيانات بايثون. :::