نصب و راه اندازی جنگو

محیط مجازی

قبل از اینکه ما جنگو را نصب کنیم، ابزاری بسیار پراستفاده به شما می‌دهیم تا با نصب آن محیط برنامه نویسی خود را بر روی کامپیوترتان تمیز و مرتب نگه دارید. می‌توانید برای ادامه کار از این مرحله صرف نظر کنید اما استفاده از آن بسیار توصیه می‌شود. شروع کار با تنظیمات مناسب جلوی بسیاری از مشکلات در آینده را می‌گیرد!

بنابراین، اجازه دهید یک محیط مجازی یا virtual environment بسازیم (همچنین به آن virtualenv هم گفته می‌شود). محیط مجازی، تنظیمات پایتون/جنگو را برای هر پروژه و جدا از دیگر پروژه‌ها، قرنطینه و حفظ خواهد کرد. یعنی هر تغییری که در تنظیمات یک وبسایت انجام می‌دهید، بر روی دیگر وبسایت‌هایی که در حال توسعه آن‌ها هستید تاثیر نخواهد گذاشت. تمیز و مرتب، اینطور نیست؟

آنچه شما باید انجام دهید این است که یک پوشه را پیدا کنید که در آن می‌خواهید محیط مجازی را ایجاد کنید. برای مثال، پوشه home. در ویندوز، چیزی شبیه C:\Users\Name است (که در آن Name نام کاربری شما است که با آن وارد ویندوز شده‌اید).

نکته: در ویندوز اطمینان حاصل کنید که نام این پوشه حاوی کاراکترهای خاص یا دارای اعراب نیست؛ اگر نام کاربری شما دارای کاراکترهای خاص است، از یک پوشه دیگر استفاده کنید، به عنوان مثال C:\djangogirls.

برای این آموزش ما از یک پوشه جدید djangogirls در پوشه اصلی شما استفاده خواهیم کرد:

$ mkdir djangogirls
$ cd djangogirls

ما یک محیط مجازی به نام myvenv خواهیم ساخت. فرمان کلی در این قالب خواهد بود:

$ python3 -m venv myvenv

Windows

برای ایجاد یک محیط مجازی جدید، باید کنسول خط فرمان را باز کنید و دستور <python -m venv myvenv را اجرا کنید. شبیه این خواهد شد:

C:\Users\Name\djangogirls> python -m venv myvenv

در اینجا myvenv نام محیط مجازی شماست. می‌توانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس، اعراب گذاری و کاراکترهای خاص استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!

Linux and macOS

می‌توانیم با دستور python3 -m venv myvenv هم در لینوکس و هم در macOS محیط مجازی بسازیم. شبیه این خواهد بود:

$ python3 -m venv myvenv

نام محیط مجازی شما، myvenv است. می‌توانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!

نکته: در بعضی نسخه‌های دبیان/اوبونتو ممکن است چنین پیغام خطایی دریافت کنید:

The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.

$ apt install python3-venv

You may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.

در این موارد دستورالعمل داده شده در بالا را دنبال کنید. پکیج python3-venv را نصب کنید:

$ sudo apt install python3-venv

نکته: در بعضی نسخه‌های دبیان/اوبونتو ساختن محیط مجازی با این دستور ممکن است باعث چنین خطایی بشود:

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

برای حل این مشکل، از دستور virtualenv استفاده کنید.

$ sudo apt install python-virtualenv
$ virtualenv --python=python3.14 myvenv

نکته: اگر چنین خطایی گرفتید

E: Unable to locate package python3-venv

در عوض از این دستور استفاده کنید:

sudo apt install python3.14-venv

کار کردن با محیط مجازی

دستور بالا یک پوشه به نام myvenv می‌سازد (یا هر نام دیگری که شما گذاشته باشید) که شامل محیط مجازی ماست (درواقع مجموعه‌ای از پوشه‌ها و فایل‌ها).

Windows

محیط مجازی خود را با اجرای دستور زیر فعال کنید:

C:\Users\Name\djangogirls> myvenv\Scripts\activate

نکته: در ویندوز 10 و در هنگام استفاده از Windows PowerShell ممکن است با این خطا مواجه شوید execution of scripts is disabled on this system. در این شرایط یک بار دیگر Windows PowerShell را با گزینه “Run as Administrator” اجرا کنید. سپس دستورات زیر را قبل از فعال کردن محیط مجازی خود، اجرا کنید:

C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Execution Policy Change The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is “N”): A

نکته: برای کاربران ویرایشگر VS Code که درون خود یک ترمینال خط فرمان منطبق بر PowerShell ویندوز دارد، اگر بخواهید از این ترمینال استفاده کنید باید این دستور را برای فعال کردن محیط مجازی خود بزنید:

$ . myvenv\Scripts\activate.ps1

مزیت آن این است که لازم نیست بین پنجره ویرایشگر کد و پنجره خط فرمان جابجا شوید

Linux and macOS

محیط مجازی خود را با اجرای دستور زیر فعال کنید:

$ source myvenv/bin/activate

به یاد داشته باشید که myvenv را با نامی که برای محیط مجازی خود انتخاب کرده‌اید عوض کنید!

نکته: گاهی اوقات ممکن است دستور source در دسترس نباشد. در این مواقع دستور زیر را امتحان کنید:

$ . myvenv/bin/activate

هنگامی که پیشوند (myvenv) در کنسول خط فرمان اضافه شود به معنی آن است که محیط مجازی شما فعال شده است.

وقتی درون یک محیط مجازی کار می‌کنید کلمه python به صورت اتوماتیک به نسخه صحیح پایتون ارجاع می‌دهد در نتیجه می‌توانید به جای python3 از python استفاده کنید.

بسیار خوب، ما همه نیازمندی‌ها را داریم حالا می‌توانیم جنگو را نصب کنیم!

نصب جنگو

حالا که محیط مجازی شما فعال شده است می‌توانید جنگو را نصب کنید.

قبل از آن باید مطمئن شویم که آخرین نسخه pip که برای نصب جنگو استفاده می‌شود را داریم:

(myvenv) ~$ python -m pip install --upgrade pip

نصب پکیج‌ها و پیش‌نیازهایشان

یک فایل پیش‌نیازها شامل لیستی از پکیج‌های وابسته است که باید به کمک pip install نصب شوند:

در ابتدا یک فایل requirements.txt در پوشه djangogirls/ بسازید. معمولاً می‌توانید از خود ویرایشگر کد که قبل‌تر نصب کرده‌اید هم برای ساختن فایل جدید استفاده کنید. یک فایل جدید در ویرایشگر کد بسازید و سپس به نام requirements.txtدر پوشه djangogirls/ ذخیره‌اش کنید. پوشه شما شبیه این خواهد بود:

djangogirls
├── myvenv
│   └── ...
└───requirements.txt

در فایل djangogirls/requirements.txt باید خط زیر را اضافه کنید:

Django~=5.2.18

حالا دستور pip install -r requirements.txt را اجرا کنید تا جنگو نصب شود.

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=5.2.18 (from -r requirements.txt (line 1))
    Downloading Django-5.2.18-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-5.2.18

Windows

اگر در هنگام اجرای دستور pip در ویندوز خطایی دریافت کردید لطفاً کنترل کنید که در مسیر نام پوشه‌ها هیچ پوشه‌ای اسپیس، اعراب گذاری یا کارکتر خاص در نام خود نداشته باشد (مثلا مانند این C:\Users\User Name\djangogirls). اگر چنین است لطفاً از مسیری استفاده کنید که در آن اسپیس به کار نرفته باشد (مثلا چنین مسیری C:\djangogirls). یک محیط مجازی در پوشه جدید درست کنید سپس محیط مجازی قبلی را پاک کنید و دستور بالا را دوباره اجرا کنید. (جابجا کردن پوشه مربوط به محیط مجازی ایده خوبی نیست و باعث می‌شود محیط مجازی کار نکند. محیط مجازی با آدرس مطلق کار می‌کند)

Windows 8 and Windows 10

ممکن است کنسول خط فرمان شما بعد از اجرای دستور فوق ثابت و بی‌حرکت شود. اگر چنین اتفاقی افتاد به جای دستور بالا از خط زیر استفاده کنید:

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt

Linux

اگر هنگام اجرای دستور pip بر روی اوبونتو نسخه 12.04 پیغام خطا گرفتید از دستور python -m pip install -U --force-reinstall pip برای اصلاح پکیج pip در محیط مجازی استفاده کنید.

عالی! بالاخره در نهایت آماده شدید تا یک برنامه جنگو بسازید!