Как контролировать кэш CSS и скриптов

Браузер намертво кэширует стили и скрипты? Обновление стилий происходит только после нажатия клавиш Ctrl+f5? А при обычном обновлении страницы упорно продолжают подгружаться устаревшие css, скрипты и прочие файлы, который вы, будучи разработчиком уже поправили.

Такая ситуация не редка, и может весьма раздражать, заставляя буквально каждый раз вручную обновлять кэш, зижимая Ctrl+f5. Но неудобство на рабочем компьютере — пол беды. А реальные проблемы могут возникунуть:

  • При просмотре сайта заказчиком, которого не всегда можно научить "правильно перезагружить страницу"
  • При тестировании на мобильном устройстве, где скинуть кэш бывает совсем не просто

Решение проблемы кыширования CSS и скриптов

Для решения проблемы кэша CSS, скриптов и прочих файлов рекомендую воспользоваться весьма изящным способом. Всего лишь на всего нужно добавить хэш файла как GET-параметр к адресу файла

Эту задачу легко можно релизовать с помощью встроенной php-функции md5_file(), на вход она принемает путь к файлу, а выдает хэш. Ниже представлено простой скрипт, реализующий эту идею.

Именно таким образом интернет-гиганты обновляют дизайн у всех пользователей, не прося каждого нажать Ctrl+f5.

function fileCashFix($input){
  $file_path = $_SERVER['DOCUMENT_ROOT'].$input;
  if(file_exists($file_path)){
    return $input."?".md5_file($file_path);
  }else{
    return $input;
  }
}

После того как вы так или иначе применили этот подход вы можете:

  • Не беспокоиться о том, что кому-то подгрузится неактуальный файл.
  • Настроить максимальное время жизни кэша этих файлов в htaccess

Сниппет для MODx

  • Название сниппета: fileCashFix
  • Использование сниппета: <link href="[[!fileCashFix?input=`css/style.css`]]" rel="stylesheet">
$file_path = MODX_BASE_PATH.$input;
if(file_exists($file_path)){
  return $input."?".md5_file($file_path);
}else{
  return $input;
}

Для внешнего файла

! Запрос file_get_contents($input) может замедлять работу сайта, так как закачивает файл на сервер.

Использование сниппета: [[!fileCashFix?input=`https://fonts.googleapis.com/css?family=Roboto:400`]]. Важно указать именно https:// или https:// — просто // не пройдет.

$file_path = MODX_BASE_PATH.$input;
if(file_exists($file_path)){
  return $input."?".md5_file($file_path);
}else{
  // Если не нашли файл у себя, может быть передана ссылка на внешний файл
  $external_file = file_get_contents($input);
  if($external_file){
    // Проверяем, есть ли уже GET-параметры в запросе к файлу
    if(strpos($input, "?") !== false){
      return $input."&fileCashFix=".md5($external_file);
    }else{
      return $input."?fileCashFix=".md5($external_file);
    }
  }else{
    return $input;
  }
}

Комментарии (1)

  1. Дмитрий 26 января 2022, 00:28 # 0
    Здравствуйте!
    на Wordpress это как можно приспособить, куда кидать файл со сниппетом, в корень или добавлять код сниппета в файл function.php шаблона?
    *Комментарий будет опубликован после проверки модератором

    Комментарии easyComm

    Дмитрий 28 марта 2018, 14:51

    Не подождите...
    Например, в своей реализации я в md5_file() НЕ передаю адрес файла скаченного на сервер.
    Я прочитал, что в новой версии php md5_file() умеет внешние ссылки отрабатывать поэтому сразу дал исходный файл.

    Администратор

    :)
    Ок, а как по-вашему он обрабатывает внешние ссылки? Ну вот просто логически поразмыслите... Можно ли обработать файл, не имея его у себя? Мы ведь не отправляем воркер на ТОТ сервер, как это бывает в работе с BigData. Мы просто скачиваем файл в какую-нибудь папку temp, работаем с ним и удаляем без следа. Это можно сравнить с работой браузера — браузер скачивает страницу сайта из интернета, чтобы отобразить ее для пользователя.
    ...А время дополнительное уходит потому что для скачивания файла нужно сделать все то же, что и браузеру - поиск DNS, ожидание ответа того сервера, время на загрузку, то-сё... И если это статичный маленький файл - хорошо, а если мы запрашиваем какой-нибудь условно XML на 150мб, генерируемый на лету, то задержка будет еще и из-за того, что файл долго генерировался где-то там на сервере. Все так же как и с открытием страницы в браузере.

    Дмитрий 28 марта 2018, 14:43

    А в чём смысл закачивать файл на сервак?

    Администратор

    А как еще его обработать функцией md5() или md5_file()?
    Он не сохраняется, но закачать-то его надо чтобы обработать.
    То же самое делает и предложенная Вами функция fopen()

    Дмитрий 28 марта 2018, 12:17

    Вот я сделал также для внешнего файла.
    <?php
    //
    $file_path = MODX_BASE_PATH.$input;
    if(file_exists($file_path)) { // Проверка файла на сервере
    return $input."?v=".md5_file($file_path);
    } else if (@fopen($input, "r")) { // Проверка доступа к внешней ссылке
    return $input."?v=".md5_file($input);
    } else {
    return $input;
    }

    Администратор

    Спасибо, добавил немного доработанный вариант реализации в статью.

    Дмитрий 28 марта 2018, 11:47

    Как сделать для внешнего файла?

    Good 17 марта 2018, 22:30

    очень интересно. но куда это нужно поместить? какой путь и в какой файл

    Павел 17 марта 2018, 22:30

    я так понял что на php5.3 и ниже, эта фича не работает?

    Похожие статьи

    Наш сайт использует куки, нажмите «ОК» если вы не против
    OK