<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Пых / PHPYH - Medium]]></title>
        <description><![CDATA[Блог @vudaltsov о разработке на PHP | t.me/phpyh - Medium]]></description>
        <link>https://medium.com/phpyh?source=rss----51c875da5228---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>Пых / PHPYH - Medium</title>
            <link>https://medium.com/phpyh?source=rss----51c875da5228---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 21:53:36 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/phpyh" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Экспорт в Excel просто, быстро и красиво]]></title>
            <link>https://medium.com/phpyh/%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82-%D0%B2-excel-%D0%BF%D1%80%D0%BE%D1%81%D1%82%D0%BE-%D0%B1%D1%8B%D1%81%D1%82%D1%80%D0%BE-%D0%B8-%D0%BA%D1%80%D0%B0%D1%81%D0%B8%D0%B2%D0%BE-e199b8157b8a?source=rss----51c875da5228---4</link>
            <guid isPermaLink="false">https://medium.com/p/e199b8157b8a</guid>
            <category><![CDATA[symfony]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[analytics]]></category>
            <category><![CDATA[box-spout]]></category>
            <dc:creator><![CDATA[Удальцов Валентин]]></dc:creator>
            <pubDate>Mon, 18 May 2020 01:50:35 GMT</pubDate>
            <atom:updated>2020-05-18T01:50:35.167Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*dfpICFu2XYL2bJlw.png" /><figcaption><a href="https://professor-excel.com/excel-wallpaper/">https://professor-excel.com/excel-wallpaper/</a></figcaption></figure><p>Проект <a href="https://happy-job.ru/">Happy Job</a>, где я занимаюсь проектированием и разработкой бэкенда, — это в первую очередь аналитика.</p><p>А какая аналитика без выгрузок в Excel 😉</p><p>Раньше я всегда использовал библиотеку <a href="https://phpspreadsheet.readthedocs.io/en/latest/">PHPOffice/PhpSpreadsheet</a> (бывшая PHPOffice/PHPExcel). Она предоставляет почти полный инструментарий для работы с таблицами, но есть один большой минус — формирование листа по умолчанию происходит в памяти. Одна ячейка вместе с метаданными весит примерно 1 Кбайт, поэтому выгрузка лишь 400 000 строк в три колонки уже обойдется более чем в 1 Гбайт памяти. В библиотеке предусмотрена <a href="https://phpspreadsheet.readthedocs.io/en/latest/topics/memory_saving/">возможность кешировать ячейки</a> на базе PSR-16, но это значительно снижает скорость записи.</p><p>Для нашего кейса я нашёл решение получше. Куда менее популярная библиотека <a href="https://opensource.box.com/spout/">box/spout</a> позволяет читать Excel-файлы и писать в них построчно и очень быстро. Расход памяти константный из коробки, без всяких плясок с кешем (по факту она, конечно, создает какие-то временные файлы в sys_get_temp_dir()). Пакет тоже поддерживает листы и типы данных, но не умеет в автоширину, объединение ячеек и продвинутое форматирование. Я уверен, что как и для нас, для большинства проектов это приемлемый компромисс.</p><h4>Интеграция «<strong>в лоб</strong>»</h4><p>Вот как может выглядеть черновой экшн для выгрузки отчёта, сделанный по документации <a href="https://opensource.box.com/spout/getting-started/">Box Spout</a> и <a href="https://symfony.com/doc/current/components/http_foundation.html#serving-files">Symfony HttpFoundation</a>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/6feb14d9aa8470ad4066a81a9447a59e/href">https://medium.com/media/6feb14d9aa8470ad4066a81a9447a59e/href</a></iframe><h4>Оптимизация</h4><p>Что тут можно оптимизировать? Временный файл кажется лишним. Если Spout умеет писать построчно в файл, значит может стримить и напрямую в буфер!</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/07e66885f8cdd40045ed3dcd301cc5f1/href">https://medium.com/media/07e66885f8cdd40045ed3dcd301cc5f1/href</a></iframe><h4>Рефакторинг</h4><p>А теперь вооружимся SOLID и сделаем этот код переиспользуемым в рамках конкретного приложения. Но не будем оверинжинирить —проектный инструмент должен получиться простым и гибким ровно настолько, насколько этого требуют юзкейсы. Рассмотрим Excel выгрузки Happy Job:</p><ul><li>всегда используется формат xlsx;</li><li>содержимое таблиц нетиповое, нужен полный контроль над листами, строками и ячейками;</li><li>один экшн— один файл.</li></ul><p>Получается, что относительно примера выше в нашем приложении код будет варьироваться только в строках 28–33. Всё остальное можно вынести в сервис.</p><p>Самый простой и универсальный способ внедрить кусок кода в середину метода? Аргумент типа callable!</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/514141269660629375d5ba892f749378/href">https://medium.com/media/514141269660629375d5ba892f749378/href</a></iframe><p>Обратите внимание, что тип возвращаемого значения Response, а не StreamedResponse. Так мы скрыли подробности реализации и объявили более универсальный контракт. Если в будущем нам потребуется несколько реализаций фабрики, достаточно будет сделать ExcelResponseFactory интерфейсом, и всё уже будет готово для полиморфизма без правки сигнатур и клиентского кода (экшнов).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/eae18d2bec2be0a7c13d9164f0c8c4c8/href">https://medium.com/media/eae18d2bec2be0a7c13d9164f0c8c4c8/href</a></iframe><p>Иногда код, наполняющий $writer данными, оказывается слишком сложным для замыкания. В таких случаях его можно вынести в отдельный класс с методом __invoke. В этом для меня состоит главное преимущество callable перед интерфейсом при организации простых точек расширения.</p><p><a href="https://gist.github.com/vudaltsov/ed189664b976b9aab3411a5edd827e2c">Юнит-тесты для фабрики</a>. На мой взгляд, testResponseContent сложноват. Если есть идеи, как оформить его изящнее, пишите в комментариях.</p><p>В заключение повторюсь, данное решение работает лишь в конкретном проекте. Вам может потребоваться более простая или более сложная интеграция Spout в зависимости от специфики. Но никогда не переусложняйте раньше времени.</p><p>Пишите библиотеки универсально, а проекты оптимально 👌</p><p>Подписывайтесь на канал <a href="https://t.me/phpyh">Пых в телеграме</a>, чтобы узнать еще больше лайфхаков для PHP и Symfony!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e199b8157b8a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/phpyh/%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82-%D0%B2-excel-%D0%BF%D1%80%D0%BE%D1%81%D1%82%D0%BE-%D0%B1%D1%8B%D1%81%D1%82%D1%80%D0%BE-%D0%B8-%D0%BA%D1%80%D0%B0%D1%81%D0%B8%D0%B2%D0%BE-e199b8157b8a">Экспорт в Excel просто, быстро и красиво</a> was originally published in <a href="https://medium.com/phpyh">Пых / PHPYH</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Правильная регистрация консольных команд в Symfony DI]]></title>
            <link>https://medium.com/phpyh/%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D0%BA%D0%BE%D0%BD%D1%81%D0%BE%D0%BB%D1%8C%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4-%D0%B2-symfony-di-f7536c254926?source=rss----51c875da5228---4</link>
            <guid isPermaLink="false">https://medium.com/p/f7536c254926</guid>
            <category><![CDATA[symfony]]></category>
            <category><![CDATA[lazy-initialization]]></category>
            <category><![CDATA[console]]></category>
            <category><![CDATA[php]]></category>
            <dc:creator><![CDATA[Удальцов Валентин]]></dc:creator>
            <pubDate>Mon, 20 Apr 2020 11:37:22 GMT</pubDate>
            <atom:updated>2020-05-17T12:40:30.475Z</atom:updated>
            <content:encoded><![CDATA[<h3>Правильная регистрация консольных команд Symfony в DI</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Jb7oqOBN7BL1Turqe2wqBQ.png" /></figure><p>Как добавить такую команду в DI?</p><pre><br>&lt;?php</pre><pre>declare(strict_types=1);</pre><pre>namespace App\Console;</pre><pre>use Symfony\Component\Console\Command\Command;</pre><pre>final class DoStuffCommand extends Command<br>{<br>    protected function configure(): void<br>    {<br>        $this<br>            -&gt;setName(&#39;app:do:stuff&#39;)<br>            -&gt;setDescription(&#39;This command does stuff&#39;)<br>        ;<br>    }<br>    <br>    // ...<br>}</pre><h3>Неправильный способ</h3><pre>services:<br>    _defaults:<br>        autoconfigure: true</pre><pre>    App\Console\DoStuffCommand: ~<br>        # tags: [ console.command ]<br>        # с тегом, если не используется автоконфигурация</pre><p>В чем тут проблема? Symfony DI не знает имя вашей команды при компиляции! Если в проекте есть такие команды, консольное приложение будет <a href="https://github.com/symfony/symfony/blob/6f81e033312f5feb744507766d02f2e8cae01e9b/src/Symfony/Bundle/FrameworkBundle/Console/Application.php#L191">все их инициализировать при каждом вызове bin/console</a> с единственной целью — выяснить название запросом <a href="https://github.com/symfony/symfony/blob/6f81e033312f5feb744507766d02f2e8cae01e9b/src/Symfony/Component/Console/Application.php#L473">$command-&gt;getName()</a>.</p><p>Во-первых, это затратно, потому что при вызове любой одной команды вы поднимаете все сервисы non-lazy команд вместе с их зависимостями.</p><p>Во-вторых, это приводит к ошибкам вида Could not connect to PostgreSQL/Redis/… во время прогрева кэша, потому что cache:clear — это тоже консольная команда. Обычно такая проблема всплывает либо при разворачивании проекта локально, когда соответствующий сервис еще не создан или не настроен, либо в CI, где он, например, для юнит-тестов вообще не нужен.</p><p>Чтобы этого избежать, нужно всего лишь рассказать DI про имя команды заранее.</p><h3>Старый неудобный способ</h3><pre>services:<br>    App\Console\DoStuffCommand:<br>        tags:<br>            - { name: console.command, command: app:do:stuff }</pre><p>В этом случае DI <a href="https://github.com/symfony/symfony/blob/6f81e033312f5feb744507766d02f2e8cae01e9b/src/Symfony/Component/Console/DependencyInjection/AddConsoleCommandPass.php#L78">запомнит имя команды при компиляции</a> и она станет lazy.</p><p>Минусы данного подхода — дублирование имени команды и провал автоконфигурации.</p><h3>Правильный способ</h3><p>Как еще можно задать имя команды без создания экземпляра? Статически, прости Господи! Что и было <a href="https://github.com/symfony/symfony/pull/23887">предложено 3 года назад</a>.</p><p>Теперь наш класс выглядит так:</p><pre>&lt;?php</pre><pre>declare(strict_types=1);</pre><pre>namespace App\Console;</pre><pre>use Symfony\Component\Console\Command\Command;</pre><pre>final class DoStuffCommand extends Command<br>{<br>    protected static $defaultName = &#39;app:do:stuff&#39;;</pre><pre>    protected function configure(): void<br>    {<br>        $this-&gt;setDescription(&#39;This command does stuff&#39;);<br>    }</pre><pre>    // ...<br>}</pre><p>Конфигурацию оставляем в первоначальном виде.</p><pre>services:<br>    _defaults:<br>        autoconfigure: true</pre><pre>    App\Console\DoStuffCommand: ~<br>        # tags: [ console.command ]<br>        # с тегом, если не используется автоконфигурация</pre><p>Про то же самое в <a href="https://symfony.com/doc/current/console/commands_as_services.html">документации Symfony</a>.</p><h3>Как это работает</h3><p>Для команд, имя которых известно заранее, <a href="https://github.com/symfony/symfony/blob/6f81e033312f5feb744507766d02f2e8cae01e9b/src/Symfony/Component/Console/DependencyInjection/AddConsoleCommandPass.php#L94">AddConsoleCommandPass формирует service locator</a>. Если рассказывать на пальцах, то это ассоциативный массив, где ключ — имя сервиса, а значение — вызов $container-&gt;get(&#39;service_id&#39;), обернутый в Closure (шаблон lazy initialization). Поиск команд по частичному совпадению (вы ведь знаете, что <a href="https://symfony.com/doc/current/components/console/usage.html#shortcut-syntax">можно писать </a><a href="https://symfony.com/doc/current/components/console/usage.html#shortcut-syntax">bin/console d:m:di вместо </a><a href="https://symfony.com/doc/current/components/console/usage.html#shortcut-syntax">bin/console doctrine:migrations:diff</a>?) выполняется на базе ключей. Когда имя команды окончательно разрешено, консольное приложение получает объект команды вызовом Closure по соответствующему ключу. Именно в этот самый последний момент DI собирает сервис и все его зависимости. При этом, очевидно, другие команды остаются нетронутыми и продолжают тихо спать в своих Closure. Если у вас есть команда, которая требует EntityManager, который в свою очередь запрашивает подключение к БД, то теперь она не выстрелит ошибкой при чистке кэша в CI без сервиса БД.</p><p>Service locator в таком контексте не является антипаттерном. По сути, это коллекция объектов одного типа со встроенной отложенной инициализацией. Начиная с Symfony 3.3 локаторы сервисов, отмеченных определенным тегом, <a href="https://symfony.com/doc/current/service_container/service_subscribers_locators.html">легко и удобно объявлять в конфигурации DI</a>. Я часто пользуюсь этим инструментом в проектах и библиотеках.</p><h3>Что делать, если у меня не так</h3><p>Рефакторить! Особенно если у вас есть проблемы с подключением к I/O. Всё что нужно сделать — перенести имя команды из метода configure в статическое свойство $defaultName. Для поиска non-lazy команд в Symfony 4/5 можно использовать отладку параметров через консоль: bin/console debug:container --parameter=console.command.ids (<a href="https://github.com/symfony/symfony/blob/6f81e033312f5feb744507766d02f2e8cae01e9b/src/Symfony/Component/Console/DependencyInjection/AddConsoleCommandPass.php#L96">это следует из кода AddConsoleCommandPass</a>). Если проблемных команд немного, проще исправить руками. Год назад в одном большом проекте я прошелся замысловатой regexp-заменой по папке src.</p><p>Что касается вендорных пакетов, то команды Symfony из коробки зарегистрированы как lazy вторым или третьим способом. То же самое с Doctrine — я лично отправлял PR в <a href="https://github.com/doctrine/migrations/pull/839">doctrine/migrations</a> и <a href="https://github.com/doctrine/DoctrineMigrationsBundle/pull/275">doctrine/DoctrineMigrationsBundle</a>.</p><p>В остальных случаях у вас есть отличная возможность законтрибьютить 😊</p><p>Подписывайтесь на канал <a href="https://t.me/phpyh">Пых в телеграме</a>, чтобы узнать еще больше лайфхаков для PHP и Symfony!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f7536c254926" width="1" height="1" alt=""><hr><p><a href="https://medium.com/phpyh/%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D0%BA%D0%BE%D0%BD%D1%81%D0%BE%D0%BB%D1%8C%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4-%D0%B2-symfony-di-f7536c254926">Правильная регистрация консольных команд в Symfony DI</a> was originally published in <a href="https://medium.com/phpyh">Пых / PHPYH</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Новое в Symfony 4.3: Улучшены финансовые валидаторы]]></title>
            <link>https://medium.com/phpyh/new-in-symfony-4-3-improved-financial-constraints-4aa0b16b33e9?source=rss----51c875da5228---4</link>
            <guid isPermaLink="false">https://medium.com/p/4aa0b16b33e9</guid>
            <category><![CDATA[finance]]></category>
            <category><![CDATA[validation]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[symfony]]></category>
            <category><![CDATA[symfony4]]></category>
            <dc:creator><![CDATA[Удальцов Валентин]]></dc:creator>
            <pubDate>Fri, 11 Jan 2019 13:22:28 GMT</pubDate>
            <atom:updated>2019-01-11T13:22:28.254Z</atom:updated>
            <content:encoded><![CDATA[<p>Перевод статьи <a href="https://symfony.com/blog/new-in-symfony-4-3-improved-financial-constraints">New in Symfony 4.3: Improved Financial Constraints</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tqsPS7lN2LHkhg3_GlDCXw.jpeg" /></figure><h3>Проверка кода IBAN</h3><p><a href="https://ru.wikipedia.org/wiki/IBAN">Международный номер банковского счета</a> (IBAN) является согласованной на международном уровне системой идентификации банковских счетов. <a href="https://ru.wikipedia.org/wiki/%D0%91%D0%B0%D0%BD%D0%BA%D0%BE%D0%B2%D1%81%D0%BA%D0%B8%D0%B9_%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BA%D0%BE%D0%B4">Банковский идентификационный код</a> (BIC) — это уникальный идентификационный код как для финансовых, так и для нефинансовых учреждений, определенный в стандарте <a href="https://ru.wikipedia.org/wiki/ISO_9362">ISO 9362</a>.</p><p>Несмотря на то, что оба кода являются независимыми, их можно проверять совместно, чтобы удостовериться, что оба принадлежат к одной стране. В Symfony 4.3 валидатор <a href="https://symfony.com/doc/current/reference/constraints/Bic.html">Bic</a> получит такой функционал.</p><p>Для начала можно явно указать код IBAN с помощью новой опции iban:</p><pre>use Symfony\Component\Validator\Constraints as Assert;<br><em>// ...</em><br><br>public static function loadValidatorMetadata(ClassMetadata $metadata)<br>{<br>    $metadata-&gt;addPropertyConstraint(&#39;businessIdentifierCode&#39;, new Assert\Bic([<br>        &#39;iban&#39; =&gt; &#39;FR1420041010050500013M02606&#39;,<br>    )]);<br>}</pre><p>Но можно также использовать ibanPropertyPath, чтобы получать IBAN из валидируемого объекта динамически:</p><pre>use Symfony\Component\Validator\Constraints as Assert;<br><em>// ...</em><br><br>class Transaction<br>{<br>    <em>/**</em><br><em>     * @Assert\Bic(ibanPropertyPath=&quot;accountNumber&quot;)</em><br><em>     */</em><br>    public $businessIdentifierCode;<br><br>    <em>/**</em><br><em>     * @Assert\Iban</em><br><em>     */</em><br>    public $accountNumber;<br><br>    <em>// ...</em><br>}</pre><p>Добавлено <a href="https://connect.symfony.com/profile/sylfabre">Sylvain Fabre</a> в <a href="https://github.com/symfony/symfony/pull/28479">#28479</a>.</p><h3>Добавлена поддержка карт UATP</h3><p><a href="https://en.wikipedia.org/wiki/Universal_Air_Travel_Plan">Universal Air Travel Plan</a> (UATP) — это платежная сеть, принадлежащая авиакомпаниям и принимаемая тысячами продавцов для оплаты авиационных, железнодорожных, гостиничных и туристических услуг. В Symfony 4.3 улучшен <a href="https://symfony.com/doc/master/reference/constraints/CardScheme.html">валидатор CardScheme</a>, и теперь он поддерживает новую схему UATP:</p><pre><em>// ...</em><br><br>class Transaction<br>{<br>    <em>/**</em><br><em>     * @Assert\CardScheme(</em><br><em>     *     schemes={&quot;AMEX&quot;, &quot;MASTERCARD&quot;, &quot;UATP&quot;, &quot;VISA&quot;},</em><br><em>     *     message=&quot;Некорректный номер карты.&quot;</em><br><em>     * )</em><br><em>     */</em><br>    public $cardNumber;<br>}</pre><p>Добавлено <a href="https://connect.symfony.com/profile/raulfraile">Raúl Fraile</a> в <a href="https://github.com/symfony/symfony/pull/29504">#29504</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4aa0b16b33e9" width="1" height="1" alt=""><hr><p><a href="https://medium.com/phpyh/new-in-symfony-4-3-improved-financial-constraints-4aa0b16b33e9">Новое в Symfony 4.3: Улучшены финансовые валидаторы</a> was originally published in <a href="https://medium.com/phpyh">Пых / PHPYH</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Новое в Symfony 4.3: Безусловное включение в URL необязательного параметра маршрута]]></title>
            <link>https://medium.com/phpyh/new-in-symfony-4-3-unconditional-including-an-optional-route-parameter-in-the-url-cae44c612b66?source=rss----51c875da5228---4</link>
            <guid isPermaLink="false">https://medium.com/p/cae44c612b66</guid>
            <category><![CDATA[symfony]]></category>
            <category><![CDATA[symfony4]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[routing]]></category>
            <dc:creator><![CDATA[Удальцов Валентин]]></dc:creator>
            <pubDate>Wed, 02 Jan 2019 23:45:59 GMT</pubDate>
            <atom:updated>2019-01-02T23:48:50.728Z</atom:updated>
            <content:encoded><![CDATA[<p>Перевод статьи <a href="https://medium.com/@symfony/new-in-symfony-4-3-always-include-route-default-values-2511ff6575ef">New in Symfony 4.3: Always Include Route Default Values</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bgW2-Ds3bH4zAlMO7dcIZQ.jpeg" /></figure><p>Маршрутизация в Symfony позволяет <a href="https://symfony.com/doc/4.2/routing.html#giving-placeholders-a-default-value">указать значение по умолчанию для параметра маршрута</a>. При генерации URL последний параметр маршрута будет опущен, если его значение не передано или совпадает со значением по умолчанию. Рассмотрим пример:</p><pre>namespace App\Controller;</pre><pre>use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;<br>use Symfony\Component\Routing\Annotation\Route;</pre><pre>class BlogController extends AbstractController<br>{<br>    /**<br>     * @Route(&quot;/blog/{page}&quot;, name=&quot;blog_list&quot;)<br>     */<br>    public function list($page = 1)<br>    {<br>        // ...<br>    }<br>}</pre><p>Если вы не укажете значение параметра page при генерации URL на базе маршрута blog_list, результирующим URL будет /blog, а аргумент page будет равен 1:</p><pre>$router = ... // экземпляр UrlGeneratorInterface</pre><pre>$url = $router-&gt;generate(&#39;blog_list&#39;);                // /blog<br>$url = $router-&gt;generate(&#39;blog_list&#39;, [&#39;page&#39; =&gt; 1]); // /blog/1<br>$url = $router-&gt;generate(&#39;blog_list&#39;, [&#39;page&#39; =&gt; 7]); // /blog/7</pre><p>Как правило, это желаемое поведение в большинстве ситуаций. Но иногда последний параметр должен присутствовать в сгенерированном URL вне зависимости от того, передано значение или нет. В Symfony 4.3 это станет возможным благодаря обновленному синтаксису маршрута:</p><pre>/**<br> * @Route(&quot;/blog/{!page}&quot;, name=&quot;blog_list&quot;)<br> */<br>public function list($page = 1)<br>{<br>    // ...<br>}</pre><p>Восклицательный знак ! перед именем параметра сообщает роутеру о том, что параметр должен быть включен в URL безусловно:</p><pre>$url = $router-&gt;generate(&#39;blog_list&#39;);                // /blog/1<br>$url = $router-&gt;generate(&#39;blog_list&#39;, [&#39;page&#39; =&gt; 1]); // /blog/1<br>$url = $router-&gt;generate(&#39;blog_list&#39;, [&#39;page&#39; =&gt; 7]); // /blog/</pre><p>Добавлено <a href="https://connect.symfony.com/profile/luchaninov">Владимиром Лучаниновым</a> в <a href="https://github.com/symfony/symfony/pull/29599">#29599</a>.</p><h3>От переводчика</h3><p>Предлагаю рассмотреть еще один пример из пояснения к <a href="https://github.com/symfony/symfony/pull/29599#issue-238570954">PR</a>.</p><h4>Задача</h4><p>Организовать маршрутизацию для экспорта новостей в форматах CSV и XML с использованием <a href="https://symfony.com/doc/4.2/templating/formats.html">системного параметра </a><a href="https://symfony.com/doc/4.2/templating/formats.html">_format</a>. Формат по умолчанию CSV. Расширение должно всегда присутствовать в URL с целью повышения его информативности.</p><h4>Вариант 1</h4><p>Зашить расширение в путь и присвоить атрибут вручную:</p><pre>@Route(&quot;/news/export.csv&quot;, name=&quot;news_export&quot;, defaults={&quot;_format&quot;: &quot;csv&quot;})<br>@Route(&quot;/news/export.xml&quot;, name=&quot;news_export_xml&quot;, defaults={&quot;_format&quot;: &quot;xml&quot;})</pre><p>Выглядит избыточно; очень неудобно в использовании из-за двух маршрутов.</p><h4>Вариант 2</h4><p>Оставить расширение обязательным параметром:</p><pre>@Route(&quot;/news/export.{_format&lt;csv|xml&gt;}&quot;, name=&quot;news_export&quot;)</pre><p>Придется всегда указывать формат {{ path(&#39;export_news&#39;, {_format: &#39;csv&#39;}) }}.</p><h4>Symfony 4.3</h4><pre>@Route(&quot;/news/export.{!_format&lt;csv|xml&gt;?csv}&quot;, name=&quot;news_export&quot;)</pre><p>Итак, в Symfony 4.3 при помощи записи {!slug} мы сможем гарантировать наличие параметра slug в сгенерированном URL вне зависимости от его значения.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cae44c612b66" width="1" height="1" alt=""><hr><p><a href="https://medium.com/phpyh/new-in-symfony-4-3-unconditional-including-an-optional-route-parameter-in-the-url-cae44c612b66">Новое в Symfony 4.3: Безусловное включение в URL необязательного параметра маршрута</a> was originally published in <a href="https://medium.com/phpyh">Пых / PHPYH</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Не игнорьте composer.lock]]></title>
            <link>https://medium.com/phpyh/dont-ignore-composer-lock-6f9fb3dc511a?source=rss----51c875da5228---4</link>
            <guid isPermaLink="false">https://medium.com/p/6f9fb3dc511a</guid>
            <category><![CDATA[php]]></category>
            <category><![CDATA[deployment]]></category>
            <category><![CDATA[composer]]></category>
            <dc:creator><![CDATA[Удальцов Валентин]]></dc:creator>
            <pubDate>Mon, 06 Aug 2018 12:49:08 GMT</pubDate>
            <atom:updated>2018-08-06T17:29:26.601Z</atom:updated>
            <content:encoded><![CDATA[<h4>install vs update</h4><blockquote>Создаю проект. Объявляю зависимости в composer.json. composer update или composer install? Сделаю так: в первый раз запущу install, потом буду update, логично же? Вижу файл composer.lock. Ну ок, наверное, это что-то нужное, залью его.</blockquote><blockquote>После очередного запуска composer update опять изменился чёртов composer.lock. А в прошлый раз так вообще кофликт из-за него при слиянии был. Да пошел он в .gitignore!</blockquote><blockquote>Какой же этот Composer долгий… И памяти жрёт при обновлении…</blockquote><blockquote>Время заливать проект на продакшн. Эм… какую команду прописать в скрипт обновления площадки? Ну пусть будет composer install. После очередного обновления продакшн фатально падает. Выясняется, что пакеты на сервере не обновляются. Так и знал, что install не сработает. Меняю на update.</blockquote><blockquote>Через какое-то время после очередного деплоймента продакшн снова фатально падает. Какого..?</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kEMZP3LqJ9Cq16atzBH79w.jpeg" /></figure><p><a href="https://getcomposer.org/">Composer</a> — одна из причин, по которой PHP сегодня именно такой. Популярный, прогрессивный и удобный. Именно поэтому мы в <a href="https://ruvents.com/">RUVENTS</a> считаем понимание принципов работы менеджера зависимостей одним из ключевых навыков PHP-программиста.</p><p>К сожалению, на собеседовании на вопрос “Чем отличаются команды composer install и composer update?” мы слишком часто слышим ответ “Не знаю” или, ещё хуже, “Ничем”.</p><p>В этой статье в надежде на то, что её прочтет наш будущий соискатель, мы в очередной раз расскажем, чем отличается install от update и почему так важно не добавлять composer.lock в .gitignore.</p><h3>Фиксация зависимостей</h3><p>При работе с зависимостями нам хотелось бы достичь следующих результатов:</p><ol><li><strong>Согласованности</strong>. Все площадки (локальные проекты разработчиков, сервисы CI, продакшн-сервера) с проектом в состоянии коммита X должны иметь идентичный набор пакетов.</li><li><strong>Контроля</strong> над процессом обновления. Мы хотим обновлять зависимости по желанию в ручном режиме.</li><li><strong>Стабильности</strong> при деплойменте. Отсутствие ошибок и падений из-за установки неверных зависимостей.</li><li><strong>Высокой скорости</strong> и <strong>низкого потребления памяти</strong> при развертывании.</li></ol><p>Для достижения этих целей необходим механизм, который в момент фиксации изменений будет запоминать состояние зависимостей как часть состояния проекта. Назовем это <em>фиксацией зависимостей</em>.</p><p>Самая простая реализация такого механизма — <em>lock-файл</em> с информацией об установленных зависимостях. Файл должен храниться в репозитории и позволять однозначно воспроизводить на любой другой площадке набор пакетов, использованных программистом при разработке.</p><h3>А что там у Composer</h3><p>В Composer lock-файл называется composer.lock и располагается в корне проекта. Чтобы понять, как он генерируется и используется, разберем механизм работы двух команд менеджера.</p><h4>composer update</h4><p>Задача команды composer update — <strong>обновить зависимости проекта</strong> до актуальных версий в соответствии с правилами, записанными в composer.json.</p><p>Для каждого заявленного в проекте пакета менеджер находит его источник, считывает информацию о версиях и зависимостях, а затем рекурсивно повторяет то же самое для зависимостей пакета, чтобы получить полное дерево. После этого Composer разрешает зависимости с учетом версионных правил, объявленных во всех собранных composer.json файлах.</p><p>Информация о пакете, рекомендованном к установке, имеет следующий вид:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3902e0ecab693507194d67d64d344fdd/href">https://medium.com/media/3902e0ecab693507194d67d64d344fdd/href</a></iframe><p>Плоский массив таких объектов будет записан в формате JSON в злополучный файл composer.lock по завершении команды. Это и есть фиксация зависимостей в Composer.</p><p>После всех этих ресурсоёмких операций менеджер сопоставляет разрешенные зависимости с уже имеющимися пакетами в папке vendor/ и устраняет несоответствия: удаляет устаревшие и ненужные пакеты, скачивает (или подтягивает из кэша) новые и добавленные.</p><h4>composer install</h4><p>Задача команды composer install — <strong>установить зафиксированные зависимости проекта</strong>.</p><p>При запуске команды Composer первым делом ищет файл composer.lock. В случае успеха, минуя вышеописанные сложные процедуры, менеджер мгновенно получает массив разрешенных зависимостей из lock-файла и сразу приступает к обновлению папки vendor/.</p><p>Если composer.lock отсутствует, команда выполняет те же действия, что и composer update (включая создание lock-файла).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sy9gJpMXvGgo9ZBl3hjvEg.png" /></figure><p>Итак, composer install использует зафиксированные в composer.lock зависимости как готовую инструкцию для установки/обновления, а composer update игнорирует этот файл и производит установку/обновление с нуля.</p><p>Также команда composer install, очевидно, выполняется гораздо быстрее composer update и требует совсем немного памяти.</p><h3>Может быть всё-таки заигнорить?</h3><p>Нет. Игнорировать можно девушку или парня, чтобы подогреть интерес к себе (только не переборщите!). composer.lock же, напротив, сразу готов с вами сотрудничать.</p><p>Не храня lock-файл в репозитории, вы отказываетесь от механизма фиксации зависимостей. Несмотря на то, что composer.lock будет в любом случае сгенерирован, Composer не сможет гарантировать, что установленные пакеты будут иметь те же версии, что при разработке.</p><h3>Почему упал продакшн?</h3><p>Как вы теперь поняли, история из предисловия (основанная на реальных событиях) демонстрирует ошибочную цепочку рассуждений. И вот каким образом она может привести к беде.</p><p>Допустим, есть composer.json следующего содержания:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fce3b098aeaee678fbda4717ff1d8b08/href">https://medium.com/media/fce3b098aeaee678fbda4717ff1d8b08/href</a></iframe><p>Прописанное для vendor/package правило позволяет обновлять пакет в пределах версий &gt;=2.0.2, &lt;3.0.0.</p><p>Допустим, вышел релиз 2.0.3, в который закралась ошибка. Так как на продакшн-сервере обновления накатываются бесконтрольно при каждом деплойменте, vendor/package успешно обновился, хотя горе-разработчик об этом даже не догадывался. FAIL!</p><p>Если бы программист использовал composer install и заливал composer.lock в репозиторий, он имел бы полный контроль на обновлением пакетов. Прогнав после планового composer update тесты <em>(обновив страницу в браузере)</em>, он бы заметил ошибку и добавил бы бажную версию в раздел conflict файла composer.json.</p><h3>Как с этим жить</h3><p>Теперь, когда вы узнали о фиксации зависимостей, разобрались с командами и-таки убрали строку из .gitignore, самое время подвести черту и обсудить workflow.</p><ol><li>Первое правило lock-клуба: по умолчанию всегда и везде используем composer install.</li><li>Коммитим composer.lock в репозиторий.</li><li>Используем composer update только для намеренных обновлений.</li><li>При конфликте в composer.lock во время merge/rebase принимаем любую версию файла. Затем выполняем composer update, чтобы гарантированно получить composer.lock, соответствующий composer.json.</li></ol><h3>Источники вдохновения</h3><ul><li><a href="https://getcomposer.org/doc/">https://getcomposer.org/doc/</a></li><li><a href="https://www.engineyard.com/blog/composer-its-all-about-the-lock-file">https://www.engineyard.com/blog/composer-its-all-about-the-lock-file</a></li><li><a href="https://adamcod.es/2013/03/07/composer-install-vs-composer-update.html">https://adamcod.es/2013/03/07/composer-install-vs-composer-update.html</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6f9fb3dc511a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/phpyh/dont-ignore-composer-lock-6f9fb3dc511a">Не игнорьте composer.lock</a> was originally published in <a href="https://medium.com/phpyh">Пых / PHPYH</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>