نصب Yii در ویندوز و لینوکس با Composer انجام می‌شود، اما بستهٔ پروژه به شاخهٔ انتخاب‌شده وابسته است. آموزش قدیمی Yii 2 را نباید با فرمان‌های Yii3 مخلوط کرد. ابتدا نسخهٔ پروژه و PHP سازگار و پشتیبانی‌شده را تعیین کنید.
آماده‌کردن محیط توسعه
PHP خط فرمان و Composer باید در ترمینال همان حساب توسعه در دسترس باشند. در ویندوز ممکن است PHP وب‌سرور با نسخهٔ ترمینال متفاوت باشد؛ در لینوکس نیز بسته‌ها و افزونه‌ها را برای اجرای واقعی برنامه بررسی کنید. مستندات قدیمی Yii 2 از نسخه‌های تاریخی PHP نام می‌برند؛ حداقل قدیمی یک راهنما، توصیهٔ امنیتی برای استفادهٔ امروز نیست.
برای پروژهٔ موجود، composer.json و فایل قفل وابستگی‌ها را مبنا بگیرید. ساخت پروژهٔ جدید، جای روش ارتقای یک برنامهٔ فعال را نمی‌گیرد. پوشهٔ مقصد باید تازه و مستقل از سایت عملیاتی باشد.
انتخاب فرمان متناسب با شاخه
برای قالب 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 نیست. برای پروژهٔ تازه، مستندات و قالب همان شاخه را از سایت رسمی شروع کنید. تغییر فریم‌ورک پروژهٔ فعال نیاز به بررسی معماری و مهاجرت دارد و با اجرای فرمان نصب حل نمی‌شود.
