Как установить yii framework
Как установить Yii2 по шагам
Дата публикации: 2017-04-05
От автора: приветствую вас, друзья. Из этой статьи вы узнаете, как установить Yii2 по шагам. Установка Yii2 достаточно проста и предлагается в двух вариантах — установка через Композер и установка Yii2 без Композера (из архива). В данной статье мы рассмотрим второй вариант установки Yii2.
Итак, установка Yii2 предлагается нам в двух вариантах: установка через Композер (Composer) — это рекомендуемый вариант, и установка без Композера, т.е. установка фреймворка из архива. В данной статье мы рассмотрим последний вариант и пойдем по пути наименьшего противления — установим Yii2 из архива. Для этого нам потребуется архив с фреймворком.
Для получения архива необходимо обратиться на официальный сайт Yii в раздел downloads — framework.
На открывшейся странице мы найдем оба способа установки. Установка через Composer, как рекомендуемый вариант, идет первой, поэтому спускаемся ниже и ищем вариант установки Yii2 без Композера.
Фреймворк Yii2. Быстрый старт
Получите курс и узнайте, как с помощью фреймворка Yii2 разрабатывать веб-приложения на примере блога
Здесь мы найдем два варианта шаблона Yii2 на выбор: базовый (basic) и продвинутый (advanced). На каком из них остановить свой выбор? Для начинающих я бы рекомендовал выбрать именно шаблон basic. В чем между ними разница? Базовый шаблон реализует одно приложение, а продвинутый шаблон включает в себя по сути несколько приложений, в частности это разделение на frontend и backend.
Итак, скачаем шаблон basic. Далее нам необходим сервер, и здесь есть свой выбор между несколькими вариантами: установка Yii2 на Open Server или установка Yii2 на хостинг. Поскольку мы находимся на этапе изучения фреймворка, я воспользуюсь локальным сервером Open Server, который является, пожалуй, лучшим вариантом локального сервера под ОС Windows.
На локальном сервере я создам домен, который так и назову — yii2. В архиве с базовым шаблоном фреймворка вы найдете папку basic, распакуем ее содержимое в корень созданного домена на локальном сервере.
Для доступа к сайту нам необходимо обратиться теперь по адресу //yii2/web/. Обратите внимание! Для Yii2 необходима версия PHP не менее 5.4. Если ваш сервер использует версию PHP ниже, тогда обязательно измените ее, иначе фреймворк работать не будет.
Как установить yii framework
Вы можете установить Yii двумя способами: используя Composer или скачав архив. Первый способ предпочтительнее так как позволяет установить новые расширения или обновить Yii одной командой.
Note: В отличие от Yii 1, после стандартной установки Yii 2 мы получаем как фреймворк, так и шаблон приложения.
Установка при помощи Composer
Если Composer еще не установлен это можно сделать по инструкции на getcomposer.org, или одним из нижеперечисленных способов. На Linux или Mac используйте следующую команду:
На Windows, скачайте и запустите Composer-Setup.exe.
В случае возникновения проблем читайте раздел «Troubleshooting» в документации Composer. Если вы только начинаете использовать Composer, рекомендуем прочитать как минимум раздел «Basic usage».
Note: Во время установки Yii Composer запрашивает довольно большое количество информации через Github API. Количество запросов варьируется в зависимости от количества зависимостей вашего проекта и может превысить ограничения Github API. Если это произошло, Composer спросит логин и пароль от Github. Это необходимо для получения токена для Github API. На быстрых соединениях это может прозойти ещё до того, как Composer сможет обработать ошибку, поэтому мы рекомендум настроить токен доступа до установки Yii. Инструкции приведены в документации Composer о токенах Github API.
После установки Composer устанавливать Yii можно запустив следующую команду в папке доступной через веб:
Tip: Если вы хотите установить последнюю нестабильную ревизию Yii, можете использовать следующую команду, в которой присутствует опция stability:
Старайтесь не использовать нестабильную версию Yii на рабочих серверах потому как она может внезапно поломать код.
Установка из архива
Установка Yii из архива состоит из трёх шагов:
Другие опции установки
Выше приведены инструкции по установке Yii в виде базового приложения готового к работе. Это отличный вариант для небольших проектов или для тех, кто только начинает изучать Yii.
Есть два основных варианта такой установки:
После установки приложение будет доступно по следующему URL:
Здесь подразумевается, что вы установили приложение в директорию basic в корневой директории вашего веб сервера сервер работает локально ( localhost ). Вам может потребоваться предварительно его настроить.
Вы должны увидеть страницу приветствия «Congratulations!». Если нет — проверьте требования Yii одним из способов:
Для корректной работы фреймворка вам необходима установка PHP, соответствующая его минимальным требованиям. Основное требование — PHP версии 5.4 и выше. Если ваше приложение работает с базой данных, необходимо установить расширение PHP PDO и соответствующий драйвер (например, pdo_mysql для MySQL).
Настройка веб сервера
Info: можете пропустить этот подраздел если вы только начали знакомиться с фреймворком и пока не разворачиваете его на рабочем сервере.
Приложение, установленное по инструкциям, приведённым выше, будет работать сразу как с Apache, так и с Nginx под Windows и Linux с установленным PHP 5.4 и выше. Yii 2.0 также совместим с HHVM. Тем не менее, в некоторых случаях поведение при работе с HHVM отличается от обычного PHP. Будьте внимательны.
Info: Если приложение работает на хостинге где нет доступа к настройкам веб сервера, то можно изменить структуру приложения как описано в разделе «Работа на Shared хостинге».
Рекомендуемые настройки Apache
Рекомендуемые настройки Nginx
PHP должен быть установлен как FPM SAPI для Nginx. Используйте следующие параметры Nginx и не забудьте заменить path/to/basic/web на корректный путь к basic/web и mysite.test на ваше имя хоста.
Учтите, что используя HTTPS необходимо задавать fastcgi_param HTTPS on; чтобы Yii мог корректно определять защищенное соединение.
Установка Yii
Вы можете установить Yii двумя способами: используя Composer или скачав архив. Первый способ предпочтительнее так как позволяет установить новые расширения или обновить Yii одной командой.
Примечание: В отличие от Yii 1, после стандартной установки Yii 2 мы получаем как фреймворк, так и шаблон приложения.
Установка при помощи Composer
Если Composer еще не установлен это можно сделать по инструкции на getcomposer.org, или одним из нижеперечисленных способов. На Linux или Mac используйте следующую команду:
На Windows, скачайте и запустите Composer-Setup.exe.
В случае возникновения проблем или если вам необходима дополнительная информация, обращайтесь к документации Composer.
После установки Composer устанавливать Yii можно запустив следующую команду в папке доступной через веб:
Примечание: В процессе установки Composer может запросить логин и пароль от Github потому как у API Github имеется ограничение на количество запросов. Это нормально потому как Composer в процессе работы запрашивает у Github большое количество информации для каждого пакета. Вход на Github повышает ограничение по запросам API и Composer может продолжить свою работу. Подробнее об этом можно прочитать в документации Composer.
Подсказка: Если вы хотите установить последнюю нестабильную ревизию Yii, можете использовать следующую команду, в которой присутствует опция stability:
Старайтесь не использовать нестабильную версию Yii на рабочих серверах потому как она может внезапно поломать код.
Установка из архива
Установка Yii из архива состоит из трёх шагов:
Другие опции установки
Выше приведены инструкции по установке Yii в виде базового приложения готового к работе. Это отличный вариант для небольших проектов или для тех, кто только начинает изучать Yii.
Есть два основных варианта такой установки:
Проверка установки
После установки приложение будет доступно по следующему URL:
Здесь подразумевается, что вы установили приложение в директорию basic в корневой директории вашего веб сервера сервер работает локально ( localhost ). Вам может потребоваться предварительно его настроить.
Вы должны увидеть страницу приветствия «Congratulations!». Если нет — проверьте требования Yii одним из способов:
cd basic php requirements.php
Для корректной работы фреймворка вам необходима установка PHP, соответствующая его минимальным требованиям. Основное требование — PHP версии 5.4 и выше. Если ваше приложение работает с базой данных, необходимо установить расширение PHP PDO и соответствующий драйвер (например, pdo_mysql для MySQL).
Настройка веб сервера
Информация: можете пропустить этот подраздел если вы только начали знакомиться с фреймворком и пока не разворачиваете его на рабочем сервере.
Приложение, установленное по инструкциям, приведённым выше, будет работать сразу как с Apache, так и с Nginx под Windows и Linux с установленным PHP 5.4 и выше. Yii 2.0 также совместим с HHVM. Тем не менее, в некоторых случаях поведение при работе с HHVM отличается от обычного PHP. Будьте внимательны.
Информация: Если приложение работает на хостинге где нет доступа к настройкам веб сервера, то можно изменить структуру приложения как описано в разделе «Работа на Shared хостинге».
Рекомендуемые настройки Apache
Рекомендуемые настройки Nginx
PHP должен быть установлен как FPM SAPI для Nginx. Используйте следующие параметры Nginx и не забудьте заменить path/to/basic/web на корректный путь к basic/web и mysite.local на ваше имя хоста.
Учтите, что используя HTTPS необходимо задавать fastcgi_param HTTPS on; чтобы Yii мог корректно определять защищенное соединение.
Как установить Yii на Windows или Mac
Хотите узнать больше об Yii? Читайте Введение в Yii Framework и следуйте нашим сериям программирования Yii.
Добро пожаловать
В сегодняшнем учебнике мы рассмотрим, как установить Yii в локальной среде разработки для Windows и macOS. В руководстве по Windows мы будем использовать WAMP Server, среду разработки Windows для Apache, PHP и Mac, а в руководстве по Mac мы будем использовать его кузена MAMP. Хотя Rod использует WAMP в сегодняшнем учебнике, есть также версия MAMP для Windows.
Я пишу часть этого руководства, которая относится к Mac, а мой коллега Rod Ussing пишет про Windows. Я встретил Рода в средней школе в Калифорнии во время моей второй работы программистом, очень много лет назад. Он по-прежнему использует Windows, но после восьми лет работы в Microsoft и утомительной перезагрузки системы для перезапуска Outlook, я ушел на macOS.
Что такое Yii?
Как программировать с Yii2: использование расширенного шаблона приложения
Создание вашего стартапа с помощью PHP: Содержание
Мне нравится писать код в Yii. Все быстрее и легче для меня. И это относительно просто, пока развивается фреймворк (это я бросаю тень на Rails).
Мы начнем с основ того, как установить Yii в macOS, а затем перейдем к Windows. Поскольку то, что необходимо для завершения установки на каждой платформе, в целом сходится, мы опишем оставшиеся инструкции в единой форме для обеих платформ.
Выбор между Yii Basic и Yii Advanced
Вот структура каталогов приложения Yii Basic с набором каталогов для одного приложения:
Шаблон расширенного проекта Yii 2 лучше всего подходит для разработки сложных веб-приложений с несколькими уровнями, такими как фронтенд, бекенд и консольные команды, каждый из этих уровней представляет собой отдельное приложение Yii. Например, административные сайты могут работать на бекенд части, а задачи cron могут выполняться в среде консоли.
Напротив, вот структура каталогов для приложения Yii Advanced с несколькими уровнями:
Подготовка macOS для Yii
Я уже несколько лет пишу код в Yii на macOS. Конечно, существует множество различных способов запуска среды Apache, MySQL, PHP на Mac, но я предпочитаю MAMP.
Установка MAMP
В основном, просто откройте веб-сайт MAMP и загрузите пакет для macOS:
После загрузки вы можете перетащить пакет в папку «Приложения» и дважды щелкнуть, чтобы запустить MAMP. Появится окно MAMP:
Настройка MAMP
Нажмите «Настройки», чтобы настроить порты, которые вы хотите использовать на сервере (я использую 8888 для Apache):
Нажмите «Веб-сервер», чтобы просмотреть или изменить каталог вашего сервера. Я использую Apache локально:
Установка Composer на macOS
Yii2 требует Composer, популярного менеджера зависимостей для PHP. Если у вас еще нет Composer, выполните следующие действия:
Затем используйте Composer для установки Yii2. В запросе на установку требуется, чтобы вы использовали собственные данные учетной записи GitHub; Зарегистрируйтесь, если у вас нет учетной записи.
Rod описывает далее ниже, что для установки Yii необходим плагин для композитора:
Он рекомендует настроить учетную запись в GitHub и настроить токен доступа. Причина этого заключается в том, что во время установки Yii количество запросов может превышать ограничение скорости передачи данных GitHub API, и Composer может остановиться и попросить ваши учетные данные входа GitHub чтобы снова получить токен доступа к API GitHub во время установки.
Когда будете готовы, вы сможете установить Yii. Мы будем использовать Yii basic и установим его в каталог
Затем создайте символическую ссылку для MAMP в каталог приложений для сайтов:
Если вы решите установить Yii Advanced, это может помочь активировать и настроить ваш файл виртуального хоста:
Ниже я настроил frontend.dev и backend.dev для сопоставления с установкой Yii Advanced в каталоге
Если вы решите использовать Yii Advanced, я также рекомендую вам ознакомиться с моим учебным пособием, в котором содержится более подробная информация о нем.
Это были конкретные шаги развертывания платформы для macOS. Теперь давайте посмотрим на подготовку к Yii в Windows. Позже мы вернемся к завершению конфигурации с шагами, которые работают для обеих платформ. Если вы строго являетесь пользователем MacOS, перейдите к разделу «Завершение настройки Yii».
Подготовка Windows для Yii
Установка WAMP
Поскольку основное внимание в этом руководстве уделяется установке Yii, мы предлагаем вам обратиться к одному из многих превосходных существующих руководств, которые охватывают установку WAMP; Вы будете удивлены, насколько это легко. Поскольку это также приложение PHP, руководство WordPress для установки WAMP является хорошей отправной точкой.
Как только мы установили и настроили WAMP, нам нужно установить Composer, который является менеджером зависимостей и установщиком для проектов PHP. Это позволит нам начать работу с нашей установкой Yii.
Установка Composer в Windows
Хотя вы можете загружать пакеты Yii из GitHub, в этом уроке мы используем Composer для его установки. Если вы не знакомы с ним, вы можете узнать больше в этом уроке.
Сначала перейдем на GitHub для загрузки и установки последней версии Composer-setup.exe, которая на данный момент является v4.5.0.
Как только установка будет завершена, рекомендуется выйти из системы и снова войти в систему, чтобы убедиться, что все файлы обновлены [Jeff здесь: или купить Mac].
Вы можете проверить свою установку, открыв командную строку и выбрав:
Введите следующую команду:
Затем должна отображаться информация о версии для Composer, например:
Установить плагин Asset Composer
Откройте командную строку в Windows и перейдите туда, где находится ваша папка PHP. На этой установке PHP находится в каталоге wamp64\bin\ и это версия PHP 7.0.10, поэтому мы печатаем:
Затем введите следующую команду:
Имейте в виду, что программное обеспечение изменяется, поэтому обязательно убедитесь, что вы работаете с самой последней стабильной версией. Будьте осторожны с бета-версиями.
Для самых последних версий Composer и Composer Asset Plugin:
Настройка WAMP для вашего приложения Yii
Теперь давайте настроим WAMP для Yii. Измените свой каталог на установку WAMP \www для этой установки:
В этом каталоге мы создадим новый каталог с именем Yii Basic, набрав:
Здесь мы собираемся установить Yii Basic. Вы можете пропустить этот шаг и установить Yii прямо в каталог www, но создание четко названного каталога позволяет избежать путаницы, особенно если вы планируете установить шаблоны как Yii Basic, так и Yii advanced.
В новом каталоге yii-basic мы запускаем следующую команду для установки базового шаблона Yii:
Мы можем проверить Yii, перейдя в папку «Basic» в созданном вами каталоге:
Теперь мы вводим команду:
Это запустит Yii, используя механизм PHP WAMP.
Настройка файла хоста в Windows
Если вы хотите настроить локальные адреса браузера для своего сайта или четко указать на фронтенд и бекенд сайта Yii-Advanced, вам нужно кое что еще сделать.
Либо используя раскрывающийся список «Открыть файл» текстового редактора, либо непосредственно в проводнике Windows, перейдите в файл:
Мы ищем раздел, который гласит:
В рамках подготовки к нескольким сайтам Yii-Advanced добавим один для интерфейса и один для бэкэнд:
Это будет выглядеть так:
Включение виртуальных хостов в файле httpd.conf
Рекомендуется проверить, что виртуальные хосты включены в файле Apache httpd.conf.
Чтобы найти httpd.conf, введите:
Мне нравится это руководство для более подробного объяснения редактирования httpd.conf для включения функций, связанных с виртуальными хостами в Apache, и настройки виртуальных хостов на WAMP.
Настройка виртуальных хостов
Теперь нам нужно настроить виртуальные хосты Apache. Используя наше меню текстового редактора или проводник Windows, мы перейдем к следующему каталогу:
Для локального хоста должен быть виртуальный хост, поэтому теперь нам нужно добавить виртуальные хосты для фронтенда и бекенда Yii. Я рекомендую вам вводить имя над каждым виртуальным хостом, чтобы избежать путаницы. (Не забудьте закомментировать название!)
Файл конфигурации виртуального хоста должен выглядеть примерно так.
В этом примере мы установили Yii Advanced в c:/wamp64/www/yii-advanced и создали приложение с именем yii-application. Также можно установить Yii в www, чтобы ваш путь выглядел проще: c:/wamp64/www/myapp/frontend/web.
Обратите особое внимание на строки DocumentRoot и Directory. Они должны содержать полный путь к каталогу приложений Yii вплоть до «веб-файла», который находится в интерфейсных и backend-каталогах соответственно. Содержимое DocumentRoot и Directory идентично, за исключением того, что путь к каталогу содержится в кавычках.
Установка шаблона Yii-Advanced для Windows
Чтобы установить расширенный шаблон Yii, вернемся в каталог wamp64\www:
Теперь мы создадим новый каталог с именем yii-advanced:
В новом каталоге мы запускаем следующую команду, которая установит шаблон Yii Advanced:
До сих пор установка Yii Basic и Yii Advanced была одинаковой. Теперь нам нужно добавить еще несколько шагов, чтобы подготовить ваш Yii Advanced Template к действию.
Завершение конфигурации Yii
Шаги для Windows и Mac
Создание базы данных MySQL
Предполагая, что PHPmyAdmin установлен на вашем сервере WAMP (он включен в MAMP), вы можете фактически создать базу данных через графический интерфейс PHPmyAdmin, но мы собираемся использовать командную строку SQL, что, честно говоря, не требует больших усилий.
В командной строке Windows перейдите в папку MySQL, набрав:
Вы также можете сделать это из любого места, пока WAMP или MAMP находятся в вашем локальном окружении.
Затем для Mac и Windows введите:
Это приведет нас к командной строке mysql. Теперь мы выполним следующую команду в SQL:
(Вы можете назвать базу данных так, как хотите, при условии, что вы будете использовать соответствующее имя в течение всего остального процесса.)
Теперь мы создадим имя пользователя и пароль для этой базы данных, введя следующие команды SQL:
Теперь вы покинете MySQL и вернетесь в консольную консоль.
Сохраняйте имя пользователя и пароль базы данных под рукой, так как нам понадобится настроить конфигурационный файл PHP (common/config/main-local.php), который позволяет Yii безопасно общаться с MySQL.
Инициализация расширенного приложения Yii
Это не требуется для установок Yii-basic.
Чтобы инициализировать Yii, нам нужно перейти в папку приложений Yii-Advanced. В этом случае это будет:
Затем введите init :
Для целей этого урока мы будем работать в среде разработки, поэтому введите 0 и нажмите enter, а затем введите «да» (без кавычек) при появлении запроса и завершение инициализации.
Обновление настроек конфигурации Yii
Чтобы открыть файл конфигурации, используйте раскрывающееся меню «Открыть файл» в текстовом редакторе или перейдите непосредственно в файл конфигурации с помощью проводника Windows и щелкните правой кнопкой мыши «Открыть с» и выберите текстовый редактор. (В Windows вам может потребоваться запустить текстовый редактор в качестве администратора.)
Следующий пример из установки, которую мы используем сегодня, иллюстрирует этот процесс. Имейте в виду, что вы можете использовать другое обозначение диска и иметь несколько другой путь в зависимости от того, как вы назвали свои папки.
Файл конфигурации должен выглядеть примерно так:
Не забудьте ввести те же имя пользователя и пароль, которые вы использовали для настройки своей базы данных Yii MySQL, иначе Yii и MySQL не будут работать!
Использование Yii Migration Tool
Yii Advanced имеет свои собственные миграции. Теперь, когда MySQL настроен, нам понадобятся некоторые таблицы. Миграции Yii создают таблицы и схемы в вашей базе данных MySQL программно.
Чтобы запустить инструмент миграции Yii в Windows, нам нужно перейти в наш каталог установки Yii, набрав:
Опять же, вы можете установить его без родительского каталога, который Rod создал для этой демонстрации. Например, для MAMP я использую:
Теперь введите следующую команду:
Через какое-то время вас спросят, хотите ли вы «Apply the above migration?»
Введите « Yes » и нажмите «Enter». Если все будет хорошо, мы получим сообщение об успешной миграции Yii.
Посещение вашего сайта Yii
Теперь момент истины. Когда вы откроете localhost:8888 в своем браузере, вы должны увидеть следующее:
Если вы установили расширенный шаблон, перейдите на ссылку «Регистрация» и введите имя пользователя, адрес электронной почты, который вы хотите использовать, и пароль.
Не используйте свой пароль MySQL (тот, который вы ввели в файл конфигурации PHP). Это база данных учетной записи пользователя Yii с новыми именами пользователей и паролями.
Ваша первая регистрация пользователя также будет административным пользователем приложения Yii с доступом ко всему.
Теперь, когда вы зарегистрированы, введите в браузере:
Вы должны получить экран входа для администратора, где вы можете ввести новое имя пользователя и пароль:
Это вернет вас на предыдущую страницу Yii « Congratulations », но как аутентифицированного пользователя.
Теперь со всеми этими поздравлениями, почему бы не поздравить себя, как вы только что успешно установили Yii. Отличная работа. [Джефф здесь, если вы сделали это в Windows, купите Mac и попробуйте там.]
В заключение
Надеюсь, наш учебник поможет вам начать работу с Yii. Род и я наслаждались написанием этого вместе.
Следите за предстоящими учебниками в нашей серии программирования с помощью Yii2, поскольку мы продолжаем погружаться в разные аспекты фреймворка. Обязательно ознакомьтесь с нашей версией Создаем свой стартап помощью серии PHP, в которой используется расширенный шаблон Yii2, когда мы создаем реальное приложение.
В эпизоде «Приступая к работе с Yii» отлично расписана настройка Yii basic и боевого Linux-сервера.
Если вы хотите узнать, когда выйдет следующий учебник Yii2, следуйте за мной @reifman в Twitter или проверьте мою страницу инструктора. Моя страница инструктора будет включать все статьи из этой серии, как только они будут опубликованы.