Basta usar o formato 'D, d M Y H:i:s T'
(veja a descrição de cada campo na documentação).
Para transformar a string em data, use date_create_from_format
, e a partir da data retornada por esta função, use getTimestamp
para poder comparar com o timestamp retornado por filemtime
:
$data = date_create_from_format('D, d M Y H:i:s T', 'Wed, 21 Oct 2015 07:28:00 GMT');
if ($data && $data->getTimestamp() > filemtime('arquivo')) {
etc...
}
Já para converter o retorno de filemtime
para o formato em questão, use gmdate
, que é similar à date
, porém força que a data retornada esteja em GMT (com date
não funciona, porque ele retorna UTC
em vez de GMT
). Veja a diferença:
// testando com um arquivo modificado hoje
echo gmdate('D, d M Y H:i:s T', filemtime('arquivo')); // Wed, 10 Feb 2021 14:24:23 GMT
echo date('D, d M Y H:i:s T', filemtime('arquivo')); // Wed, 10 Feb 2021 14:24:23 UTC
Outra alternativa é usar a constante DateTimeInterface::RFC7231
como formato, que por colocar explicitamente "GMT" no final, funciona tanto com date
quanto com gmdate
:
$format = DateTimeInterface::RFC7231;
$data = date_create_from_format($format, 'Wed, 21 Oct 2015 07:28:00 GMT');
// usar $data, etc
echo gmdate($format, filemtime('arquivo')); // Wed, 10 Feb 2021 14:24:23 GMT
echo date($format, filemtime('arquivo')); // Wed, 10 Feb 2021 14:24:23 GMT
Indo um pouco além...
Como a pergunta fala sobre o "valor do header If-Modified-Since
", acho que vale a pena se aprofundar um pouco mais.
Se consultarmos a RFC 7232 (HTTP Conditional Requests), veremos que o header If-Modified-Since
é definido como:
If-Modified-Since = HTTP-date
An example of the field is:
If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
E a definição de HTTP-date
está na RFC 7231 (tradução e ênfases minhas):
Antes de 1995, havia 3 formatos diferentes usados pelos servidores para envio de timestamps. Por motivos de compatibilidade com implementações antigas, todos os 3 são definidos aqui. O formato preferencial é ... um subset do especificado na RFC5322:
HTTP-date = IMF-fixdate / obs-date
Um exemplo do formato preferencial:
Sun, 06 Nov 1994 08:49:37 GMT ; IMF-fixdate
Exemplos dos formatos obsoletos:
Sunday, 06-Nov-94 08:49:37 GMT ; obsolete RFC 850 format Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
Ou seja, atualmente, deve-se dar preferência ao formato citado na pergunta (e que é definido na RFC5322). Mas a RFC 7321 também cita que "A recipient that parses a timestamp value in an HTTP header field MUST accept all three HTTP-date formats" (ou seja, mesmo que os 2 últimos formatos estejam obsoletos, ainda devem ser aceitos).
Sendo assim, uma alternativa para aceitar os 3 formatos é tentar um a um, até que seja possível fazer o parsing (ou até que todos falhem):
function parse($headerValue) {
// formatos (dando preferência para o não-obsoleto)
$formatos = [ DateTimeInterface::RFC7231, DateTimeInterface::RFC850, 'D M d H:i:s Y' ];
foreach ($formatos as $formato) {
$data = date_create_from_format($formato, $headerValue);
if ($data) return $data;
}
return FALSE;
}
$formato_saida = DateTimeInterface::RFC7231;
$values = [ 'Wed, 21 Oct 2015 07:28:00 GMT', 'Sunday, 06-Nov-94 08:49:37 GMT', 'Sun Nov 6 08:49:37 1994' ];
foreach ($values as $val) {
$data = parse($val);
if ($data) {
if ($data->getTimestamp() > filemtime('arquivo')) {
// etc...
}
$saida = gmdate($formato_saida, $data->getTimestamp());
echo "$val -> $saida\n";
} else {
echo "$val -> data inválida\n";
}
}
Para fazer o parsing, dei preferência para o formato... preferencial indicado na RFC, e depois eu tento os obsoletos. Repare que o segundo formato é RFC850
(que lê o ano com 2 dígitos), em vez do COOKIE
(que é quase igual, só que ele tenta ler o ano com 4 dígitos e 94
é interpretado como o ano 94 em vez de 1994). E para o terceiro formato, não achei uma constante pré-definida que servisse, então montei o formato manualmente mesmo.
Já para formatar a saída, eu usei o RFC7231
, que coloca sempre "GMT" no final (os demais colocam outros valores, como "UTC" ou "+00:00"). Optei por usar esse formato, porque é o único que a RFC define como não sendo obsoleto (ou seja, para receber eu aceito qualquer formato, mas na hora de enviar, uso o "preferencial" não-obsoleto). A saída do código acima é:
Wed, 21 Oct 2015 07:28:00 GMT -> Wed, 21 Oct 2015 07:28:00 GMT
Sunday, 06-Nov-94 08:49:37 GMT -> Sun, 06 Nov 1994 08:49:37 GMT
Sun Nov 6 08:49:37 1994 -> Sun, 06 Nov 1994 08:49:37 GMT
Uma alternativa mais simples
As opções acima são para o caso de você, além da comparação com filemtime
, também precisar manipular a data de outras maneiras (já que date_create_from_format
retorna um DateTime
).
Mas se você só quer o valor do timestamp para poder comparar com o retorno de filemtime
, pode usar strtotime
, que reconhece os 3 formatos definidos na RFC:
$formato_saida = DateTimeInterface::RFC7231;
$values = [ 'Wed, 21 Oct 2015 07:28:00 GMT', 'Sunday, 06-Nov-94 08:49:37 GMT', 'Sun Nov 6 08:49:37 1994' ];
foreach ($values as $val) {
$timestamp = strtotime($val);
if ($timestamp === FALSE) {
echo "$val -> data inválida\n";
} else {
// comparação direta
if ($timestamp > filemtime('arquivo')) {
// etc...
}
// formatar para o formato preferencial não-obsoleto
$saida = gmdate($formato_saida, $timestamp);
echo "$val -> $saida\n";
}
}
A diferença, claro, é que strtotime
aceita vários outros formatos (alguns até meio "esotéricos", como 'last day of february this year'
), então depende do quão rígido você quer ser: se quer aceitar somente os 3 formatos indicados pela RFC, use a função parse
definida acima (que só aceita especificamente aqueles formatos).
Mas se a entrada é controlada (por exemplo, você garante que a data é obtida do header - que nesse caso, estará disponível em $_SERVER['HTTP_IF_MODIFIED_SINCE']
) e que não estará em um formato fora do padrão, usar strtotime
simplifica as coisas.
Para mais detalhes, veja "Handling If-modified-since header in a PHP-script".