Ошибка сохранения неправильный шаблон для сайта битрикс

1. Изменять все стандартное/Изменять содержимое папки bitrix

Изменение всего, что лежит в папке /bitrix/ — табу.

Если вам нужно изменить шаблон компонента — копируйте его в шаблон сайта.

Если вам нужно изменить компонент — используйте result_modifier.php, component_epilog.php (про них я подробно писал в этой статье), напишите свой компонент, в конце концов.

Если вам нужно изменить модуль — медицина бессильна пишите свой, наследуйтесь от стандартных.

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

Для пользовательских модулей/компонентов/шаблонов/обработчиков должна использоваться папка /local/.

Добавляйте папку /bitrix/ в .gitignore. Если в вашем git репозитории есть файлы /bitrix/, значит, скорее всего, что-то вы делаете не так. Вы можете подумать, что есть исключения. Да, но прибегать к созданию чего-либо в папке Bitrix нужно только если по-другому никак.

2. Получать данные в template.php

Никогда, слышите, никогда не делайте этого! Я говорю о CIBlockElement::GetList (и подобных им функциях) в template.php.

Если вам нужно получить какие-то дополнительные данные используйте result_modifier.php или component_epilog.php. Серьезно. Все что Вам нужно — лишь создать файл в папке шаблона. Это займет не на много больше времени, чем писать код в самом шаблоне.

Шаблон должен быть использован только для вывода информации. Ни для чего больше. Если вычисления (получение дополнительных данных, их модификация) находятся в шаблоне, вы становитесь сильно зависимы от порядка выполнения кода.

Допустим, необходимо посчитать общее количество просмотров всех статей на странице и вывести значение. Если вы разместите вычисления в цикле вывода статей, полученное значение можно будет использовать только после последней статьи. Простая задача по переносу блока наверх страницы превратится в ад.

3. Неверное подключение скриптов и стилей сайта

Откройте свой сайт, найдите основной шаблон и откройте файл header.php.

Если вы видите что-то похожее — гоните Вашего разработчика взашей.

В Битриксе вполне неплохой механизм автоматического объединения и минификации скриптов, кроме того, Битрикс умеет перемещать JS в конец страницы, благодаря чему сайт быстрее грузится. Если кто вдруг не знал, вся эта годнота включается в настройках Главного модуля:

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

Соберите скрипты из шаблона сайта, поместите их в JS файл, а потом подключите его с помощью
AddHeadScript().

Тоже самое касается и стилей. Если вам необходимо подключить стили, вынесите их в отдельный файл, а потом используйте
SetAdditionalCSS().

В итоге получится нечто похожее:

…или, если вы используете D7, так:

4. Неверное подключение скриптов и стилей компонента

Если с предыдущим пунктом все более-менее просто, исправить эту проблему гораздо сложнее. Давайте разбираться.

Допустим, для главной страницы сайта необходимо разработать слайдер с баннерами. Ок. Что может быть проще.

И Вы правильно подумали, что переносить стили (и скрипты) в основной шаблон сайта (/local/templates/[ваш сайт]/template_styles.css и /local/templats/[ваш сайт]/script.js) не стоит — иначе они будут подключаться на каждой странице.

Но многие разработчики просто помещают css и js в файл template.php шаблона компонента и на этом успокаиваются. Правильным же подходом будет создание файлов script.js и style.css в папке шаблона. Они подключатся автоматически и избавят от головной боли при разработке.

5. Отключение кеширования

Кеширование позволяет значительно снизить нагрузку на БД. Это более остро чувствуется при росте аудитории (и соответственно запросов к БД).

Обычная ситуация: верстальщику не нравится, что изменения стилей отображаются не сразу и он решает отключить кеширование отдельного компонента. Работа кипит, сроки горят и он (верстальщик) просто забывает включить кеширование обратно. Проходит время и страницы сайта начинают грузиться все дольше и дольше.

Мой совет: перед сдачей проекта прогнать сайт через монитор производительности. Он покажет ошибки в разработке и вам не придется искать проблемные компоненты вручную.

6. Вложенные циклы при получении элементов инфоблока

Очень часто при разработке нового компонента возникает необходимость получать данные из двух (или больше) связанных Инфоблоков.

Давайте рассмотрим пример: нужно получить список всех деталей, подходящих ко моделям автомобилей.

$dbModels = CIBlockElement::GetList(
    array(
        'SORT'  =>  'ASC',
        'NAME'    =>  'ASC',
    ),
    array(
        'IBLOCK_ID' =>  MODELS_IBLOCK,
        'ACTIVE'    =>  'Y',
    ),
    false,
    false,
    array(
        'ID',
        'NAME',
    )
);
while ($arModels = $dbModels->GetNext()) {

    $dbItem = CBIBlockElement::GetList(
        array(
            'SORT'  =>  'ASC',
            'NAME'  =>  'ASC',
        ),
        array(
            'IBLOCK_ID'             =>  ITEMS_IBLOCK,
            'ACTIVE'                =>  'Y',
            'PROPERTY_MODELS_VALUE' => $arModels['ID'],
        ),
        false,
        false,
        array(
            'NAME',
            'PROPERTY_COUNT',
            'PROPERTY_PRICE',
        )
    );
    while ($arItem = $dbItem->GetNext()) {
        //  TODO: какая-то работа
    }

}

Код упрощен для простоты восприятия, матерые разработчики найдут в нем сразу несколько ошибок;)

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

$dbModels = CIBlockElement::GetList(
    array(
        'SORT'  =>  'ASC',
        'NAME'    =>  'ASC',
    ),
    array(
        'IBLOCK_ID' =>  MODELS_IBLOCK,
        'ACTIVE'    =>  'Y',
    ),
    false,
    false,
    array(
        'ID',
        'NAME',
    )
);
while ($arModels = $dbModels->GetNext()) {

    $modelIDs[] = $arModels['ID'];

}

$dbItem = CBIBlockElement::GetList(
    array(
        'SORT'  =>  'ASC',
        'NAME'  =>  'ASC',
    ),
    array(
        'IBLOCK_ID'             =>  ITEMS_IBLOCK,
        'ACTIVE'                =>  'Y',
        'PROPERTY_MODELS_VALUE' =>  $modelIDs,
    ),
    false,
    false,
    array(
        'NAME',
        'PROPERTY_COUNT',
        'PROPERTY_PRICE',
    )
);
while ($arItem = $dbItem->GetNext()) {
    //  TODO: какая-то работа
}

В этом случае, вне зависимости от количества элементов инфоблока, будет всего 2 SQL запроса: получение моделей и получение деталей. А уже дальше в цикле должна быть проведена работа по распределению деталей на соответственные модели автомобилей.

Вообще, подобных ошибок очень много:

• Использование сортировки там, где она не нужна;
• Получение всех полей и свойств, даже если они не используются;
• Программная реализация постраничной навигации (вместо механизма Битрикс);
• Получение данных без учета активности элемента, раздела или дат активности и тд.

Перечислять все ушло бы очень много времени.

7. Бездумная разработка компонентов Bitrix

Не самым лучшим решением будет разрабатывать сайт целиком на самописных компонентах. Мотивация может быть разная: «Стандартный компонент делает слишком мало», «Стандартный компонент делает слишком много», «Шаблон слишком массивный, а в данных не разобраться», «Работает не так как я хочу», «Работает так как я хочу, но не очень».

Почему не стоит делать это? По целому ряду причин:

• От ошибок никто не застрахован. Но в случае стандартных компонентов можно расcчитывать, что их рано или поздно исправят, а ваша (если вы разработчик) ответственность закончится после сдачи проекта.
• Компоненты Битрикс в некоторых случаях сложны и запутаны. Сделано это ради гибкости. Уверен, если делать упор на универсальность, в конечном итоге компонент получится похожим на стандартный (а то и будет еще запутаннее:)).
• Если в будущем изменится структура данных, логика работы, а бОльшая часть сайта была написана сторонними разработчиками, поддержка проекта превратится в настоящий ад с постоянным переписыванием десятка компонентов.

В общем, прежде чем приступить к созданию очередного компонента, задайте себе вопрос: «А не возникнет ли проблем у Заказчика через год или два?».

Вместо заключения

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

<? $MESS[«AUTH_TITLE«] = «Авторизация«; $MESS[«AUTH_TITLE_SEND_PASSWORD«] = «Запрос пароля«; $MESS[«AUTH_TITLE_CHANGE_PASSWORD«] = «Изменение пароля«; $MESS[«AUTH_TITLE_REGISTER«] = «Регистрация«; $MESS[«AUTH_TITLE_CONFIRM«] = «Подтверждение регистрации«; $MESS[«BAD_SITE_NAME«] = «Введите Название сайта.«; $MESS[«BAD_SITE_LID«] = «ID сайта должен быть 2 символа.«; $MESS[«BAD_LANG_DIR«] = «Введите папку для сайта.«; $MESS[«BAD_SITE_DUP«] = «Дублирование ID сайта.«; $MESS[«BAD_LANG_NAME«] = «Введите Название языка.«; $MESS[«BAD_LANG_LID«] = «ID языка должен быть 2 символа.«; $MESS[«BAD_LANG_DUP«] = «Дублирование ID языка.«; $MESS[«BAD_CHARSET«] = «Введите Кодировку.«; $MESS[«BAD_FORMAT_DATETIME«] = «Введите Формат даты и времени.«; $MESS[«BAD_FORMAT_DATE«] = «Введите Формат даты.«; $MESS[«BAD_FORMAT_NAME«] = «Введите Формат имени.«; $MESS[«BAD_SORT«] = «Введите Сортировку.«; $MESS[«BAD_LANG_CHARSET«] = «Введите Кодировку.«; $MESS[«BAD_LANG_FORMAT_DATETIME«] = «Введите Формат даты и времени.«; $MESS[«BAD_LANG_FORMAT_DATE«] = «Введите Формат даты.«; $MESS[«BAD_LANG_FORMAT_NAME«] = «Введите Формат имени.«; $MESS[«BAD_LANG_SORT«] = «Введите Сортировку.«; $MESS[«OPTION_DENIED«] = «закрыт«; $MESS[«OPTION_READ«] = «просмотр всех данных модуля«; $MESS[«OPTION_WRITE«] = «запись«; $MESS[«OPTION_PROFILE«] = «изменение своего профиля«; $MESS[«OPTION_OPEN«] = «открыт«; $MESS[«FILTER_ERROR1«] = «Непарная скобка«; $MESS[«FILTER_ERROR2«] = «Ошибка возле«; $MESS[«FILTER_ERROR3«] = «Пустой поисковый запрос (запрос не содержит букв или цифр).«; $MESS[«OPTION_READ_PROFILE_WRITE«] = «просмотр всех данных модуля и изменение своего профиля«; $MESS[«MAIN_BAD_LANGUAGE_ID«] = «Не установлена связь с языком продукта«; $MESS[«MAIN_BAD_LANGUAGE_ID_BAD«] = «Ошибка в значении поля связь с языком продукта«; $MESS[«MAIN__INC_BLOCK«] = «область«; $MESS[«MAIN_INC_BLOCK_EDIT«] = «Редактировать #BLOCK_TYPE# в общей папке как #MODE#«; $MESS[«MAIN_INC_BLOCK_MODULE_EDIT«] = «Редактировать #BLOCK_TYPE# как #MODE#«; $MESS[«MAIN_INC_BLOCK_COMMON«] = «Это общий шаблон. При изменении этого шаблона изменится показ во всех местах где используется данный шаблон. Вы уверены что хотите изменить общий шаблон?«; $MESS[«MAIN_INC_BLOCK_MODULE«] = «Этот шаблон принадлежит модулю и сопровождается разработчиком модуля. При изменении он будет скопирован в пользовательские шаблоны и при обновлении системы не будет изменяться. Продолжить изменение шаблона?«; $MESS[«MAIN_INC_BLOCK_COMMON_COPY«] = «Редактировать #BLOCK_TYPE# с копированием из общей папки как #MODE#«; $MESS[«MAIN_INC_ED«] = «Редактировать #BLOCK_TYPE# как #MODE#«; $MESS[«MAIN_INC_ED_WF«] = «Редактировать #BLOCK_TYPE# через документооборот.«; $MESS[«MAIN_INC_ED_NAV«] = «Редактировать шаблон цепочки«; $MESS[«MAIN_BAD_TEMPLATE_NA«] = «Не указан шаблон для сайта.«; $MESS[«MAIN_BAD_TEMPLATE_DUP«] = «Дублирование привязки к шаблону при одинаковых условиях.«; $MESS[«MAIN_BAD_TEMPLATE«] = «Неправильный шаблон для сайта.«; $MESS[«MAIN_ENTER_TEMPLATE_ID«] = «Введите ID шаблона.«; $MESS[«MAIN_TEMPLATE_ID_EX«] = «Шаблон с таким ID уже существует.«; $MESS[«MAIN_TEMPLATE_CONTENT_NA«] = «Введите содержимое шаблона.«; $MESS[«MAIN_TEMPLATE_WORKAREA_NA«] = «Установите в шаблоне разделитель #WORK_AREA#.«; $MESS[«MAIN_TEMPLATE_NAV«] = «Шаблон навигационной цепочки.«; $MESS[«MAIN_TEMPLATE_MENU«] = «Шаблон меню типа #MENU_TYPE#.«; $MESS[«MAIN_TEMPLATE_AUTH_REG«] = «Формы авторизации и регистрации на одной странице.«; $MESS[«MAIN_TEMPLATE_SEND_PWD«] = «Форма высылки пароля.«; $MESS[«MAIN_TEMPLATE_CHN_PWD«] = «Форма изменения пароля.«; $MESS[«MAIN_TEMPLATE_SIP_REG«] = «Форма упрощенной регистрации.«; $MESS[«MAIN_TEMPLATE_AUTH«] = «Форма авторизации.«; $MESS[«MAIN_TEMPLATE_REG«] = «Форма регистрации.«; $MESS[«MAIN_BEFORE_DEL_ERR«] = «Ошибка при удалении в«; $MESS[«MAIN_BFS_NO_EVENT«] = «Не указано событие, вызывающее диалог выбора файла«; $MESS[«MAIN_BFS_NO_RETURN_PRM«] = «Не указаны параметры для возвращения выбранного файла«; $MESS[«MAIN_BFS_NO_RETURN_FNC«] = «Функция для возвращения выбранного файла указана не верно«; $MESS[«MAIN_BFS_NO_RETURN_FRM«] = «Имя формы или элемента формы для возвращения выбранного файла указано не верно«; $MESS[«MAIN_BFS_NO_RETURN_ID«] = «Идентификатор элемента для возвращения выбранного файла указан не верно«; $MESS[«MAIN_BFS_BAD_RETURN«] = «Параметры для возвращения выбранного файла указаны не верно«; $MESS[«MAIN_BFS_NO_PERMS«] = «У вас недостаточно прав для использования диалога выбора файла«; $MESS[«main_incl_file_comp_buttom«] = «Редактировать параметры компонента«; $MESS[«main_incl_file_comp_param«] = «Редактировать параметры компонента«; $MESS[«main_incl_file_edit_copy«] = «Редактировать область с копированием из папки модуля как #MODE#«; $MESS[«main_incl_file_sec«] = «с«; $MESS[«main_incl_file_sql_stat«] = «Посмотреть статистику запросов«; $MESS[«main_incl_file_sql«] = «Запросов:«; $MESS[«main_incl_cache_stat«] = «кеш:«; $MESS[«OPTION_READ_OTHER_PROFILES_WRITE«] = «просмотр всех данных модуля и изменение заданных профилей пользователей«; $MESS[«MAIN_FILE_NOT_CREATE«] = «Ошибка при создании файла.«; $MESS[«MAIN_FILE_NOT_OPENED«] = «Ошибка при открытии файла.«; $MESS[«MAIN_FILE_NOT_WRITE«] = «Ошибка при записи в файл.«; $MESS[«main_incl_area_doubleclick«] = «Двойной щелчок«; $MESS[«main_incl_component1«] = «Компонент 1.0«; $MESS[«main_incl_file«] = «Включаемый файл«; $MESS[«main_save_file_handler_error«] = «Ошибка сохранения файла (обработчик #HANDLER#).«; $MESS[«ErrorOnBeforeIBlockAddErrorLLM«] = «В вашу редакцию входит только два информационных блока.«; $MESS[«ErrorOnBeforeIBlockPropertyAddLLM«] = «В вашу редакцию входит только два свойства информационного блока.«; $MESS[«ErrorOnBeforeUserAddLLM«] = «В вашу редакцию входит только два пользователя.«; $MESS[«ErrorOnBeforeSiteAddLLM«] = «В вашу редакцию входит только один сайт.«; $MESS[«error_first_edition_hack«] = «Ошибка соответствия редакции.«; $MESS[«error_intranet_edition_hack«] = «Ошибка соответствия редакции.«; $MESS[«MAIN_FEATURE_ERROR_EDITABLE«] = «Модуль не доступен в вашей редакции.«; $MESS[«MAIN_SESS_MESS«] = «Ваш сеанс работы с сайтом завершен из-за отсутствия активности в течение #TIMEOUT# мин. Введенные на странице данные не будут сохранены. Скопируйте их перед тем, как закроете или обновите страницу.«; $MESS[«MAIN_NAME_JOHN_SMITH«] = «Иван Петров«; $MESS[«MAIN_NAME_SMITH_JOHN«] = «Петров Иван«; $MESS[«MAIN_NAME_JOHN_L_SMITH«] = «Иван В. Петров«; $MESS[«MAIN_NAME_SMITH_JOHN_LLOYD«] = «Петров Иван Васильевич«; $MESS[«MAIN_NAME_SMITH_COMMA_JOHN_LLOYD«] = «Петров, Иван Васильевич«; $MESS[«MAIN_NAME_JOHN_LLOYD_SMITH«] = «Иван Васильевич Петров«; $MESS[«MAIN_NAME_J_L_SMITH«] = «И. В. Петров«; $MESS[«MAIN_NAME_J_SMITH«] = «И. Петров«; $MESS[«MAIN_NAME_SMITH_J«] = «Петров И.«; $MESS[«MAIN_NAME_SMITH_J_L«] = «Петров И. В.«; $MESS[«MAIN_NAME_SMITH_COMMA_J«] = «Петров, И.«; $MESS[«MAIN_NAME_SMITH_COMMA_J_L«] = «Петров, И. В.«; $MESS[«MAIN_NAME_JOHN«] = «Иван«; $MESS[«MAIN_NAME_LLOYD«] = «Васильевич«; $MESS[«MAIN_NAME_SMITH«] = «Петров«; $MESS[«MAIN_NAME_DEFINED_IN_DBCONN«] = «(задан в dbconn.php)«; $MESS[«MAIN_FORMAT_NAME_NOT_SET«] = «[не определен]«; $MESS[«lang_check_culture_not_set«] = «Не указаны региональные настройки.«; $MESS[«lang_check_culture_incorrect«] = «Указаны неверные региональные настройки.«; $MESS[«AUTH_TITLE_OTP«] = «Одноразовый пароль«; $MESS[«MAIN_NAME_MR_SMITH«] = «г-н Петров«; $MESS[«MAIN_SITE_LATIN«] = «ID сайта должен содержать только латинские символы и цифры.«; ?>

Как известно, не так давно вышла новая версия php 8 — замечательно! Исправлены недочёты предыдущих версий, внесены некоторые корректировки в язык программирования и т.п. словом, по заявлениям разработчиков — php стал много быстрее и безопаснее! Хорошо.

Но мы понимаем, что в php 8 ошибок больше и он медленнее, чем, скажем, грядущий php 9. Но это не суть… а суть в том, что наши сайты бесспорно нуждаются в модернизации! Например, многие, если изменяют на хостинге версию до обновленной, то сайты просто-напросто ложатся: белый экран. И, если у нас шаблон сайта не обновляется (и мы не используем дочернюю тему), то никто за нас исправления в код шаблонов не внесёт. Сайт не будет нормально работать!

Я за последнее время многим правил шаблоны под новый php. Пришло время написать небольшую статью по теме, как исправить ошибки шаблона сайта для php 8. Сделаю, на основе ваших пожеланий, видеоролик, в котором мы прямо на рабочем сайте от начала (когда сайт «ложится» и до конца (когда вновь заработает») поправим шаблон, так что пишите пожелания о темах, которые нужно включить в ролик (если тема версий php в связке с WordPress будет интересна, буду её расширять, дополнять. Так что жду откликов…).

нужно ли править шаблон под новые версии php?

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

Однако по статье приведу несколько примеров, а вы уж делайте выводы.

К примеру, вы решили оставить для своего сайта устаревшую версию. идет время… плагины и вообще все окружающие веб мощности естественным образом обновляются… Вывод, через какое-то время ваш сайт откажется работать с обновленными плагинами и т.п. Вам придется сайт заморозить! т.е. использовать старый функционал. Хорошо это или плохо!? ответить трудно.

Если немного смыслите в сайтостроении — это одно дело, а если — нет, это совсем иное…

Думаю, как ни крути, но самое логичное — постепенно — приводить код шаблона в порядок.

В текущем посте дам несколько вариантов исправления ошибок по текущим версиям php. У вас, конечно, могут возникнуть какие-то иные ошибки… Пишите о них, поправим…

к оглавлению

написание кода, комментирование кода php — правила

…предположим, ваши сайты работали на php 7.4.

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

Рекомендую создать копию сайта и выполнять правки на тестовом варианте сайта (как создать тестовый сайт за несколько минут).

Возможно, послужит пользой прочесть об истории обновлений версий Вордпресс.

к оглавлению

подготовка шаблона к включению на сервере версии php 8

О том, что плагины должны быть обновлены, разговор выведем за скобки — это и так ясно!

Первое, с чего начнем концерт, это обратим внимание на написание кода в шаблоне: php 8 строже относится к помаркам в коде. К неряшливому коду…

Проверьте файлы шаблона. Отнеситесь внимательнее к комментариям в коде.

Например, если в финале файла размещен какой то комментарий, то он должен быть обязательно соответственно закрыт. Иначе, как только переключитесь на 8-ку — сайт обрушится.

то есть должно быть /* коммент */.

Подробнее читать как закомментировать код HTML, CSS, PHP, JS (есть подробное видео).

к оглавлению

установим на сайте плагин Query Monitor

Устанавливаем и активируем плагин…

…и, конечно же, непосредственно перед правкой добавляем в константу  define('WP_DEBUG', true);  параметр true.

это в конфигурации сайта — в файле по пути /домен/public_html/wp-config.php — файл wp-config.php

Этап подготовки сайта для смены версии php считаем законченным.

к оглавлению

переходим к основному решению задач перехода сайта на новую версию php 8

Непременно включаем всё наше внимание!!

…и переходим в соответственный раздел настроек хостинга и переключаем сервер на php 8.

…как правило после смены версии сервера, сайт падает!!

Однако, мы подготовились…

Открываем, например, главную страницу сайта (фронтэнд) — ну или админку.

То, что мы используем в конфигурации сайта дебаггер… и плагин Query Monitor нас здорово выручит! В этом случае перед нашими глазами будет не молчаливый белый экран, но подсказки ошибок!!!

…на белом листе сайта появятся подсказки о возможных ошибках (у кого-то может быть сайт и не совсем сломается… то есть будут частично видны элементы сайта, но в любом случае дебаггеры укажут подсказки о возможных ошибках, с решения которых — методично — и приступаем к исправлению):

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

Скрин выше, как раз указывает на то, как я и говорил выше, что комментарий в финале кода шаблона не закрыт!!! Поправляем, если у вас что-то подобное…

Подробнее станем разбираться в видеорлике.

к оглавлению

ошибки или несоответствия кода шаблона для версии php 8

примеры ниже — только принципиальные примеры, возможные решения!

по мере испрвления ошибок шаблона — плагин Query Monitor подскажет о том, что в коде шаблона используется устаревшая функция, которая теперь вызывает фатальную ошибку в версии php 8:

Функция create_function() — достаточно частая ошибка в старых шаблонах.

Дело в том, что функция create_function() считается устаревшей и в более новых версиях php будет вызывать ошибки. Так в версии php 8 она вызовет фатальную ошибку.

Исправляем примерно такими вариантами:

Например, есть известный код (фильтр) относительно безопасности сайта — многие его используют:

// уборка ошибки неправильный логин/пароль для ранних версий php 8
add_filter( 'login_errors', create_function( '$a', "return null;" ));

данный фильтр в php 8 теперь вызывает фатальную ошибку!

Исправить create_function можно следующим образом: (заменяем create_function на анонимную функцию — подробности о функциях в этой статье опускаю).

Так:

// первый вариант для версий php 8 = будет пустое поле ошибки:
//add_filter( 'login_errors', fn()=> null );

либо так:

//2 вариант для версий php 8
function no_logs_s() { return 'Вы совершили ошибку при наборе данных'; }
add_filter( 'login_errors', 'no_logs_s' );
/*уборка ошибки неправильный логин/пароль*/

либо ещё один пример:

// неправильно - устаревший пример
if($this->options['general']['clean_exerpts']) {
add_filter('excerpt_more', create_function('', 'return "";') );
}

правильно:

// ИСПРАВЛЕНО:
if($this->options['general']['clean_exerpts']) {
add_filter('excerpt_more', fn()=> null ); }

create_function('', 'return "";') — заменим на: fn()=> null

к оглавлению

для владельцев магазинов на WooCommerce — ошибки сайта-магазина по версии php 8

Если вы работаете с плагином WooCommerce, то вам будет полезно примерно такой вариант решения (много решений — функции Wooc для владельцев магазина):

неправильно:

//число товаров на странице витрины МАГАЗИНА
add_filter('loop_shop_per_page', create_function('$cols', 'return 9;'));

правильно (как вариант):

// исправлено
add_filter('loop_shop_per_page', function( $cols ) { return 9; }, 20);

Этот пример: create_function('$cols', 'return 9;') заменим на: function( $cols ) { return 9;

То есть заместо устаревшей create_function() используем ананимную (альтернативную) функцию function().

И так далее… в подобном духе исправляем и остальные несоответствия в коде шаблона с обновленной версией php 8.

Обращайте внимание на добавленный в functions.php активного шаблона код из уруков на веб сайтах — код может иметь ошибки, которые в ранних версиях php более-менее отрабатывали.

…в кодах могут быть на первый взгляд незначительные ошибки, примеру неустановленные одинарные кавычки — всё это в новой версии php вызовет НЕ ТОЛЬКО неотработку отдельного кода, но и фатальную ошибку!

Напоминаю: в видео, которое сейчас готовлю, расскажу по исправлениям ошибок поэтапно. Опишите свои вопросы…

Подробнее об изменениях ЯПа модно почитать в обзоре (на хабре).

Как правильно закомментировать код HTML, CSS или PHP, JS

…вопросы в комментариях — помогу, в чём дюжу…
mihalica.ru !

В заметке собраны некоторые проблемы с Bitrix Framework и VMBitrix, а так же приведены способы их решения.

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

Прежде чем затронуть функциональность сайта не забудьте сделать бэкап.

Как уменьшить размер БД

Если база данных 1С-Битрикс разрослась и это не связно с количеством информации или товаров на сайте, то возможно базу раздувают записи Журнала событий, статистика модуля Веб-аналитика или другие таблицы.

Разросшуюся базу данных можно подчистить. Однако если 1С-Битрикс продолжает необоснованно расти, возможно проблема глубже и выходит за рамки данной статьи.

Как очистить статистику Веб-аналитики

В админке перейдите в Настройки > Настройки продукта > Настройки модулей > Веб-аналитика. В разделе Очистка статистики укажите до какой даты выполнить очистку (если оставить незаполненным, то будет очищена вся статистика) и нажмите кнопку Очистить.

Как удалить записи из Журнала событий

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

Более быстрый и радикальный вариант – очистить таблицу b_event_log через SQL-запрос. При этом будут удалены все события!

Если таблица не очень большая, выполните запрос через админку: Настройки > Инструменты > SQL запрос (или на странице you.site/bitrix/admin/sql.php).

DELETE FROM `b_event_log`;

Если таблица огромная (больше 4Гб), то скорее всего запрос не выполнится и отвалится по тайм-ауту. В таком случае выполнить запрос лучше из консоли MySQL на сервере, примерно так:

mysql -h you_sql_server -u root -p

USE you_db_name;

DELETE FROM `b_event_log`;

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

К слову, поврежденную таблицу можно восстановить командой.

REPAIR table b_event_log;

Как очистить разросшуюся таблицу b_cache_tag

Перейдите в Настройки продукта > Автокэширование > Очистка файлов кэша.

Затем аналогично действиям описанным в предыдущем разделе выполните:

TRUNCATE TABLE b_cache_tag

Где изменить mbstring.internal_encoding и mbstring.func_overload

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

Вариант 1 (для Apache и PHP ниже версии 7.3). Установить необходимые значения в файле .htaccess.

php_value mbstring.func_overload 2
php_value mbstring.internal_encoding UTF-8

Вариант 2 (так же для PHP ниже версии 7.3). Добавить параметры в файле настройки виртуальных хостов. Для Apache это:

• /etc/apache2/sites-available/сайт.conf (если использется BitrixVM)
• /etc/apache2/httpd.conf
• /etc/apache2/apache2.conf

<VirtualHost *:80>
  ServerAdmin ...
  ServerName ...
  ServerAlias ...
  DocumentRoot "/путь/к/папке/сайта"

  php_admin_value mbstring.func_overload 2
  php_admin_value mbstring.internal_encoding UTF-8
</VirtualHost>

Вариант 3 (для всех версий PHP). Установить необходимые значения в php.ini, для BitrixVM /etc/php.d/z_bx_custom.ini. После внесения изменений нужно перезагрузить сервер.

Начиная с версии PHP 7.3  значение mbstring.func_overload нельзя установить индивидуально для конкретного сайта, ни через .htaccess, ни через конфигурационный файл Apache. Единственный вариант – установить значение mbstring.func_overload непосредственно в файле php.ini. Однако php.ini общий и если на сервере несколько сайтов, то они могут перестать работать, например если часть сайтов работает в кодировке UTF-8, а часть на cp1251.

Смена кодировки Битрикс на UTF8

Для PHP установите следующие параметры.

mbstring.func_overload 2
mbstring.internal_encoding UTF-8

Удалите модули Поиск без сохранения таблиц и Веб-аналитика (без сохранения таблиц, но с сохранением шаблонов сообщений).

Из словаря транслита в модуле Форум (Сервисы > Форумы > Фильтр нецензурных слов > Словарь транслита) удалить букву ё (ID = 7).

В настройках сайта изменить кодировку с windows-1251 на utf-8.

В файле /bitrix/php_interface/dbconn.php установить для константы BX_UTF значение true.

define("BX_UTF", true);

Скачать с сайта 1С-Битрикс скрипт convert_utf8.php, поместить его в корень сайта, затем запустить и дождаться полного выполнения.

Если база данных большая, конвертация может занять долгое время или вообще закончится неудачей. В таком случае попробуйте конвертировать базу данных вручную. Для этого в админке сайта на странице SQL-запрос выполните запрос:

SELECT CONCAT('ALTER   TABLE `', t.`TABLE_SCHEMA`, '`.`', t.`TABLE_NAME`, '` CONVERT TO CHARACTER SET utf8 COLLATE utf8_unicode_ci;') as

sqlcode

FROM `information_schema`.`TABLES` t

WHERE 1

AND t.`TABLE_SCHEMA` = 'database_name' ORDER BY 1

Где database_name – имя базы данных сайта.

В результате будет выведен новый запрос, который нужно скопировать и выполнить. По завершении таблицы базы данных будут переведены в кодировку UTF-8.

Далее пропишите в /bitrix/php_interface/after_connect.php:

$DB->Query("SET NAMES 'utf8'");
$DB->Query('SET collation_connection = "utf8_unicode_ci"');

В файл /bitrix/php_interface/after_connect_d7.php:

$connection->queryExecute("SET NAMES 'utf8'");
$connection->queryExecute('SET collation_connection = "utf8_unicode_ci"'); 

В /bitrix/.settings.php:

return array (
  'utf_mode' => 
  array (
    'value' => true,
    'readonly' => true,
  ),

Затем полностью очистите кэш сайта.

Удалите более ненужный скрипт convert_utf8.php.

Заново установите модуль Поиск и сделайте переиндексацию.

Установите модуль Веб-аналитика (если использовали ранее).

Если возникли проблемы с сериализованными массивами возможно сможет помочь скрипт.

Дополнительные сведения на dev.1c-bitrix.ru и тема на форуме.

Если выкидывает из админки Битрикс

После ввода логина и пароля снова открывается страница авторизации

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

Вторая причина – переполнения дискового пространства сервера. Очистите место на диске, удалите лишние бэкапы или докупите место (если это возможно) у своего хостинг-провайдера.

Периодически выкидывает из админки

Такое может происходить если в качестве DNS-сервера используется Cloudflare или аналог, например для использования SSL-сертификатов или защиты от DDoS. В этом случае, сессию обрывает механизм защиты Битрикс. Cloudflare подменяет ip-адрес пользователя и админка пресекает доступ. Для исправления внесите в dbconn.php следующие правки:

$_SERVER["REMOTE_ADDR"] = $_SERVER['HTTP_CF_CONNECTING_IP'];

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

Другой причиной вылетов, может быть наличие лишних символов или пробелов в файлах dbconn.php, after_connect.php, after_connect_d7.php, особенно в начале или в конце файла. Исправьте и проблема должна решиться.

Не отправляется почта

Если перестала отправляться почта на Яндекс

После многих лет пользования Яндекс.Почтой для отправки сообщений от интернет-магазина на Битрикс, почта перестала работать. В логах ошибка:

Sender or From header address rejected: not owned by authorized user

Одна из причин по которой это может произойти: адрес почты, под которой авторизируется сервер, отличается от почты (поле «From», «От кого») указанной на сайте.

Раньше такая схема вполне себе работала на Яндекс. В Битрикс можно было указать почту, например my@company.ru, при том, что сервер отправлял ее с ящика info@yandex.ru. Получатель письма все равно в отправителях видел почту my@company.ru.

Но начиная с 2020 года, Яндекс постепенно запрещает отправку писем если поле «From» отличается от адреса пользователя, с данными которого производится авторизация на сервере.

Решений несколько:

• указать на сайте почту, под которой происходит авторизация на сервере, что в случае использования почты на Яндекс возможно будет не очень солидным;
• поднять свой почтовый сервер и настроить отправку с него;
• арендовать недорогой хостинг, который позволяет отправлять письма даже если поле «From» отличается от адреса пользователя, с данными которого производится авторизация на сервере. Например REG.RU предоставляет такую возможность, подойдет даже самый простой тариф дешевле 100 руб. в мес.

Свою проблему решил, выбрав третий вариант. Рекомендую хостинги:

• REG.RU (промокод на скидку для заказа домена или хостинга: 2229-CC0A-AC4D-C31B)
• Hostland (месяц бесплатно)

Логирование почты

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

Добавьте в dbconn.php следующие строки.

// определим константу LOG_FILENAME, в которой зададим путь к лог-файлу
define("LOG_FILENAME", $_SERVER["DOCUMENT_ROOT"]."/mylog-123.txt");

//дебаг почты
function custom_mail($to, $subject, $message, $additional_headers='', $additional_parameters='')
{
   AddMessage2Log(
            'To: '.$to.PHP_EOL.
            'Subject: '.$subject.PHP_EOL.
            'Message: '.$message.PHP_EOL.
            'Headers: '.$additional_headers.PHP_EOL.
            'Params: '.$additional_parameters.PHP_EOL
         );
   if ($additional_parameters!='') {
      return @mail($to, $subject, $message, $additional_headers, $additional_parameters);
   } else {
       return @mail($to, $subject, $message, $additional_headers);
   }
}

Теперь, при отправке письма в лог будут писаться сообщения.

Проблемы с отправкой уведомления о заполнении веб-форм

Для начала проверьте, настройки почтового события заполнения формы и его шаблона. Откройте Панель управления > Настройки > Настройки продукта > Почтовые события > Типы событий и выберите интересующее событие.

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

На вкладке Шаблоны должен задан хотя бы один шаблон. Перейдите в шаблон кликнув на его идентификаторе или откройте его из списка шаблонов: Панель управления > Настройки > Настройки продукта > Почтовые события > Почтовые шаблоны.

В настройках выбранного почтового шаблона, должна стоять галочка Активен, и выбран хотя бы один сайт. Также должны быть корректно заполнены поля От кого и Кому (значения по-умолчанию #DEFAULT_EMAIL_FROM# и #EMAIL# соответственно).

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

Если не помогло, перейдите в Настройки > Инструменты > SQL-запрос и выполните следующий запрос:

select * from b_event where event_name like '%form%' order by date_insert desc

Найдите событие заполнения формы, поле SUCCESS_EXEC:

• Y – сообщение отправлено, дальнейший его путь сможет определить администратор хостинга или почтового сервера;
• N – сообщение не отправлено. Проверьте файл /bitrix/php_interface/dbconn.php на наличие констант BX_CRONTAB и BX_CRONTAB_SUPPORT, уберите их если они присутствуют, затем выполните SQL-запрос еще раз. Если и после этого SUCCESS_EXEC равен N, попробуйте очистить кэш /bitrix/managed_cache/.
• F – функция mail вернула False при отправке. Смотрите логи. Возможно почта на хостинге (сервере) не настроена или настроена некорректно, решается хостером или администратором сервера. Другая причина, почтовый сервер не поддерживает формат письма. Попробуйте изменить настройки отправки в Главном модуле: убрать/поставить галку Дублировать email адрес в заголовке, убрать/поставить галку Конвертировать 8-битные заголовки.
• 0 (ноль) – не корректные настройки типов событий или в почтовом шаблоне. Проверьте настройки как указано в начале.

Ошибка БД после переноса на другой хостинг

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

2016-05-25 15:33:22 - Host: host:80 - UNCAUGHT_EXCEPTION - [Error]
Call to undefined function BitrixMainDBmysql_connect() (0)
/home/bitrix/www/bitrix/modules/main/lib/db/mysqlconnection.php:45
#0: BitrixMainDBMysqlConnection->connectInternal()...

Может быть вызвана сменой СУБД с MySQL на MySQLi или наоборот.

Чтобы исправить нужно перенастроить подключение к БД, отдельно для старого и нового ядра.

В случае с MySQLi

В файле bitrixphp_interfacedbconn.php

define("BX_USE_MYSQLI", true);

В файле bitrix.settings.php поменять класс соединения с базой на MysqliConnection.

'connections' =>
    array (
        'value' =>
        array (
            'default' =>
                array (
                    'className' => '\Bitrix\Main\DB\MysqliConnection',
                    'host' => 'localhost',
                    'database' => 'database',
                    'login' => 'login',
                    'password' => '*****',
                ),
        ),
    ),

В случае с MySQL соответственно

В файле bitrixphp_interfacedbconn.php

define("BX_USE_MYSQLI", false)

В файле bitrix.settings.php поменять класс соединения с базой на MysqlConnection.

'connections' =>
    array (
        'value' =>
            array (
            'default' =>
                array (
                    'className' => '\Bitrix\Main\DB\MysqlConnection',
...

После изменения настроек, сайт должен заработать.

Ошибка: innodb_strict_mode=ON, требуется OFF

Ошибка может появиться при проверке системы. Для исправления воспользуйтесь одним из двух вариантов.

Вариант 1. Через конфигурационные файлы Битрикс.

В файл /bitrix/php_interface/after_connect.php добавьте сторку:

$DB→Query("SET innodb_strict_mode='OFF'");

В файл /bitrix/php_interface/after_connect_d7.php

$connection→queryExecute("SET innodb_strict_mode='OFF'");

Вариант 2. Через конфигурационные файлы MySQL.

Откройте конфигурационный файл MySQL (три возможных варианта расположения):

• /etc/my.cnf
• /etc/alternatives/my.cnf
• /etc/bitrix-my.cnf

Добавить строку в блоке # InnoDB parameters

innodb_strict_mode = OFF

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

Ошибка: Переменная sql_mode в MySQL должна быть пустая

Ошибка может появиться при проверке системы, когда параметр sql_mode задаёт режим работы MySQL, несовместимый с Битрикс.

Для исправления, добавьте указанные ниже строки в конфигурационные файлы.

В файл /bitrix/php_interface/after_connect_d7.php

$connection = BitrixMainApplication::getConnection();
$connection->queryExecute("SET sql_mode=''");

В файл /bitrix/php_interface/after_connect.php

$DB->Query("SET sql_mode=''");

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

Недоступны файлы для чтения и записи

Если при проверке доступа к файлам 1С-Битрикс (Настройки – Инструменты – Проверка сайта – Проверка доступа) появляется ошибка: Недоступны для чтения или записи (показаны первые 10), это значит на сервере неверно настроены права для сайта.

Причины могут быть разные, чаще это происходит если какие то файлы создавались, распаковывались или перемещались пользователем, к файлам которого 1С-Битрикс не имеет доступа.

Чтобы ошибка исчезла, нужно сделать владельцем файлов и папок пользователя bitrix, а права назначить как 775 для папок и 664 для файлов.

Следующая команда сделает владельцем файлов и папок пользователя bitrix в указанном каталоге (у вас он может быть другим). Как правило это /home/bitrix/www/ для основного сайта и/или /home/bitrix/ext_www/папка_сайта/ для дополнительных.

chown -R bitrix:bitrix /home/bitrix/www/

Ключ -R означает рекурсивно, т.е. включая вложенные папки и файлы.

А следующие команды выставят правильные права на доступ к файлам и папкам.

cd /home/bitrix/www
find . -type d -exec chmod 775 {} ;
find . -type f -exec chmod 664 {} ;
find . -type d -exec chown bitrix:bitrix {} ;
find . -type f -exec chown bitrix:bitrix {} ;

Затем выполните проверку повторно, ошибка должна исчезнуть.

На этом всё. Но вы можете поддержать проект. Даже небольшая сумма поможет нам писать больше полезных статей.

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