«Постав перевірку в тему, щоб чужі сайти не тягнули наші картинки».
Таке прохання приносять кілька разів на рік. Я відмовляюся. Не тому, що код складний. Тому що він виконується надто пізно.
Захист від хотлінку на PHP це перевірка, яка не бачить запит, який має зупинити.
Де захист від хотлінку на PHP ламається
Браузер відкриває https://example.com/uploads/2026/05/photo.jpg. nginx знаходить файл. Віддає.
PHP не стартує. WordPress не завантажується. Моєї функції в цей момент не існує.
Це не про WordPress. У будь-якого застосунку, який віддає статику через веб-сервер, та сама діра.
Бувають хостинги, де картинки йдуть через PHP. Тоді перевірка спрацює. І стане дорожчою: щоб сказати «ні» одній картинці, сервер підніме рушій, плагіни й базу. Відмова за повне завантаження це не захист, а другий рахунок за той самий трафік.
Хто має відповідати
Правило ставлять туди, де запит дешевий.
- Cloudflare Hotlink Protection: один перемикач на периметрі, коду немає.
- nginx:
valid_referers none blocked server_names *.example.com;іif ($invalid_referer) { return 403; }. - Apache і LiteSpeed:
RewriteCond %{HTTP_REFERER}з прапорцем[F].
Три правила по десять хвилин кожне.
Усі три пропускають порожній реферер. Це правильний дефолт. Пошта, RSS, браузер із захистом приватності й прев’ю в соцмережах приходять без нього. Забороняти порожній означає зламати більше трафіку, ніж зекономити.
Чому плагіни все одно це роблять
Частина плагінів пише правила в .htaccess. Працює. До переїзду на nginx, де правило лишається у файлі, який ніхто не читає.
Інші перевіряють реферер у PHP. Це та сама пізня перевірка, лише зі сторінкою налаштувань в адмінці.
Треті ховають справжній шлях файлу за підписом. Інша задача й інша ціна. Кеш від цього ламається частіше, ніж хочеться.
Я не кажу, що це нерозумно. Я кажу, що задачу вирішують шаром нижче того, де вона дешева.
Що я все-таки пишу на PHP
Є робота, яку периметр не зробить. Зрозуміти, хто на іншому кінці.
Парсер із підробленим реферером. Краулер, який називає себе Googlebot без відповідного PTR. Інтеграція, яка зламалася після деплою і надсилає не той заголовок.
Реферер це один сигнал. Клієнт підробляє його одним рядком. Тому єдиною перевіркою він бути не може.
Для WordPress цей шар закриває BotBlocker. Файрвол стартує до завершення завантаження WordPress, читає заголовки й підписи User-Agent, пише рішення в лог, який можна відкрити.
Периметр ріже обсяг. Плагін відповідає, хто прийшов.
Як я пояснюю це на дзвінку
Три речення.
- Сервер віддає картинку раніше, ніж запускається ваш код, тому код не може їй відмовити.
- Правило належить шару, який відповідає на запит: CDN, nginx, Apache.
- Плагін потрібен, щоб зрозуміти, хто клієнт, а не щоб зекономити трафік.
Зазвичай достатньо. Якщо потрібна цифра, відкриваю лог доступу й сортую за реферером і байтами. Топ-3 чужих хости пояснюють більшу частину рахунку.
Далі чотири перевірки. Свій реферер віддає 200. Чужий віддає 403. Порожній віддає 200, якщо ми не вирішили інакше. Пряма адреса файлу у приватному вікні відкривається.
Четверта ловить клієнта, який не надсилає нічого. Запис у білий список лікує за п’ять хвилин, і правило працює для решти.
Вимкнути правило: дві хвилини і та сама тема за місяць.
Чого це вчить
Перед кодом спитай, який шар відповідає на запит.
Хотлінки, боти, заголовки кешу, редіректи. Питання одне й те саме. Відповідь рідко звучить «у темі».
За темою: безпека WordPress про периметр, який будує моя команда. Навички та технології про решту стеку. Якщо картинки вже тягнуть, почніть із логу. BotBlocker закриває рішення про клієнта, коли правило стоїть.
Джерела: Cloudflare Hotlink Protection, модуль referer у nginx, Apache mod_rewrite.