1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-26 00:12:06 +01:00
Files
archived-doc-es/reference/info/functions/putenv.xml
Pedro Antonio Gil Rodríguez 50c3746a80 Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@337782 c90b9560-bf6c-de11-be94-00142212c4b1
2015-09-08 10:34:19 +00:00

124 lines
3.6 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8fbb603b308cb3facf302f8b7a9f3f72fa07bb6c Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.putenv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>putenv</refname>
<refpurpose>Establece el valor de una variable de entorno</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>putenv</methodname>
<methodparam><type>string</type><parameter>setting</parameter></methodparam>
</methodsynopsis>
<para>
Agrega <parameter>setting</parameter> al entorno del servidor. La
variable de entorno existirá únicamente durante la petición actual. Al
final de la petición el entorno es recuperado a su estado original.
</para>
<para>
Definir ciertas variables de entorno puede representar una brecha de
seguridad potencial. La directiva
<literal>safe_mode_allowed_env_vars</literal> contiene una lista de
prefijos delimitados por comas. En Modo Seguro, el usuario puede alterar
únicamente variables de entorno cuyos nombres comiencen con los prefijos
ofrecidos por esta directiva. Por omisión, los usuarios sólo podrán
definir variables de entorno que comiencen con <literal>PHP_</literal>
(p.ej. <literal>PHP_FOO=BAR</literal>). Nota: si esta directiva se
encuentra vacía, ¡PHP permitirá que el usuario modifique CUALQUIER
variable de entorno!
</para>
<para>
La directiva <literal>safe_mode_protected_env_vars</literal> contiene una
lista de variables de entorno delimitadas por comas, que el usuario final
no podrá modificar usando <function>putenv</function>. Estas variables
serán protegidas incluso si <literal>safe_mode_allowed_env_vars</literal>
se establece de tal modo que permita modificarlas.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>setting</parameter></term>
<listitem>
<para>
El parámetro, como p.ej. <literal>"FOO=BAR"</literal>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Definición de una variable de entorno</title>
<programlisting role="php">
<![CDATA[
<?php
putenv("UNIQID=$uniqid");
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
La directiva <literal>safe_mode_allowed_env_vars</literal> y
<literal>safe_mode_protected_env_vars</literal> sólo tendrán efecto
cuando <link linkend="features.safe-mode">safe_mode</link> esté habilitado. </para>
</warning>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>getenv</function></member>
<member><function>apache_setenv</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
-->