База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

setcookie()

Подготвя поле Set-Cookie преди изпращане на заглавките.

Версия: PHP 8.4; repository runtime, production runtime not attested

Синтаксис

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

Подготвя поле Set-Cookie преди изпращане на заглавките. Опциите включват expires като Unix време, path, secure, httponly и samesite. true означава, че PHP е приел бисквитката за изпращане. Стойността пристига в PHP при следваща заявка, която я връща. От PHP 7.3 масив с опции може да е трети позиционен аргумент. Параметърът е $expires_or_options, а options: не съществува. От PHP 8.0 непознат ключ на опция води до ValueError.

Сигнатура

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

Изход от примера

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

Примери

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

Резултат

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

Източници