نصب Yii در ویندوز و لینوکس؛ تفکیک Yii 2 و Yii3

نصب Yii در ویندوز و لینوکس با Composer انجام می‌شود، اما بستهٔ پروژه به شاخهٔ انتخاب‌شده وابسته است. آموزش قدیمی Yii 2 را نباید با فرمان‌های Yii3 مخلوط کرد. ابتدا نسخهٔ پروژه و PHP سازگار و پشتیبانی‌شده را تعیین کنید.

آماده‌کردن محیط توسعه

PHP خط فرمان و Composer باید در ترمینال همان حساب توسعه در دسترس باشند. در ویندوز ممکن است PHP وب‌سرور با نسخهٔ ترمینال متفاوت باشد؛ در لینوکس نیز بسته‌ها و افزونه‌ها را برای اجرای واقعی برنامه بررسی کنید. مستندات قدیمی Yii 2 از نسخه‌های تاریخی PHP نام می‌برند؛ حداقل قدیمی یک راهنما، توصیهٔ امنیتی برای استفادهٔ امروز نیست.

برای پروژهٔ موجود، composer.json و فایل قفل وابستگی‌ها را مبنا بگیرید. ساخت پروژهٔ جدید، جای روش ارتقای یک برنامهٔ فعال را نمی‌گیرد. پوشهٔ مقصد باید تازه و مستقل از سایت عملیاتی باشد.

آماده‌سازی جداگانهٔ Windows و Linux

Windows

1. PHP سازگار با شاخهٔ انتخابی Yii و افزونه‌های موردنیاز آن را نصب کنید. مسیر php.exe مورد استفادهٔ خط فرمان را مشخص کنید.
2. نصب‌کنندهٔ رسمی Composer-Setup.exe را از getcomposer.org دریافت کنید و PHP درست را به آن معرفی کنید. ترمینال قبلی را ببندید و ترمینال تازه باز کنید تا PATH جدید بارگذاری شود.
3. در PowerShell فرمان‌های زیر را اجرا کنید. نسخه‌ها و مسیر باید با محیط انتخابی پروژه هماهنگ باشند.

where.exe php
php -v
composer --version

Linux

1. PHP CLI و افزونه‌های لازم شاخهٔ Yii را با روش رسمی توزیع لینوکس خود نصب کنید. نسخهٔ PHP وب هاست را معادل نسخهٔ CLI فرض نکنید.
2. طبق صفحهٔ Download رسمی Composer، نصب‌کننده را دریافت و امضای آن را با مقدار جاری منتشرشده تطبیق دهید؛ سپس فایل composer.phar را بسازید. اگر نصب محلی است، از php composer.phar استفاده کنید؛ برای فرمان composer باید فایل در PATH قرار داشته باشد.
3. قبل از ساخت پروژه، فرمان‌های زیر را کنترل کنید.

command -v php
php -v
composer --version

اگر php یا composer پیدا نمی‌شود، ابتدا مسیر اجرایی و PATH را اصلاح کنید. خطای افزونهٔ PHP را با نصب افزونه در همین نسخهٔ CLI حل کنید؛ محدودیت‌های Composer را با نادیده‌گرفتن platform requirements پنهان نکنید. پس از آماده‌سازی، فقط دستور شاخهٔ Yii انتخابی در بخش نصب پروژه را ادامه دهید؛ تنظیمات Yii 2 و Yii3 را مخلوط نکنید.

مرجع: راهنمای نصب چندسیستمی Composer و دانلود و بررسی نصب‌کنندهٔ رسمی.

انتخاب فرمان متناسب با شاخه

برای قالب Basic در Yii 2، فرمان رسمی زیر یک پروژه در پوشهٔ basic می‌سازد:

composer create-project --prefer-dist yiisoft/yii2-app-basic basic

صفحهٔ دانلود رسمی Yii3 برای قالب وب فرمان جداگانه‌ای ارائه می‌کند:

composer create-project yiisoft/app my-project

یکی از مسیرها را متناسب با پروژه انتخاب کنید. راهنمای نصب و اجرای شاخهٔ انتخاب‌شده را ادامه دهید؛ تنظیمات، قالب‌ها و دستورهای اجرای دو شاخه را قابل جایگزینی فرض نکنید.

آزمون و مسیر عمومی سایت

برای آزمایش محلی Yii 2، در ریشهٔ پروژه می‌توان php yii serve را اجرا کرد و نتیجه را در localhost:8080 دید. این سرور توسعه، روش استقرار عمومی نیست. Document Root وب‌سرور برای پروژهٔ Basic باید به پوشهٔ web اشاره کند تا فایل‌های خصوصی هم‌سطح آن عمومی نشوند.

برای Yii3 از راهنمای اجرای محلی یا Docker همان قالب استفاده کنید. نیاز دیتابیس، افزونه‌های PHP و دسترسی پوشه‌ها را با خطاهای واقعی بررسی کنید؛ برای عبور از خطا همهٔ پوشه‌ها را قابل نوشتن عمومی نکنید.

Yii چیست و چه زمانی انتخاب می‌شود؟

Yii یک فریم‌ورک PHP برای ساخت برنامهٔ وب است. قالب آمادهٔ پروژه، ابزارها و ساختار برنامه به توسعه کمک می‌کنند؛ نصب فریم‌ورک به معنی ساخت خودکار یک سایت کامل یا تضمین سرعت و امنیت نیست. انتخاب آن باید با مهارت تیم، نیاز برنامه و امکان نگهداری هماهنگ باشد.

برای برنامهٔ موجود، شاخه و وابستگی‌های واقعی را بررسی کنید؛ نام مشترک Yii دلیل سازگاری کد Yii 2 با Yii3 نیست. برای پروژهٔ تازه، مستندات و قالب همان شاخه را از سایت رسمی شروع کنید. تغییر فریم‌ورک پروژهٔ فعال نیاز به بررسی معماری و مهاجرت دارد و با اجرای فرمان نصب حل نمی‌شود.