Сайт и хостинг Хостинг, почта и PHP
Как вывести код на странице сайта, чтобы он не выполнялся
Чтобы показать код читателю, его нужно экранировать и обернуть в pre и code: браузер выведет символы как текст. Выполнять PHP из содержимого страницы через eval нельзя, это прямой путь к взлому.
Автору технического сайта часто нужно показать фрагмент кода: PHP-функцию, HTML-форму, конфиг. Если вставить его в страницу «как есть», браузер увидит теги и попытается их отобразить, а PHP вообще пропадёт в процессе обработки. Задача — вывести код как текст, не позволив ему выполниться.
Почему код «исчезает» или выполняется
Браузер разбирает HTML. Поэтому строка <b>пример</b> будет показана жирным, а <script> выполнится. PHP-теги <?php ... ?> обрабатывает сервер, до браузера они не доходят, если страница выводится из PHP-файла. Решение одно: заменить служебные символы HTML на сущности.
| Символ | Сущность |
|---|---|
< |
< |
> |
> |
& |
& |
" |
" |
Экранирование в 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.
Краткая памятка
- Показываете пример: экранируйте, оборачивайте в
preиcode, указывайте язык. - Выводите пользовательский текст: всегда
htmlspecialcharsилиesc_html. - Подсветку подключайте библиотекой, не самописным выполнением кода.
- Никогда не передавайте содержимое записи или комментария в
eval.
Частые вопросы
Как вывести HTML-код на странице, чтобы он не выполнялся?
Заменить символы <, > и & на сущности <, > и & и обернуть текст в теги pre и code. Браузер покажет разметку как обычный текст.
Для чего нужна функция htmlspecialchars в PHP?
Она превращает специальные символы HTML в сущности, поэтому введённый или хранимый текст отображается как текст и не интерпретируется как разметка. Это же защищает от XSS.
Как вставить код в WordPress без плагинов?
В редакторе блоков добавьте блок «Код» или «Форматированный текст» (Preformatted). Блок «Код» сам экранирует символы, а подсветку можно подключить библиотекой вроде Prism.js.
Можно ли выполнять PHP-код из текста статьи через шорткод?
Технически возможно через eval, но это крайне опасно: любой, кто получит доступ к редактору или найдёт уязвимость, выполнит произвольный код на сервере. Для показа примеров выполнять код не нужно.