Как установить и скачать Yii2: руководство по установке фреймворка

Процесс установки Yii2 на сервер, включая подготовку серверной платформы, настройку компонентов и скачивание всех нужных файлов. Основные этапы проверки PHP, установки Composer и настройки прав доступа.

Yii2 — программный набор для удобной и быстрой работы веб-сайтов. Другими словам — «фреймворк». Он включает в себя заранее подготовленные компоненты и функции. Работает на языке PHP, популярном в создании интерактивных сайтов.

С Yii2 не нужно писать всё с нуля — есть готовые блоки и модули.

Не обладая знаниями в информационных технологиях, будет сложно воспользоваться этим инструментом сходу. Поэтому рассмотрим возможные проблемы, с простыми пояснениями и решениями.

Запуск Yii2

Для размещения данных понадобится выделенный или виртуальный сервер, либо отдельный компьютер.

Минимальные требования:

версия PHP не ниже 7.4;
система хранения информации MySQL или PostgreSQL;
дополнительные расширения PHP mbstring и openssl.

В серверной инфраструктуре потребуется веб-сервис (например, Apache или Nginx), который обеспечит доступ ресурсу в интернете.

Проверка и установка PHP

1. Войдите в терминал:

на Windows используйте программу PuTTY или командную строку для удалённого доступа;
на Linux и macOS — через встроенное приложение «Terminal».

2. Для проверки версии PHP введите:

   php -v

На экране увидите информацию о ней.

Если же появится сообщение об ошибке, PHP нужно установить. Параметры зависят от ОС.

Ubuntu:

sudo apt install php

CentOS:

sudo yum install php

На запрос подтверждения ответьте «y» или «да» и нажмите Enter. Затем повторно выполните команду php -v, чтобы проверить наличие PHP.

Конфигурация

Для работы Yii2 нужно указать правильный путь к ресурсам фреймворка в настройках веб-сервера (Apache или Nginx). В случае с Nginx это делается путём указания директории my_project/web в конфигурации, чтобы ограничить доступ к важным файлам и улучшить безопасность. Это обеспечит правильное функционирование страницы по заданному URL.

Аренда VPS/VDS от AdminVPS с опцией «Всё включено» избавит вас от необходимости администрировать сервер. Все заботы возьмут на себя технические специалисты хостинга. Оцените преимущества:

бесплатное администрирование,
быстрые NVMe-диски,
качественную и быструю техподдержку,
защиту от DDoS-атак,
доступную цену.

Выбрать VPS

Установка Composer

Composer, программа управления компонентами, скачивает и устанавливает нужные файлы и расширения, избавляя от необходимости делать это вручную.

1. Подключитесь к серверу (если работаете удалённо) через SSH:

ssh ваш_пользователь@ip_адрес_сервера

2. Установите Composer. Введите поочерёдно:

   curl -sS https://getcomposer.org/installer | php
   sudo mv composer.phar /usr/local/bin/composer

3. Проверьте установку:

  composer -v

Если на экране появилась информация о Composer, всё прошло успешно.

Загрузка Yii2

1. Перейдите в папку проекта. Если это /var/www/html, выполните:

cd /var/www/html

2. Запустите скачивание:

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

Эта команда создаст директорию my_project и загрузит туда Yii2.

Настройка прав доступа

Yii2 может создавать файлы, загружать изображения и сохранять параметры. Для этого необходимы права записи нужных папок:

chmod -R 755 my_project/web/assets
chmod -R 755 my_project/runtime

Так будут заданы безопасные параметры. Рекомендуется избегать команд с полными правами, таких как 777, поскольку это снижает безопасность.

Настройка хранения данных

Большинство ресурсов используют систему хранения информации, которая понадобится и для Yii2.

1. Откройте настройки подключения:

nano my_project/config/db.php

2. Введите параметры подключения:

   return [
       'class' => 'yii\db\Connection',
       'dsn' => 'mysql:host=localhost;dbname=my_database',
       'username' => 'my_user',       'password' => 'my_password',
       'charset' => 'utf8',
   ];

my_database — база данных, my_user — пользователь, а my_password — его пароль. Если данные расположены на другом сервере, вместо localhost укажите его адрес.

Отладка и логирование

Чтобы включить отладочную панель debug в Yii2 и видеть информацию о запросах и ошибках, внесите изменения в конфигурационный файл web.php, который находится в папке config вашего проекта.

Включение отладочной панели

Откройте config/web.php в редакторе. Например, в терминале:

  nano my_project/config/web.php

Найдите блок, отвечающий за модули, и добавьте модуль debug:

if (YII_ENV_DEV) {  // Подключает debug только в режиме разработки
$config['bootstrap'][] = 'debug';
$config['modules']['debug'] = [
'class' => 'yii\debug\Module',
       ];
   }

Проверьте, чтобы приложение функционировало в тестовом режиме (по умолчанию). Включить его можно, установив переменную YII_ENV в dev. Для этого измените .env или добавьте нужные параметры в index.php:

defined('YII_ENV') или define(YII_ENV, dev)

Сохраните и перезапустите сервер при необходимости. Теперь элементы отладки доступны при открытии сайта.

Отключение debug на производственных серверах

Настройка переменной среды YII_ENV:

откройте index.php вашего проекта Yii2. Он расположен в главной директории, обычно в папке web (например, my_project/web/index.php);
в файле index.php найдите строки, где определяется переменная YII_ENV. Если её там нет, добавьте вручную. Для отключения отладочной панели задайте переменной YII_ENV значение prod (сокращение от «production» — рабочий сервер) с помощью команды define(‘YII_ENV’, ‘prod’).

Это означает, что если в index.php нет определения переменной окружения YII_ENV, вы должны добавить её для работы сервера в режиме «продакшн», что отключит панель отладки.

Сохраните и закройте редактор.

Теперь значение YII_ENV установлено как prod, и отладочная панель автоматически отключается в рабочем окружении. Проверить это можно перезагрузкой сайта. Панель отладки больше не должна отображаться внизу страницы. Если она видна, проверьте ещё раз изменения в index.php.

Альтернативный способ: отключение через конфигурацию

Когда файл index.php недоступен, панель отладки можно отключить через конфигурацию.

Откройте файл конфигурации config/web.php (он находится в папке config вашего проекта).
Найдите блок кода, который подключает модуль отладки:

if (YII_ENV_DEV) {  // ― этот блок подключает debug только в тестовом режиме; 
    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = [
        'class' => 'yii\debug\Module',
    ];
}

Чтобы отключить панель отладки, либо удалите этот блок полностью, либо закомментируйте, добавив // перед каждой строкой:

// if (YII_ENV_DEV) {  
//     $config['bootstrap'][] = 'debug';
//     $config['modules']['debug'] = [
//         'class' => 'yii\debug\Module',
//     ];
// }

Отладочный модуль не будет активироваться даже при значении переменной YII_ENV_DEV, установленном в dev.

Сохраните web.php и перезапустите веб-машину, если потребуется.

Решение возможных проблем

Ошибка в процессе установки Composer. Проверьте, есть ли PHP на сервере, без него Composer не сможет работать.

Нет доступа к папкам. Если в процессе работы возникают сбои, удостоверьтесь, что каталоги assets и runtime имеют права на запись.

Ошибка при подключении к системе данных. Проверьте правильность файла config/db.php. Если параметры корректны, проверьте, что база запущена и соединение работает.

Эти советы помогут пройти процесс установки и настройки Yii2 даже тем, кто не имеет опыта в системном администрировании.

Читайте в блоге: