Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

setcookie()

Prepara una cabecera Set-Cookie antes de enviar las cabeceras.

Versión: PHP 8.4; repository runtime, production runtime not attested

Sintaxis

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

Prepara una cabecera Set-Cookie antes de enviar las cabeceras. Las opciones incluyen expires como tiempo Unix, path, secure, httponly y samesite. true indica que PHP la ha preparado. El valor llega a PHP en una solicitud posterior que devuelva la cookie. Desde PHP 7.3 un array de opciones puede ocupar la tercera posición. El parámetro es $expires_or_options y options: no existe. Desde PHP 8.0 una clave de opción desconocida genera ValueError.

Firma

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

Salida del ejemplo

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

Ejemplos

<?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"]

Fuentes