CMS Lavalite

Требования к серверу
Платформа Lavalite имеет несколько системных требований.

- PHP >= 7.1
- OpenSSL PHP Extension
- PDO PHP Extension
- Mbstring PHP Extension
- Tokenizer PHP Extension
- Fileinfo PHP Extension
- GD Library
- Imagick PHP Extension

Lavalite использует Composer для управления своими зависимостями. Поэтому перед использованием Lavalite убедитесь, что на вашем компьютере установлен Composer.

Композитор Create-Project
Вы также можете установить Lavalite, введя команду Composer create-projectв своем терминале:

composer create-project LavaLite/cms --prefer-dist website
Настроить
После создания проекта перейдите в корневую папку проекта и выполните команду для настройки базы данных и файлов конфигурации.

php artisan lavalite:install

php artisan key:generate // run this command if key not generated while installing.
PHP
После установки перейдите по ссылке, чтобы просмотреть домашнюю страницу веб-сайта или приложения, которое вы создаете.

http://path-to-route-folder/public
Данные для входа
администратор

http://path-to-route-folder/public/admin
Вы можете использовать адрес электронной почты и пароль, указанные во время установки Lavalite, чтобы войти в систему как Superuser. Superuser может управлять всеми другими типами пользователей в приложении. Lavalite приходят с двумя типами пользователей userи client. Учетные данные по умолчанию для входа userи client, как показано ниже.

пользователь

http://path-to-route-folder/public/user
User: user@lavalite.org
Password: user@lavalite
клиент

http://path-to-route-folder/public/client
User: client@lavalite.org
Password: client@lavalite
конфигурация
Базовая конфигурация
Все файлы конфигурации для платформы Lavalite хранятся в configкаталоге. Каждая опция задокументирована, поэтому вы можете свободно просматривать файлы и знакомиться с доступными вам опциями.

Разрешения каталога
После установки Lavalite может потребоваться настроить некоторые разрешения. Каталоги внутри storageи bootstrap/cacheкаталоги должны быть доступны для записи на вашем веб-сервере. Если вы используете виртуальную машину Homestead , эти разрешения уже должны быть установлены.

Ключ приложения
Следующее, что вы должны сделать после установки Lavalite, это установить ключ приложения в произвольную строку. Если вы установили Lavalite через Composer или установщик Lavalite, этот ключ уже был установлен для вас key:generateкомандой. Как правило, эта строка должна быть длиной 32 символа. Ключ можно установить в .envфайле среды. Если вы не переименовали .env.exampleфайл в .env, вы должны сделать это сейчас. Если ключ приложения не установлен, ваши пользовательские сеансы и другие зашифрованные данные не будут защищены!

Дополнительная конфигурация
Lavalite практически не нуждается в другой конфигурации из коробки. Вы можете начать разработку! Тем не менее, вы можете просмотреть config/app.phpфайл и его документацию. Он содержит несколько опций, таких как timezoneи localeкоторые вы можете изменить в соответствии с вашей заявкой.

Вы также можете настроить несколько дополнительных компонентов Lavalite, таких как:

кэш
База данных
сессия
После установки Lavalite вы также должны настроить свою локальную среду .

Красивые URL
апаш

Фреймворк поставляется с public/.htaccessфайлом, который используется для разрешения URL-адресов без index.php. Если вы используете Apache для обслуживания своего приложения Lavalite, обязательно включите mod_rewriteмодуль.

Если .htaccessфайл, который поставляется с Lavalite, не работает с вашей установкой Apache, попробуйте этот:

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
Nginx

На Nginx следующая директива в конфигурации вашего сайта разрешит "красивые" URL:

location / {
try_files $uri $uri/ /index.php?$query_string;
}
Конечно, при использовании Homestead красивые URL будут настраиваться автоматически.

Конфигурация среды
Часто бывает полезно иметь разные значения конфигурации в зависимости от среды, в которой выполняется приложение. Например, вы можете использовать локально другой драйвер кеша, чем на рабочем сервере. Это легко, используя конфигурацию на основе среды.

Чтобы упростить эту задачу, Lavalite использует библиотеку PHP DotEnv от Vance Lucas. В новой установке Lavalite корневой каталог вашего приложения будет содержать .env.exampleфайл. Если вы устанавливаете Lavalite через Composer, этот файл будет автоматически переименован в .env. В противном случае вам следует переименовать файл вручную.

Все переменные, перечисленные в этом файле, будут загружены в $_ENVсуперглобальный PHP, когда ваше приложение получит запрос. Вы можете использовать envпомощник для извлечения значений из этих переменных. Фактически, если вы просмотрите файлы конфигурации Lavalite, вы заметите несколько вариантов, уже использующих этот помощник!

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

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

Доступ к текущей среде приложения
Текущая среда приложения определяется через APP_ENVпеременную из вашего .envфайла. Вы можете получить доступ к этому значению с помощью environmentметода на App фасаде :

$environment = App::environment();
Вы также можете передать аргументы environmentметоду, чтобы проверить, соответствует ли среда заданному значению. Вы можете даже передать несколько значений при необходимости:

if (App::environment('local')) {
// The environment is local
}

if (App::environment('local', 'staging')) {
// The environment is either local OR staging...
}
К экземпляру приложения можно также получить доступ через appвспомогательный метод:

$environment = app()->environment();
Кэширование конфигурации
Чтобы ускорить работу вашего приложения, вы должны кэшировать все ваши файлы конфигурации в один файл с помощью команды config:cacheArtisan. Это объединит все параметры конфигурации вашего приложения в один файл, который может быть быстро загружен платформой.

Обычно вы должны запускать php artisan config:cacheкоманду как часть вашей рабочей процедуры развертывания. Эту команду не следует запускать во время локальной разработки, поскольку параметры конфигурации часто необходимо менять в ходе разработки вашего приложения.

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

$value = config('app.timezone');
Чтобы установить значения конфигурации во время выполнения, передайте массив configпомощнику:

config(['app.timezone' => 'America/Chicago']);
Наименование вашего приложения
После установки Lavalite вы можете захотеть «назвать» свое приложение. По умолчанию appкаталог находится в пространстве имен Appи автоматически загружается Composer с использованием стандарта автозагрузки PSR-4 . Однако вы можете изменить пространство имен в соответствии с именем вашего приложения, что вы можете легко сделать с помощью команды app:nameArtisan.

Например, если ваше приложение называется «Horsefly», вы можете запустить следующую команду из корня вашей установки:

php artisan app:name Horsefly
Переименование вашего приложения не является обязательным, и вы можете оставить Appпространство имен, если хотите.

Режим технического обслуживания
Когда ваше приложение находится в режиме обслуживания, для всех запросов в ваше приложение будет отображаться пользовательское представление. Это позволяет легко «отключить» ваше приложение во время его обновления или при выполнении технического обслуживания. Проверка режима обслуживания включена в стек промежуточного ПО по умолчанию для вашего приложения. Если приложение находится в режиме обслуживания, HttpExceptionбудет выдан код состояния 503.

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

php artisan down
Чтобы отключить режим обслуживания, используйте upкоманду:

php artisan up
Шаблон ответа режима обслуживания
Шаблон по умолчанию для ответов режима обслуживания находится в resources/views/errors/503.blade.php.