세션 처리 session_name
(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — 현재 세션 이름 가져오기 및/또는 설정
설명
session_name(?string $name
= null
): string|false
session_name()은 현재 세션의 이름을 반환합니다. name
이 주어지면 session_name()은 세션 이름을 업데이트하고 이전 세션 이름을 반환합니다.
새 세션 name
이 제공되면 session_name()은 HTTP 쿠키를 수정하고 session.transid
가 활성화되면 내용을 출력합니다. HTTP 쿠키가 전송되면 session_name()에서 오류가 발생합니다. 세션이 제대로 작동하려면 session_name()이 session_start()보다 먼저 호출되어야 합니다.
세션 이름은 요청 시작 시 session.name
에 저장된 기본값으로 재설정됩니다. 따라서 모든 요청에 대해 session_name()을 호출해야 합니다(그리고 session_start()가 호출되기 전에).
매개변수
name
- 세션 이름은 쿠키 및 URL(예: PHPSESSID)에서 사용되는 세션 이름을 참조합니다. 영숫자만 포함해야 합니다. 짧고 설명적이어야 합니다(예: 쿠키 경고가 활성화된 사용자의 경우).
name
이 지정되고null
이 아닌 경우 현재 세션의 이름이 해당 값으로 변경됩니다.경고 세션 이름은 숫자로만 구성될 수 없으며 하나 이상의 문자가 있어야 합니다. 그렇지 않으면 매번 새로운 세션 ID가 생성됩니다.
반환 값
현재 세션의 이름을 반환합니다. name
이 주어지고 함수가 세션 이름을 업데이트하면 이전 세션의 이름이 반환되거나 실패하면 false
가 반환됩니다.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | name 은 이제 nullable입니다. |
7.2.0 | session_name()은 세션 상태를 확인합니다. 이전에는 쿠키 상태만 확인했습니다. 따라서 이전 session_name()을 사용하면 session_start() 이후에 session_name()을 호출할 수 있으므로 PHP가 충돌하고 오작동이 발생할 수 있습니다. |
Examples
예제 #1 session_name() 예제
<?php
/* set the session name to WebsiteID */
$previous_name = session_name("WebsiteID");
echo "The previous session name was $previous_name<br />";
?>
기타
- session.name 구성 지시문