Merge branch 'master' into master

Author: varrcan

README.md

@@ -40,39 +40,40 @@ SENTRY_DSN=https://<key>@sentry.io/<project>
 
 ### Получение переменных из .env файла
 
-Вместе с пакетом зависимостью устанавливается библиотека `vlucas/phpdotenv`, посредством которой можно получить переменные из `.env` файла
+Вместе с пакетом зависимостью устанавливается библиотека `vlucas/phpdotenv`, посредством которой можно получить переменные из `.env` (по умолчанию) файла
 
 Для этого в `init.php` нужно прописать:
 
 ```php
 if (class_exists('Dotenv\\Dotenv')) {
-    $env = Dotenv\Dotenv::createImmutable(__DIR__);
-
+    $env = Dotenv\Dotenv::createImmutable($_SERVER['DOCUMENT_ROOT']);
+    // Если на проекте используется другое имя файла, его можно задать вторым параметром
+    // пример, $env = Dotenv\Dotenv::createImmutable($_SERVER['DOCUMENT_ROOT'], '.environment');
     try {
         $env->load();
     } catch (InvalidFileException | InvalidPathException $e) {
     }
 }
 ``` 
 
-Если на проекте используется другое имя файла, его можно задать вторым параметром:
+В метод `createImmutable` нужно указать путь к файлу .env (или .environment)  
 
+> В примере указана проверка на существование класса Dotenv, чтобы при первом деплое на production-сервер не вызвать ошибку (пока не отработает composer install)
+
+**Если у вас уже установлен Laravel**, то может возникнуть ошибка конфликта версий пакета `vlucas/phpdotenv`, проверьте что установили подходящий.  
+Подключение для старой (^3.3) версии пакета тоже отличается:
 ```php
 if (class_exists('Dotenv\\Dotenv')) {
-    $env = Dotenv\Dotenv::createImmutable($_SERVER['DOCUMENT_ROOT'], '.environment');
-
+    $env = Dotenv\Dotenv::create($_SERVER['DOCUMENT_ROOT']); // изменение тут, в старой версии нет метода createImmutable
+    // Если на проекте используется другое имя файла, его можно задать вторым параметром
+    // пример, $env = Dotenv\Dotenv::create($_SERVER['DOCUMENT_ROOT'], '.environment');
     try {
         $env->load();
     } catch (InvalidFileException | InvalidPathException $e) {
     }
 }
 ``` 
 
-В метод `createImmutable` нужно указать путь к файлу .env (или .environment)  
-
-> В примере указана проверка на существование класса Dotenv, чтобы при первом деплое на production-сервер не вызвать ошибку (пока не отработает composer install)
-
-
 ### Настройка Bitrix
 
 Чтобы наш обработчик перехватывал ошибки, нужно его прописать в файле `bitrix/.settings.php`, в секцию  
@@ -114,6 +115,6 @@ if (class_exists('Dotenv\\Dotenv')) {
 1. Удалить ключи `extension` и `required_file` из файла `bitrix/.settings.php`
 2. В `class_name` изменить класс на `'\\Webpractik\\Sentry\\SentryException'`
 3. Деактивировать и удалить модуль в админ панели
-4. В файле `composer.json` изменить версию пакета `webpractik/sentry` на 2.0
+4. В файле `composer.json` изменить версию пакета `webpractik/sentry` на ^2.0
 5. Выполнить в консоли `composer update webpractik/sentry`
 6. Сбросить кеш загрузчика composer, если возникнут ошибки `composer dump-autoload`

composer.json

@@ -17,7 +17,7 @@
   "require": {
     "php": ">=7.2",
     "sentry/sdk": "^3.1",
-    "vlucas/phpdotenv": "^4"
+    "vlucas/phpdotenv": "^3.3 || ^4"
   },
   "autoload": {
     "psr-4": {