Установка и запуск фреймворка

Системные требования

PHP ≥ 8.0, PDO драйвер для MySQL или SQLite, расширения mbstring и gd.

На большинстве веб северов все необходимые настройки включены по умолчанию.

Установка с помощью Composer

composer create-project makscraft/mv-framework project_name

Если ваш проект находится в корне домена, перейдите в корневой каталог домена и выполните команду composer со значением . (точка) вместо project_name.

cd project_directory
composer create-project makscraft/mv-framework .

Если ваш проект находится не в корне домена, вам нужно будет указать подкаталог проекта, например /my/project/ во время установки composer. Все остальные базовые настройки будут сгенерированы автоматически.

Если в процессе установки вы выбрали базу MySQL, установщик предложит заполнить данные подключения в файле .env, а затем перейти в директорию проекта и выполнить команду:

cd project_directory
composer mv:database

После процесса установки запустите ваш http-сервер и проверьте приложение. Должна открыться стартовая страница со ссылками меню и доступами к админ панели.

После установки

Чтобы поставить русский язык, при установке через Composer, выполните команду, находясь в директории проекта:

composer mv:region -- ru

Также, для полноценной работы на рабочем сервере необходимо будет заполнить в файле .env следующие параметры:

APP_ENV=production
APP_DOMAIN=https://mydomain.com
APP_TIMEZONE=Europe/London
EMAIL_FROM='Название <обратный адрес>'

На рабочем сервере необходимо будет установить права на запись для папку userfiles и все вложенные в нее папки, а также на папку log.

Ручная установка

Скачайте архив с текущего сайта и распакуйте содержимое в папку вашего проекта.
Заполните раздел базы данных в файле .env в корневом каталоге (sqlite установлен по умолчанию, в этом случае вам не нужно ничего заполнять для запуска).
Для базы данных mysql начальный дамп находится в каталоге /userfiles/database. Загрузите его в вашу базу данных.
Если ваш проект находится не в корне домена, вам нужно заполнить настройку APP_FOLDER в файле .env и значение RewriteBase в файле .htaccess тем же значением, например /my/project/.
Вы можете не заполнять значение APP_TOKEN в файле .env, потому что позже MV сгенерирует для вас случайное значение и попросит вас поместить его в файл .env.
После процесса установки запустите ваш http-сервер и проверьте приложение.
Для установки русскоязычного пакета задайте настройку APP_REGION=ru в файле .env и скопируйте папки models и views из директории customs/regions/ru поверх корневых папок проекта.

Административная часть находится по ссылке /adminpanel для первоначально входа используется логин ‘root’ и пароль ‘root’.

Первоначальный пользователь является суперпользователем (Root с id равным 1). Данный пользователь не может быть удален или заблокирован, а также он всегда имеет доступ ко всем модулям системы без ограничений.

Обновление системы

Периодически ядро и административная панель MV обновляются, исправляются ошибки и вводятся новые возможности. Чтобы обновить MV framework необходимо пройти следующие шаги.

Если MV был установлен через Composer:

cd project_directory
composer update

При ручной установке:

Скачать последнюю версию ядра MV с данного сайта или Github, репозиторий https://github.com/makscraft/mv-core.
Перейти в корень своего проекта.
Скопировать поверх старых папок следующие папки: adminpanel, core и файл config/autoload.php.
Если папка административной панели была переименована, то необходимо обновить ее содержимое.

Изменение папки административной панели

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

Переименовать папку adminpanel.
В файле config/setup.php изменить значение опции 'AdminFolder' на название новой папки.

Следующий раздел

Структура папок