README

School-PHP FrameWork: "Fox and Wolf"

Установка

Подготовка. Для начала нам потребуется COMPOSER. Если ранее через него уже была установка данного Frame Work, то необходимо очистить кэш. Для начала настроим PHPStorm в settings и default settings:

в разделе Languages->PHP указать PHP Language level: php 7 , CLI Interpreter: php 7
в разделе Languages->PHP->Composer указать PHP Interpreter: php 7.
в разделе Tools->Command line tool support или ctrl+alt+s и добавляем запись через + - composer с галочкой на global

Примечание: Если уже установлен, то повторно подключать не надо!

Теперь открываем Tools->Run command... или ctrl+shift+x. Где вводим команду по очистке кэша:

c clear-cache

2.а) Создайте новый проект в PHPStorm, выберите способ создания COMPOSER и установите пакет schoolphp/framework. 2.б) Как альтернативу можно запустить команду в Tools->Run command...:

c create-project schoolphp/framework C:/OpenServer/domains/newsite.ru/ 1.1.5

Примечание: в данном случае мы указываем путь куда устанавливаем проект, а так же последним параметром указываем версию проекта. Последнюю версию можно увидеть тут: https://github.com/schoolphp/framework/releases Хочу заметить, что PHPStorm хранит кэш установок, поэтому через FILE - NEW PROJECT может находиться не самая свежая версия. Поэтому данный способ можно считать самым эффективным.

2.в) Альтернативная установка через git: запускаем команды через Terminal в PHPStorm, быстрый доступ находится слева внизу:

git init
git pull https://github.com/schoolphp/framework

Устанавливаем все пакеты composer - Tools -> Run Command и вводим команду:

c install

Устанавливаем следующий менеджер зависимостей NPM. Bootstrap и Font-Awesome перешли с bower на NPM. Открываем Terminal:

cd skins/components
npm install
cd ../..

В данной сборке временами я буду обновлять версию bootstrap, если же Вы хотите обновить до последней сборки Bootstrap самостоятельно, то необходимо будет собрать css файл из SASS вручную. Делается это следующим образом:

5.1) Установка Ruby + Sass компилятор:

https://www.ruby-lang.org/en/downloads/

Запускаете Поиск - cmd (откроется консоль, можно так же открыть через Выполнить - cmd), в ней пишете команду:

gem install sass

5.2) Настроить в PHPStorm можно двумя способами. Самый простой - открыть scss файл (scss файл аналогичен less), нам предложат добавить File Watchers сверху, жмём YES или:

Settings - File Watchers - Добавить - SCSS . Устанавливаем следующие настройки:

Arguments: --no-cache --update --style compressed $FileName$:$FileNameWithoutExtension$.min.css
Output paths to refresh: $FileNameWithoutExtension$.min.css:$FileNameWithoutExtension$.min.css.map
Immediate file synchronization: отключаем

5.3) Открываем файл skins/components/node_modules/bootstrap/scss/bootstrap.scss и из неё убираем строку @import "reboot"; , Сохраняем файл. Получаем в данной папке bootstrap.min.css , он то нам и нужен! Либо укажите путь к файлу, либо скопируйте его в созданную ранее папку skins/components/bootstrap, так же в эту папку не забудьте скинуть skins/components/node_modules/bootstrap/dist/js/bootstrap.min.js

Настройка

Необходимо настроить MySQL , а именно Создать новую Базу Данных и Нового пользователя.
Запустить install.php, ввести данные.
Запускаем Проект

Важные особенности

Не стоит бояться файла install.php, так как установки не будет, если она уже была выполнена ранее!

Обновление проекта

Обновление библиотек composer: открываем Tools -> Run Command и вводим команды:

c clear-cache
c update

Обновление ядра проекта: открываем Terminal и запустите git команду:

git pull https://github.com/schoolphp/framework

Примечания: Если просят удалить файлы, то были нарушены принципы Фреймворка, так как нельзя лезть в файлы ядра!

Дополнительно:

Сократить git pull можно, если заранее указать указать репозиторий:

git config remote.origin.url https://github.com/schoolphp/framework

И дальше обновлять просто командой git pull.

schoolphp / framework

Maintainers

Details