Skip to content

Latest commit

 

History

History
118 lines (63 loc) · 7.55 KB

parametry-konfiguracii.md

File metadata and controls

118 lines (63 loc) · 7.55 KB

Параметры конфигурации

Базовые параметры работы МИС Медкей описываются в файле .env, который расположен в корневом каталоге приложения.

В дистрибутиве имеются примеры конфигурационного файла .env:

  • .env.prod — пример конфигурационного файла окружения для продакшн-использования;
  • .env.dev — пример конфигурационного файла окружения для разработки (отладки).

Каждый параметр в .env файле должен быть описан в отдельной строке.

Описание параметров .env

APP_ENV

Определяет окружение приложения. Может иметь 2 значения:

  • prod — продакшн-окружение;
  • dev — окружение для разработки.

В значении продакшн-окружения отключен вывод ошибок приложения на экран (пользователь не увидит стек ошибки, а получит от сервера страницу с HTTP 500 или другим кодом ошибки, соответствующим произошедшему инциденту). При этом ошибки будут фиксироваться в журнале приложения.

APP_DEBUG

Может принимать значение true или false. Если значение true — в нижней правой части страницы будет отображаться отладочная панель.

Для продакшн-использования должно иметь значение false.

APP_DB_CONNECTION

Описывает тип подключения к базе данных (СУБД), определяет используемый для подключения к СУБД драйвер. Может принимать одно из двух значений (для проверенных СУБД):

  • pgsql — будет использоваться драйвер СУБД PostgreSQL;
  • mysql — будет использоваться драйвер СУБД MySQL/MariaDB.

APP_DB_HOST

Адрес хоста сервера СУБД. Может принимать значения:

  • IPv4-адрес (например, 127.0.0.1);
  • URL (например, localhost).

Для PostgreSQL здесь должно быть указано значение адреса кластера СУБД. По умолчанию для локальной инсталляции используется адрес 127.0.0.1.

APP_DB_PORT

Сетевой порт кластера СУБД (для PostgreSQL) or server (for MySQL).

По умолчанию PostgreSQL использует порт кластера 5432.

APP_DB_NAME

Имя базы данных. Должна быть предварительно создана на сервере СУБД.

APP_DB_USERNAME

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

APP_DB_PASSWORD

Пароль пользователя, указанного в APP_DB_USERNAME.

SUPER_LOGIN

Логин пользователя приложения МИС Медкей, который должен иметь полномочия суперпользователя (доступ ко всем функциям системы), игнорируя настроенный ACL.

SUPER_PASSWORD

Пароль пользователя, указанного в SUPER_LOGIN.

APP_TYPE_KEY

Тип первичных ключей записей в таблицах БД приложения: biginteger (64 бита) и UUID (строка с глобальным идентификатором). Параметр может принимать следующие значения:

  • bigint — для целочисленных идентификаторов;
  • uuid — для UUID (GUID) идентификаторов.

{% hint style="warning" %} Данный параметр должен быть задан до развёртывания БД приложения. В дальнейшем не может быть изменён. Изменение значения параметра для ранее развёрнутого приложения гарантированно приведёт к его неработоспособности. {% endhint %}

Мы рекомендуем использовать идентификаторы bigint.

WIDGET_LOADER_URL

URI компонента системы, используемого в качестве входной точки для загрузки виджетов. По умолчанию используется /ui/widget-loader/factory.

{% hint style="info" %} Может быть изменён для потребностей разработки или особой сетевой конфигурации. Для продакшн-использования рекомендуется оставить значение по умолчанию. {% endhint %}

APP_TITLE

Заголовок приложения по умолчанию, который отображается в шапке приложения (в основном меню) и в заголовках страниц. Может быть переопределён значением, которое настраивается в пользовательском интерфейсе.

Вы можете задать в качестве значения произвольную строку. Не рекомендуется указывать название длиннее 20 символов.

JOB_TIMEOUT

Таймаут в микросекундах для фоновых обработчиков. По умолчанию 1200.

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

AUTH_WITH_EMPLOYEE

Может принимать значения true и false. Если вы хотите запретить аутентификацию пользователей без связанной записи сотрудника — установите значение false (используется в продакшн-окружении).

LANGUAGE

Язык приложения по умолчанию. Может быть переопределён настройкой (параметр «Язык по умолчанию»), которая указывается в пользовательском интерфейсе. Указанный язык будет установлен всем пользователям, которые не задали в своём профиле предпочтительный язык.

Доступные значения:

  • ru - русский язык;
  • en - английский язык.