Лёгкая аугментация Yii2
- Когда окружение имеет значение -

Многим хорош Yii2, но есть одно неудобство — из коробки он не умеет работать с .env.
Частично проблему решают *-local.php и тот факт, что index.php обычно в игноре.
Но радужно это выглядит только на первый взгляд. 😫

Что имеем на практике:
— неудобно переключать окружение (YII_ENV) и режим дебага (YII_DEBUG);
— приходится плодить локальные правки в конфигурационных файлах;
— конфиги постепенно расползаются по проекту.

В итоге для поддержки разных окружений приходится делать лишние телодвижения.

Не-хо-ро-шо! 😭

Исправляем ситуацию:
— подключаем vlucas/phpdotenv,
— загружаем .env до определения констант и подключения конфигов.

Для basic template всё делается прямо в index.php:

require __DIR__ . '/../../vendor/autoload.php';

$dotenv = Dotenv\Dotenv::createImmutable(dirname(__DIR__));
$dotenv->load();

defined('YII_DEBUG') or define('YII_DEBUG', $_ENV['YII_DEBUG'] ?? false);
defined('YII_ENV') or define('YII_ENV', $_ENV['YII_ENV'] ?? 'prod');

И всё начинает работать как надо! 👍

В чём цимес:
— быстрое переключение окружений,
— чистая конфигурация без лишних правок,
— единая точка правды конфигов,
— нормальная изоляция секретов,
— Docker/CI friendly подход.

Yii2 - зрелый фреймворк. Но немного dotenv - и проект чувствует себя куда увереннее в современном мире.

Псст... шпаргалка прилагается.

#php #backend #yii2 #env #web #разработка

Кладбище миграций в Yii2

- Миграции...миграции никогда не меняются -

tl;dr

Если папка migrations разрослась до размеров энциклопедии -
разнесите миграции по подпапкам и добавьте их в migrationPath.

В начале проекта всё аккуратно, красиво, лакончно:

m240101_create_user_table.php
m240102_add_index_to_user.php

Через пару месяцев проблема нарастает:

m240101_create_user_table.php
m240102_add_index_to_user.php
m240203_fix_index.php
m240205_fix_index_again.php
m240206_final_fix_index_really.php
m240207_why_it_does_not_work.php

А через год папка migrations выглядит как кладбище древней цивилизации. ☠️

Но в Yii2 предусмотрели способ навести порядок - можно разнести миграции по папкам.

Создаём миграцию сразу в нужной директории:

php yii migrate/create \
  --migrationPath=@app/migrations/campaign create_campaign_table

И немного подсказываем фреймворку, где теперь их искать:

'controllerMap' => [
    'migrate' => [
        'class' => MigrateController::class,
        'migrationPath' => [
            '@app/migrations',
            '@app/migrations/attachment',
            '@app/migrations/campaign',
            '@app/migrations/company',
            '@app/migrations/contacts',
            '@app/migrations/geobase',
            '@app/migrations/invoice',
        ]
    ],
],

После этого yii migrate спокойно пройдётся по всем папкам и применит всё как обычно.

А структура проекта станет намного приятнее:

migrations/
├ attachments/
├ campaign/
├ company/
├ contacts/
└ invoice/

Yii2 всё поймёт - даже на кладбище файлов.

А вот человек через полгода хотя бы будет понимать, где искать fix_final_really_final_column.php.

#php #backend #yii2 #migration #миграции #web #разработка

Читальня. Вадим Панов - День чёрной собаки.

— Кто защитит Москву от Кровососа? —

Намедни была прочитана книга Вадима Панова «День чёрной собаки» – мистический триллер, было написано на обложке.

Ииии - не однозначно. 🤔

С одной стороны, В. Панов – один из моих любимых авторов и ожидания от книги, возможно, были завышены на старте. А с другой стороны, я не могу сказать, что чтиво не было увлекательным. От прочтения удовольствие было получено, читал каждую свободную минуту, а это ли не показатель хорошей истории? Сюжет захватывает, история развивается постепенно, равномерно, и сюжетные линии, даже, казалось бы, не очевидные, начинают сходиться в одну точку. Через какое-то время начинаешь догадываться кто тут злодей, но мотивация поступков героев книги остается непонятной до конца истории. А потом БАЦ! И паззл сложился! В общем, хороший детектив (для меня, как для не искушённого в детективах).

Но вот чего я не понял, так это зачем в историю приплели мистику. Мистика тут не то что бы играла какую-то роль, она тут смотрится чужеродной и ненужной, а некоторые мистические события книги выглядят совсем необъяснимыми. То есть если убрать мистику из книги, то ничего не изменится. Совсем! Возможно, это ружьё на стене, которое должно выстрелить в следующих книгах, но пока выглядит эта теория сомнительно. В общем, мистическая составляющая, лично у меня, вызвала вопросы.

Итого: я бы рекомендовал книгу, как неплохой детектив, но не посоветовал бы любителям мистики. А почитателям творчества В. Панова рекомендовал бы для ознакомления с новой гранью любимого писателя.

7 летучих мышей из 10.

#книги #почитать #ВадимПанов #Панов #ДеньЧёрнойСобаки #ФеликсВербин #детектив #триллер #мистика

12 апреля 1961 года — легендарный день!

В этот день советский космонавт Юрий Гагарин совершил первый пилотируемый полёт в космическое пространство и облетел Землю за 108 минут.

А кодовая фраза «Вижу горизонт», подтверждающая успешный выход в космос, стала символом успешного старта космической эры.

И пара интересных моментов:
— Существует история, что Юрия Гагарина на борт космического корабля "Восток-1" поднимали с помощью подъёмного крана. Это было связано с конструктивными особенностями корабля и скафандра. Скафандр был достаточно громоздким, и подниматься по лестнице в таком облачении было сложно;
— Так же есть история, из разряда неподтверждённых, что когда Юрий Гагарин приземлился в районе села Смеловка Саратовской области и повстречался с аборигенами, они его испугались, так как он был в скафандре. И тогда Гагарин сказал: "Свой, ребята, свой. Из космоса прилетел!"; 🇷🇺

С праздником! 🚀

#с_праздником

Когда сайт опережает мысли: искусство префетчинга.

Сегодня поговорим о том как ускорить работу сайта не потратив ни копейки. Для этого внимательно почитаем документацию на тему ресурсных подсказок (resource hints).

Дёшево, сердито и эффективно. Особенно, когда поднимаем гугл-попугаев в зелёную область. 🦜

#html, #prefetch, #resource_links, #оптимизация, #frontend, #web, #разработка

Не самый полезный фидбэк

Просматривая сериал Зло (4-й сезон, 3-я серия), узнал о существовании такого термина как фидбэк в контексте аграрного сектора. Так как в миру фидбэк ассоциируется с получением обратной связи, то использование привычного термина да не в привычном месте задело струнки любопытства. Ну, полюбопытствуем...

Так вот, фидбэк в аграрном производстве – это практика скармливания животным останков других животных. На английском это называется meat-and-bone meal (MBM), а на русском – мясокостная мука (МКМ).

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

Сторонники этой практики акцентируют внимание на экономической выгоде от такого подхода, так как утилизируются отходы мясной промышленности. Но есть и обратная сторона медали. Так, в 1990-х годах была вспышка эпидемий коровьего бешенства (BSE), причинами которой мог быть корм, содержащий материалы от других заражённых коров. После этого во многих странах ввели строгие ограничения и запреты на скармливание жвачным животным останков их же вида — во избежание "каннибалистического" круга передачи прионных заболеваний.

Практика использования мясокостной муки (МКМ) в разных странах регулируется по разному. После вспышки BSE в 1990-х запрет на использования MKM введён, например, в Евросоюзе, Японии, Канаде и других странах. Евросоюз, правда, в 2021 частично снял ограничения и разрешил использование MKM от свиней в кормах для птицы и наоборот, при условии отсутствия перекрестного загрязнения. А в таких странах как США и Австралия MKM разрешены для использования частично, а Вьетнам активно импортирует МКМ для использования в кормах для животных.

А что у нас на Родине?

В России использование мясокостной муки (МКМ) в кормлении животных регулируется законодательством и санитарными нормами, с акцентом на безопасность и предотвращение распространения заболеваний.

– запрещено использование МКМ, содержащей белки жвачных животных, в кормах для жвачных животных (коров, овец, коз);
– использование МКМ в кормах для нежвачных животных, таких как свиньи и птицы, разрешено при термической обработке при температуре не ниже 130°C в течение не менее 30 минут для инактивации потенциальных патогенов;
– а при производстве кормов для домашних животных, таких как кошки и собаки МКМ используется довольно широко.

Такие дела, брат.

Согласитесь, что фраза «получить фидбэк» заиграла новыми красками? 🐷

Источники: ruwiki, ФГБНУ «ФЦОБКП АПК», Своё фермерство, АгроЭксперт, wiki

#внезапно, #позновательно, #изюм, #feedback

Спекуляции по правилам

Продолжаем тему ускорения загрузки страниц сайта, поднятую в прошлой теме.

И сегодня на повестке Speculation Rules API - эволюционное развитие prefetch и prerender.

Честно говоря, информации получилось много, а опытных результатов - мало. Пока полноценно сей вундервафель никуда применить не удалось, но, на лабораторных крысах тестовом стенде результат получился впечатляющим - субъективно скорость рендера страницы (категория товаров с фильтром) изменилась с 3-х секунд до каких-то мгновений.⚡️

Впечатляет!

#html, #prefetch, #speculation, #speculation_rules_api, #оптимизация, #frontend, #web, #разработка

С Днём Победы! 🇷🇺

#с_праздником

Google Page Speed или как Google оценивает сайты

Так уж получилось, что сначала я затронул тему ресурсных подсказок, затем разобрал как предсказывать поведение пользователя, а теперь вот разберём, из-за чего все эти телодвижения были.

А было всё это для того, что бы улучшить показатели в Google Page Speed, которые называются Core Web Vitals.

Итак, Core Web Vitals от Google - это набор характеристик, которые показывают, насколько удобен для пользователя сайт. Эти показатели основываются на времени загрузки сайта, визуальной стабильности и удобстве взаимодействия с сайтом.

На текущий момент используются следующие показатели:
- FCP-метрика
- INP-метрика
- LCP-метрика
- CLS-метрика
- TTFB-метрика

Эти характеристики участвуют в качестве одного из факторов ранжирования сайта в поисковой выдаче Google и именно поэтому нужно стремиться их повысить.

Зачастую бытует мнение, что Google Page Speed показывает скорость загрузки сайта, но это не совсем так. Важно понимать, что показатели Google Page Speed отображают, насколько сайт соответствует рекомендациям Google в плане удобства пользования. Поэтому ориентироваться на показатели Google Page Speed, как на метрику скорости загрузки сайта, не корректно. Вполне может быть ситуация, что сайт может грузиться мгновенно, а количество баллов при тесте будет неудовлетворительным. Например, можно посмотреть на показатели таких сайтов как: ozon.ru, youtube.com, wb.ru и т.п.

🚨 Показатели Google Page Speed действительно играют важную роль, однако их следует воспринимать скорее как полезные рекомендации, которые помогают выявлять возможности для дальнейшего улучшения, а не как абсолютные критерии оценки производительности сайта.

Предлагаю на всё это дело посмотреть подробнее...

#google, #page, #speed, #core, #web, #vitals, #оптимизация, #frontend, #web, #разработка

Когда foreach встречает дзен

Сегодня хочу рассказать о генераторах, которые такие же как итераторы, но только лучше.

Почему я про них вспомнил - на днях встала задачка перебрать несколько миллионов записей статистики и обработать их на лету. Подходя к решению вопроса стандартно, то сделал бы что-нибудь такое:

$statistics = [];
foreach ($items as $item) {
   $statistics[] = setPaymentId($item);
}

И при обработке записей словил бы логичное сообщение о превышением памяти:

Fatal error: Allowed memory size of xxxxxx bytes exhausted (tried to allocate xxxxx bytes) in BalanceController.php on line xx

Но хорошо, что есть они – генераторы!

С использованием генераторов код немного видоизменится и перестанет есть память как не в себя:

$generator = function (): Generator {    
     foreach ($items as $item) {        
          yield $item;    
     }
};

foreach ($generator() as $item) {    
     setPaymentId($item);
}

Генераторы позволяют перебрать набор данных не загружая их в полном объёме в память, а обрабатывать их по одному элементу.

В PHP это достигается через использования ключевого слова yield.

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

По некоторым данным, использование генераторов дают выигрыш в скорости работы: примерно в 4 раза быстрее чем итераторы и на 40% быстрее обычного перебора.

И, как итог, тезисно о генераторах:
- Это не новая функциональность, а развитие существующей;
- Увеличенная скорость обработки большого кол-ва данных;
- Генераторы однонаправленны и работают только «вперёд»;
– Позволяют строить более понятные кодовые конструкции;

Что ж, придётся поправить кое-какие скрипты, обрабатывающие статистику. 📊

А для более любопытствующих есть и развёрнутая версия.

#php, #yield, #генераторы, #web, #разработка

CONST умер! Да здравствует ENUM!

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

Но время шло, трава становилась всё менее зелёной, а требования к коду – всё выше. Да и ошибки могли нет-нет, да и проскочить при использовании констант:

- Ошибки в значениях: легко случайно присвоить неправильный числовой идентификатор или строку;
- Отсутствие встроенного контроля типов: компилятор или интерпретатор не могли гарантировать правильность передаваемых значений;

И удобного механизма сравнения при работе с константами тоже не имелось: приходилось постоянно сравнивать строки или числа вручную.

Всё это и привело к появлению стандартизированного способа объявления перечислений, который был добавлен в PHP8.1.

Что умеет ENUM

- Перечисления могут быть обычные:

enum Status {     
    case Active;     
    case Inactive;
}

- А могут быть типизированными:

enum Status: string {     
    case Active = ‘active’;     
    case Inactive = ‘inactive’;
}

Причём перечисления могут быть или только чистыми, или только типизированными, а их пересечение не допускается. Так же есть ограничения и по типу скалярных значений для типизированных перечислений – это integer и string.

- Благодаря встроенному методу cases, enum удобно перебирать:

foreach (Status::cases() as $status) {
    echo $status->value;
}

Например для построения выпадающих списков.

- Так же enum можно использовать для подсказки типов в функциях:

function setStatus(Status $status) {
    // сохранение статуса в базу данных
}

Благодаря этому аргумент метода ожидает опцию только из перечисления.
----------------
Таким образом применение перечислений облегчает разработку, снижает вероятность ошибок и делает приложение стабильнее и надежнее. Поэтому использование перечислений можно считать лучшей практикой в современном PHP.

И традиционно, для любопытствующих, чуть больше информации 😉

#php #enum #перечисления #web #разработка