KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

setcookie()

Zet vóór verzending van de headers een Set-Cookie-veld klaar.

Versie: 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

Zet vóór verzending van de headers een Set-Cookie-veld klaar. Opties zijn onder meer expires als Unix-tijdstip, path, secure, httponly en samesite. true betekent dat PHP de cookie klaarzette. De waarde bereikt PHP pas via een later verzoek dat de cookie meestuurt. Sinds PHP 7.3 kan een optiearray op de derde positie staan. De parameter heet $expires_or_options en options: bestaat niet. Een onbekende optiesleutel geeft sinds PHP 8.0 ValueError.

Signatuur

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

Uitvoer van het voorbeeld

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

Voorbeelden

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

Resultaat

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

Bronnen