WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

setcookie()

Bereitet vor dem Versand der Header ein Set-Cookie-Feld vor.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

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

Bereitet vor dem Versand der Header ein Set-Cookie-Feld vor. Optionen sind expires als Unix-Zeit, path, secure, httponly und samesite. true bestätigt die Annahme durch PHP. Der Wert erreicht PHP erst mit einer späteren Anfrage, die das Cookie zurücksendet. Seit PHP 7.3 ist ein Optionsarray als drittes Positionsargument möglich. Der Parameter heißt $expires_or_options, options: ist unbekannt. Seit PHP 8.0 löst ein unbekannter Optionsschlüssel ValueError aus.

Signatur

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

Ausgabe des Beispiels

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

Beispiele

<?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;

Ergebnis

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

Quellen