Исправляем ошибки шаблона сайта в соответствие с версией php 8

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

 

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

 

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

 

 

 

 

 

 

нужно ли править шаблон под новые версии 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() — достаточно частая ошибка в старых шаблонах.

 

 

 

 

 

 

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

 

 

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

 

 

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

 

 

 

 

 

 

 

 

Исправить 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.

 

 

 

 

 

 

 

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

 

 

 

 

 

 

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