oci-password-change.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6728d8981c43a02192d9cd2144f3e4a40113e976 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.oci-password-change" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>oci_password_change</refname>
  <refpurpose>Cambia la contraseña de un usuario de Oracle</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>oci_password_change</methodname>
   <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
   <methodparam><type>string</type><parameter>username</parameter></methodparam>
   <methodparam><type>string</type><parameter>old_password</parameter></methodparam>
   <methodparam><type>string</type><parameter>new_password</parameter></methodparam>
  </methodsynopsis>
  <methodsynopsis>
   <type>resource</type><methodname>oci_password_change</methodname>
   <methodparam><type>string</type><parameter>dbname</parameter></methodparam>
   <methodparam><type>string</type><parameter>username</parameter></methodparam>
   <methodparam><type>string</type><parameter>old_password</parameter></methodparam>
   <methodparam><type>string</type><parameter>new_password</parameter></methodparam>
  </methodsynopsis>
  <para>
   Cambia la contraseña del usuario dado por <parameter>username</parameter>.
  </para>
  <para>
   La función <function>oci_password_change</function> es más útil para scripts de línea de comandos de PHP,
   o cuando se usan conexiones no persistentes a través de una aplicación de PHP.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       Un identificador de conexión de Oracle devuelto por
       <function>oci_connect</function> o <function>oci_pconnect</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>username</parameter></term>
     <listitem>
      <para>
       El nombre del usuario de Oracle.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>old_password</parameter></term>
     <listitem>
      <para>
       La contraseña antigua.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>new_password</parameter></term>
     <listitem>
      <para>
       La nueva contraseña a establecer.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>dbname</parameter></term>
     <listitem>
      <para>
       El nombre de la base de datos.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>oci_password_change</function> cambiando la contraseña de un usuario ya conectado</title>
    <programlisting role="php">
<![CDATA[
<?php

$bd                = 'localhost/orcl';
$usuario           = 'cj';
$contraseña_actual = 'welcome';
$contraseña_nueva  = 'geelong';

$c = oci_pconnect($usuario, $contraseña_actual, $bd);
oci_password_change($c, $usuario, $contraseña_actual, $contraseña_nueva);
echo "La nueva contraseña es : " . $contraseña_nueva . "\n";

?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>Ejemplo de <function>oci_password_change</function> conectando y cambiando la contraseña en un solo paso</title>
    <programlisting role="php">
<![CDATA[
<?php

$bd                = 'localhost/orcl';
$usuario           = 'cj';
$contraseña_actual = 'welcome';
$contraseña_nueva  = 'geelong';

$c = oci_pconnect($usuario, $contraseña_actual, $bd);
if (!$c) {
    $m = oci_error();
    if ($m['code'] == 28001) { // "ORA-28001: the password has expired"
        // Identinficarse y reiniciar la contraseña al mismo tiempo
        $c = oci_password_change($bd, $usuario, $contraseña_actual, $contraseña_nueva);
        if ($c) {
            echo "La nueva contraseña es : " . $contraseña_nueva . "\n";
        }
    }
}

if (!$c) {  // El error original era 28001, o que el cambio de contraseña falló
    $m = oci_error();
    trigger_error('No se pudo conectar a la base de datos: '. $m['message'], E_USER_ERROR);
}

// Usar la conexión $c
...

?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    El cambio de la contraseña mediante esta función o directamente en
    Oracle debería hacerse con cuidado. Esto es debido a que las aplicaciones de PHP
    podrían seguir reutilizando con éxito conexiones persistentes mediante
    la autenticación con contraseñas antiguas. La mejor práctica es
    reinicializar todos los servidores web siempre que se cambie una contraseña de usuario.
   </para>
  </note>
  <note>
   <para>
    Si se actualizan las bibliotecas cliente o la base de datos de Oracle desde una versión anterior a la 11.2.0.3
    hasta esta misma versión o superior, <function>oci_password_change</function> pordría generar el
    error "ORA-1017: invalid username/password" a menos que las versiones del cliente y del servidor
    se actualicen a la vez.
   </para>
  </note>
  <note>
   <para>
    Está disponible la segunda sintaxis de <function>oci_password_change</function>
    desde la versión 1.1 de OCI8.
   </para>
  </note>
  <note>
   <para>
    En versiones de PHP anteriores a la 5.0.0 se debe usar <function>ocipasswordchange</function>
    en su lugar. Este nombre aún puede usarse; se dejó como alias de
    <function>oci_password_change</function> por razones de retrocompatibilidad.
    Sin embargo, este nombre es obsoleto y no se recomienda.
   </para>
  </note>
  
 </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
-->