세션 처리 session_set_cookie_params

(PHP 4, PHP 5, PHP 7, PHP 8)

session_set_cookie_params — 세션 쿠키 매개변수 설정


설명

session_set_cookie_params(
    int $lifetime_or_options,
    ?string $path = null,
    ?string $domain = null,
    ?bool $secure = null,
    ?bool $httponly = null
): bool
                

PHP 7.3.0부터 사용 가능한 대체 서명:

session_set_cookie_params(array $lifetime_or_options): bool

php.ini 파일에 정의된 쿠키 매개변수를 설정합니다. 이 함수의 효과는 스크립트 기간 동안만 지속됩니다. 따라서 모든 요청에 ​​대해 session_start()가 호출되기 전에 session_set_cookie_params()를 호출해야 합니다.

이 함수는 ini_get()으로 검색할 수 있는 해당 PHP ini 구성 키의 런타임 ini 값을 업데이트합니다.


매개변수

lifetime_or_options
첫 번째 서명을 사용할 때 세션 쿠키의 lifetime으로 초 단위로 정의됩니다.

두 번째 서명을 사용할 때 키 lifetime, path, domain, secure, httponlysamesite 중 하나를 가질 수 있는 연관 배열입니다. 값은 이름이 같은 매개변수에 대해 설명된 것과 동일한 의미를 갖습니다. samesite 요소의 값은 Lax 또는 Strict여야 합니다. 허용된 옵션이 지정되지 않은 경우 해당 기본값은 명시적 매개변수의 기본값과 동일합니다. samesite 요소가 생략되면 SameSite 쿠키 속성이 설정되지 않습니다.

path
쿠키가 작동할 도메인의 Path입니다. 도메인의 모든 경로에 단일 슬래시('/')를 사용합니다.
domain
쿠키 도메인(예: 'www.php.net'). 모든 하위 도메인에서 쿠키를 볼 수 있게 하려면 도메인 앞에 '.php.net'과 같은 점을 붙여야 합니다.
secure
true인 경우 쿠키는 보안 연결을 통해서만 전송됩니다.
httponly
true로 설정하면 PHP는 세션 쿠키를 설정할 때 httponly 플래그를 보내려고 시도합니다.

반환 값

성공하면 true를, 실패하면 false를 반환합니다.


변경 로그

버전 설명
8.0.0 path, domain, securehttponly은 이제 nullable입니다.
7.3.0 life_or_options 배열을 지원하는 대체 서명이 추가되었습니다. 이 서명은 SameSite 쿠키 속성 설정도 지원합니다.
7.2.0 성공하면 true를, 실패하면 false를 반환합니다. 이전에는 함수가 void를 반환했습니다.

기타