Релиз PHP dotenv 3.0
На прошлой неделе вышла новая версия PHP dotenv 3.0 с некоторыми важными улучшениями внесенными в библиотеку. Библитека оставила поддержку старого API из версия 2.x.
Вот новые функции, которые можно найти в примечаниях к выпуску v3.0.0:
- Больше гибкости с точки зрения того, какие части среды мы пытаемся прочитать и изменить
- Первоклассная поддержка многострочных переменных
- Нет больше обрезки значений. вы получаете их точно так же, как передаете
- Принимает список путей, чтобы попробовать в порядке поиска файла dotenv, а не один путь
- Более строгая проверка имен переменных, чтобы избежать тихих сбоев или неясных ошибок
Во-первых, способ, которым вы обычно создаете экземпляр PHP dotenv, превращается в статический конструктор в v3. Вот фрагмент грядущего кода Laravel 5.8, который инициализирует PHP dotenv:
Dotenv::create($app->environmentPath(), $app->environmentFile())->safeLoad();
Если у вас есть дополнительные потребности, вы можете выполнить некоторые настройки Loader с помощью специальной реализации нового Dotenv\Environment\FactoryInterface. Если вы хотите узнать больше, я бы посоветовал вам ознакомиться с последним файлом readme и PR #300 для получения более подробной информации.
Далее, многострочная поддержка означает, что теперь можно определить переменную, которая занимает несколько строк:
MY_VARIABLE="value1 value2"
Что еще более интересно, многострочная поддержка и отсутствие обрезки означает, что сертификаты, ключи SSH и др. будет потребляться «как есть» без использования псевдо-символов новой строки.
Поскольку v3 больше не обрезает строки, вы захотите просмотреть свои проекты, использующие PHP dotenv, для любых переменных, на которые может повлиять это изменение, включая приложения Laravel.
Когда Laravel начнет использовать PHP dotenv 3.x?
Laravel 5.7 останется с v2, а обновление до v3.0 намечено для выпуска Laravel 5.8 позже в этом году.
