Page Composer | BitrixFramework

[ilimurzin]

Page link: https://docs.1c-bitrix.ru/pages/get-started/composer.html

Если вы разрабатываете собственные модули — размещайте composer.json в папке /local/.

Не понятно что означает эта строка. composer.json должен лежать по пути /local/composer.json? Как будто не сочетается с рекомендацией размещать composer.json за пределами DOCUMENT_ROOT

[cyber-jet]

размещать composer.json за пределами DOCUMENT_ROOT

Предполагается что local папка для разработки и в проде её не должно быть.

[Voral]

Предполагается что local папка для разработки и в проде её не должно быть.

Хм. Разве? В этом каталоге все что касается данного конкретного проекта и, при этом, не установлено с маркет плейса. Например те же модули, шаблоны именно там хранятся. Т.е. пока живем в корне сайта, но можно ограничивать туда доступ. Это удобно т.к. удобно включить в git репозиторий. А не устраваить в gitignore чехарду с исключениями, как это было до появления каталога local в битркис.

[cyber-jet]

Хм. Разве?

Я понимаю, это удобно, и сам этим страдаю, но предполагается что с маркета модуль качается в папку bitrix/modules и от туда ставится. Папки local в нормальном проде проекта вы не увидите в принципе. local каталог для того чтобы перекрыть то что есть в bitrix и легко организовать разработку проекта, так-же в local будут лежать конфиги для вашей среды разработки, и если их не копировать на прод то ни чего "страшного" не произойдёт.

[Voral]

Хм. Разве?

Я понимаю, это удобно, и сам этим страдаю, но предполагается что с маркета модуль качается в папку bitrix/modules и от туда ставится. Папки local в нормальном проде проекта вы не увидите в принципе. local каталог для того чтобы перекрыть то что есть в bitrix и легко организовать разработку проекта, так-же в local будут лежать конфиги для вашей среды разработки, и если их не копировать на прод то ни чего "страшного" не произойдёт.

Все модули выкладывать на маркетплейс? Шаблоны, уникальные для конкретного проекта шаблоны компонентов. Также там инклуды удобно хранить и тесты. Т.е. вы вообще все на маркет плейс выкладываете? А как с модулями по которым есть причины не делать излишнего распространения. А сервер маркетплейса уже сторонняя организация.

[cyber-jet]

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

Т.е. вы предлагаете все это в рабочем проекте хранить, включая тесты? Не обязательно выкладывать на маркет, но ещё раз повторю, предполагается что на проде папки local быть не должно, это папка для разработки, по этому сабж с рекомендацией размещать composer.json за пределами DOCUMENT_ROOT не противоречит рекомендации размещать composer.json в папке /local/. Обычная практика не только в битрикс, когда в прод копируется только сборка. Скопируйте всё что нужно в папку битрикс рабочего проекта, это не так сложно инсталлер/composer всё это сделает без проблем, всё что бралось из local будет браться из bitrix в её отсутствии.

[Voral]

Держать исходники за пределами это правильно. И вроде мысли об этом озвучивались даже на конфе еще до пандемии, но пока имеем, что имеем. Если бы все исходники были вне этой папки. а сейчас какой от этого реальный прок? Вот я вижу удобство настройки репозитория git. Отдельно проект, отдельно ядро (при необходимости). До появления каталога local gitignore представлял из себя сложно читаемую вереницу игноров и исключений. А что даст отсутствие каталога local (с учетом того, что каталог bitrx в пределах корня сайта)?

Собственно в документации тоже подразумевается изначально что это нормальная директория для пользовтаельских разработок. А по логике ядра она находится в корне. Если ее вынести - часть функционала не будет работать как указано в доке

[Voral]

В общем полагаю все же цели появления каталога local в bitrix это изоляция стороннего кода и бизнес-логики проекта (могу уже наврать, но когда каталог появился в битрикс, вроде, он именно так и позиционировался, и появился он на "запрос от разработчиков"). По аналогии с композер проектами (именно проектами, а не библиотеками) на проде же мы не перекладываем все из src в vendor.

И все это укладывается и не противоречит статье документации про структуру проекта.

И, возвращаясь, к начальному сообщению этого ишью. На мой взгляд нет смысла перекладывать и composer.json пока у нас все ядро в пределах корня сайта. Другое дело надо правильно настраивать сервер и разрешать браузерам брать от туда только js, css и прочую подобную статику.

Мешать парадигмы в одном проекте тоже не самое парвильное.

[Voral]

Кстати, в подтверждении моих слов. на странице про роутинг

Размещайте свои маршруты только в директории /local/routes/. Маршруты /bitrix/routes/ зарезервированы для системы.

[irpsv]

Доброе утро!

Не понятно что означает эта строка. composer.json должен лежать по пути /local/composer.json? Как будто не сочетается с рекомендацией размещать composer.json за пределами DOCUMENT_ROOT

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

В случае если нет такой возможности, то располагать его стоит в районе папки /local/ , предварительно закрыв для доступа из-вне (по аналогии с папкой modules). Добавим детальные комментарии и рекомендации на эту тему. Спасибо!

Предполагается что local папка для разработки и в проде её не должно быть.

Это папка для разработки, с той точки зрения, что в ней нужно разрабатывать свои модули, компоненты и прочее. Она вполне может использовать на проде и является неотъемлемой частью продукта.