iT-Ti.ruочерки сисадмина

Сайт и хостинг Хостинг, почта и PHP

Как вывести код на странице сайта, чтобы он не выполнялся

Опубликовано: Обновлено: 3 мин чтенияАвтор: Редакция iT-Ti.ru

Чтобы показать код читателю, его нужно экранировать и обернуть в pre и code: браузер выведет символы как текст. Выполнять PHP из содержимого страницы через eval нельзя, это прямой путь к взлому.

Автору технического сайта часто нужно показать фрагмент кода: PHP-функцию, HTML-форму, конфиг. Если вставить его в страницу «как есть», браузер увидит теги и попытается их отобразить, а PHP вообще пропадёт в процессе обработки. Задача — вывести код как текст, не позволив ему выполниться.

Почему код «исчезает» или выполняется

Браузер разбирает HTML. Поэтому строка <b>пример</b> будет показана жирным, а <script> выполнится. PHP-теги <?php ... ?> обрабатывает сервер, до браузера они не доходят, если страница выводится из PHP-файла. Решение одно: заменить служебные символы HTML на сущности.

Символ Сущность
< &lt;
> &gt;
& &amp;
" &quot;

Экранирование в PHP

Если вы выводите на странице данные из файла, базы или формы, используйте htmlspecialchars:

<?php
$code = file_get_contents( __DIR__ . '/example.php' );
?>
<pre><code class="language-php"><?= htmlspecialchars( $code, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' ) ?></code></pre>

Флаги важны: ENT_QUOTES экранирует оба вида кавычек, ENT_SUBSTITUTE заменяет некорректные байты UTF-8 вместо пустой строки. В WordPress для той же задачи есть esc_html(). Начиная с PHP 8.1 значение по умолчанию изменилось, но явная запись флагов остаётся хорошей практикой.

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

Теги pre и code

Пара <pre><code> — стандартный способ показать код: pre сохраняет пробелы и переносы строк, code сообщает, что внутри программный текст. Язык принято указывать классом language-php, language-html, language-bash, его читают библиотеки подсветки. Стиль добавляется CSS:

pre { overflow-x: auto; padding: 1rem; background: #f6f8fa; border-radius: 6px; }
code { font-family: ui-monospace, "Cascadia Mono", Consolas, monospace; }

Свойство overflow-x: auto не даёт длинной строке растягивать страницу на телефоне.

Блок «Код» в WordPress

В редакторе блоков WordPress добавьте блок «Код» (Code): текст внутри него экранируется автоматически, так что <?php и теги отобразятся как текст. Блок «Форматированный текст» (Preformatted) работает похоже, но подходит для стихов и ASCII-схем, а не для кода. Не вставляйте код в «Абзац»: в нём пробелы схлопнутся, а часть разметки редактор может превратить в настоящие элементы. В классическом редакторе пользуйтесь HTML-вкладкой и вручную экранированным текстом.

Подсветка синтаксиса

Читать код проще, когда он подсвечен. Лёгкие современные решения:

  • Prism.js — небольшая библиотека, подключается файлом CSS и JS; подсветка включается по классу language-*.
  • highlight.js — определяет язык автоматически, но лучше указывать его явно.
  • Плагины для WordPress на основе этих библиотек, если не хочется править тему.

Пример подключения Prism к странице через CDN:

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-php.min.js"></script>

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

Код в Markdown

В Markdown код оформляют тройными обратными кавычками с указанием языка. Внутри блока ничего интерпретироваться не будет:

```php
<?php echo "Привет"; ?>
```

Если сам пример содержит тройные кавычки, внешний блок оформляют четырьмя. Строчные фрагменты берут в одинарные обратные кавычки: `echo`. Генераторы сайтов преобразуют такие блоки в <pre><code class="language-php"> и экранируют содержимое сами.

Опасный путь: выполнять код через eval

Раньше для вывода результата работы PHP внутри записи писали фильтр на the_content, который находил шорткод вида [run]...[/run] и передавал его содержимое в eval(). Так делать не нужно. Любая уязвимость или чужой доступ к редактору превращает такой шорткод в возможность запустить на сервере что угодно: прочитать wp-config.php, создать администратора, залить вредоносный файл. Если нужен рабочий динамический элемент, оформите его как нормальный шорткод или блок в плагине, а для показа примеров достаточно экранированного текста. Подробнее о безопасной работе с файлом темы читайте в статье про functions.php.

Краткая памятка

  1. Показываете пример: экранируйте, оборачивайте в pre и code, указывайте язык.
  2. Выводите пользовательский текст: всегда htmlspecialchars или esc_html.
  3. Подсветку подключайте библиотекой, не самописным выполнением кода.
  4. Никогда не передавайте содержимое записи или комментария в eval.

Частые вопросы

Как вывести HTML-код на странице, чтобы он не выполнялся?

Заменить символы <, > и & на сущности &lt;, &gt; и &amp; и обернуть текст в теги pre и code. Браузер покажет разметку как обычный текст.

Для чего нужна функция htmlspecialchars в PHP?

Она превращает специальные символы HTML в сущности, поэтому введённый или хранимый текст отображается как текст и не интерпретируется как разметка. Это же защищает от XSS.

Как вставить код в WordPress без плагинов?

В редакторе блоков добавьте блок «Код» или «Форматированный текст» (Preformatted). Блок «Код» сам экранирует символы, а подсветку можно подключить библиотекой вроде Prism.js.

Можно ли выполнять PHP-код из текста статьи через шорткод?

Технически возможно через eval, но это крайне опасно: любой, кто получит доступ к редактору или найдёт уязвимость, выполнит произвольный код на сервере. Для показа примеров выполнять код не нужно.