Modifica los parámetros de configuración de la cookie de sesión, que ha sido
configurada en el archivo php.ini. El efecto de esta función solo dura
durante la ejecución del script actual. Por lo tanto, debe llamarse
a session_set_cookie_params() para cada script y antes
de la llamada a session_start().
Esta función modifica los parámetros ini correspondientes que pueden ser
recuperados mediante ini_get().
Parámetros
lifetime_or_options
Al utilizar la primera firma, la duración de vida de la cookie, en segundos.
Ver la directiva lifetime.
Al utilizar la segunda firma,
un array asociativo que puede tener como claves
lifetime, path, domain,
secure, httponly y samesite.
Los valores tienen la misma significación que los descritos para los parámetros
con el mismo nombre. El valor del elemento samesite debe ser
Lax o Strict.
Si una opción autorizada no es proporcionada, su valor por defecto será
idéntico al valor por defecto de los parámetros explícitos. Si el elemento
samesite es omitido, entonces el atributo SameSite de la cookie
no será definido.
path
La ruta en el dominio donde la cookie será accesible. Utilice
una barra simple ('/') para todos los caminos del dominio.
Ver la directiva path.
domain
El dominio de la cookie, por ejemplo 'www.php.net'. Para hacer visibles las cookies
en todos los subdominios, el dominio debe ser prefijado con
un punto, tal como '.php.net'.
Ver la directiva domain.
secure
Si true, la cookie solo será enviada en una conexión segura.
Ver la directiva secure.
httponly
Si true, PHP intentará enviar la opción httponly
durante la configuración de la cookie.
Ver la directiva httponly.
Valores devueltos
Esta función retorna true en caso de éxito o false si ocurre un error.
Historial de cambios
Versión
Descripción
8.0.0
path, domain,
secure y httponly ahora son nullable.
7.3.0
Se añadió una firma alternativa que soporta un array
de lifetime_or_options. Esta firma soporta la definición
del atributo SameSite de la cookie.
7.2.0
Esta función retorna true en caso de éxito o false si ocurre un error. Anteriormente la función retornaba void.
