Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

setcookie()

Prepara um campo Set-Cookie antes de enviar os cabeçalhos.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

setcookie(string $name, string $value = "", array|int $expires_or_options = 0, string $path = "", string $domain = "", bool $secure = false, bool $httponly = false): bool

Prepara um campo Set-Cookie antes de enviar os cabeçalhos. As opções incluem expires como instante Unix, path, secure, httponly e samesite. true indica que o PHP o aceitou para envio. O valor chega ao PHP num pedido posterior que devolva o cookie. Desde PHP 7.3 um array de opções pode ocupar a terceira posição. O parâmetro é $expires_or_options e options: não existe. Desde PHP 8.0 uma chave de opção desconhecida gera ValueError.

Assinatura

setcookie(string $name, string $value = "", array|int $expires_or_options = 0, string $path = "", string $domain = "", bool $secure = false, bool $httponly = false): bool

Saída do exemplo

true
[true,false,"ValueError","Error"]

Exemplos

<?php
if (PHP_SAPI==="cgi-fcgi") {
$ok=setcookie("theme","navy",["path"=>"/","httponly"=>true,"samesite"=>"Lax"]);
    try {setcookie("theme","navy",["unknown"=>1]);} catch (ValueError $e) {$key=get_class($e);}
    try {setcookie(name:"theme",value:"navy",options:[]);} catch (Error $e) {$named=get_class($e);}
    echo json_encode([$ok,isset($_COOKIE["theme"]),$key,$named]);
    exit;
}
$env=["REDIRECT_STATUS"=>"1","SCRIPT_FILENAME"=>__FILE__,"REQUEST_METHOD"=>"GET","QUERY_STRING"=>"qty=6"];
$proc=proc_open([PHP_BINDIR."/php-cgi"],[1=>["pipe","w"]],$pipes,null,$env);
$response=stream_get_contents($pipes[1]); fclose($pipes[1]); proc_close($proc);
[$headers,$body]=preg_split("/\\r?\\n\\r?\\n/",$response,2);
echo json_encode(str_contains($headers,"Set-Cookie: theme=navy")),"\n",$body;

Resultado

true
[true,false,"ValueError","Error"]

Fontes