mirror of
https://github.com/php/doc-es.git
synced 2026-04-28 01:23:14 +02:00
Marcos Porto Mariño
5ac01aa46a
* Fix typo add ref warn.deprecated.feature-8-1-0 * Remove <para> in invalid places * Fix language snippets
205 lines
7.2 KiB
XML
205 lines
7.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 37be0e0626e8b96e617e800392651eacc5f65bdc Maintainer: PhilDaiguille Status: ready -->
|
|
<!-- Reviewed: no Maintainer: Marqitos -->
|
|
<refentry xml:id="function.session-set-cookie-params" xmlns="http://docbook.org/ns/docbook">
|
|
<refnamediv>
|
|
<refname>session_set_cookie_params</refname>
|
|
<refpurpose>Modifica los parámetros de la cookie de sesión</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>bool</type><methodname>session_set_cookie_params</methodname>
|
|
<methodparam><type>int</type><parameter>lifetime_or_options</parameter></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>path</parameter><initializer>&null;</initializer></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>domain</parameter><initializer>&null;</initializer></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>secure</parameter><initializer>&null;</initializer></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>httponly</parameter><initializer>&null;</initializer></methodparam>
|
|
</methodsynopsis>
|
|
<para>Firma alternativa disponible a partir de PHP 7.3.0:</para>
|
|
<methodsynopsis>
|
|
<type>bool</type><methodname>session_set_cookie_params</methodname>
|
|
<methodparam><type>array</type><parameter>lifetime_or_options</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
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 <function>session_set_cookie_params</function> para cada script y antes
|
|
de la llamada a <function>session_start</function>.
|
|
</para>
|
|
<para>
|
|
Esta función modifica los parámetros ini correspondientes que pueden ser
|
|
recuperados mediante <function>ini_get</function>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>lifetime_or_options</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Al utilizar la primera firma, la duración de vida de la cookie, en segundos.
|
|
Ver la directiva <link linkend="ini.session.cookie-lifetime">lifetime</link>.
|
|
</para>
|
|
<para>
|
|
Al utilizar la segunda firma,
|
|
un &array; asociativo que puede tener como claves
|
|
<literal>lifetime</literal>, <literal>path</literal>, <literal>domain</literal>,
|
|
<literal>secure</literal>, <literal>httponly</literal> y <literal>samesite</literal>.
|
|
Los valores tienen la misma significación que los descritos para los parámetros
|
|
con el mismo nombre. El valor del elemento <literal>samesite</literal> debe ser
|
|
<literal>Lax</literal> o <literal>Strict</literal>.
|
|
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
|
|
<literal>samesite</literal> es omitido, entonces el atributo SameSite de la cookie
|
|
no será definido.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>path</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La ruta en el dominio donde la cookie será accesible. Utilice
|
|
una barra simple ('/') para todos los caminos del dominio.
|
|
Ver la directiva <link linkend="ini.session.cookie-path">path</link>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>domain</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
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 <link linkend="ini.session.cookie-domain">domain</link>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>secure</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Si &true;, la cookie solo será enviada en una conexión segura.
|
|
Ver la directiva <link linkend="ini.session.cookie-secure">secure</link>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>httponly</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Si &true;, PHP intentará enviar la opción httponly
|
|
durante la configuración de la cookie.
|
|
Ver la directiva <link linkend="ini.session.cookie-httponly">httponly</link>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
&return.success;
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>8.0.0</entry>
|
|
<entry>
|
|
<parameter>path</parameter>, <parameter>domain</parameter>,
|
|
<parameter>secure</parameter> y <parameter>httponly</parameter> ahora son nullable.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>7.3.0</entry>
|
|
<entry>
|
|
Se añadió una firma alternativa que soporta un &array;
|
|
de <parameter>lifetime_or_options</parameter>. Esta firma soporta la definición
|
|
del atributo SameSite de la cookie.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>7.2.0</entry>
|
|
<entry>
|
|
&return.success; Anteriormente la función retornaba <link linkend="language.types.declarations.void">void</link>.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member>
|
|
<link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>
|
|
</member>
|
|
<member>
|
|
<link linkend="ini.session.cookie-path">session.cookie_path</link>
|
|
</member>
|
|
<member>
|
|
<link linkend="ini.session.cookie-domain">session.cookie_domain</link>
|
|
</member>
|
|
<member>
|
|
<link linkend="ini.session.cookie-secure">session.cookie_secure</link>
|
|
</member>
|
|
<member>
|
|
<link linkend="ini.session.cookie-httponly">session.cookie_httponly</link>
|
|
</member>
|
|
<member>
|
|
<link linkend="ini.session.cookie-samesite">session.cookie_samesite</link>
|
|
</member>
|
|
<member>
|
|
<function>session_get_cookie_params</function>
|
|
</member>
|
|
</simplelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|