Исправляем ошибки шаблона сайта в соответствие с версией 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 вызовет НЕ ТОЛЬКО неотработку отдельного кода, но и фатальную ошибку!

 

 

 

 

 

 

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