archived-doc-es/reference/oci8/testing.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f4c44b86948f70a7e89f582b500e2595452e00f0 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<section xml:id="oci8.test" xmlns="http://docbook.org/ns/docbook">
 <title>Pruebas</title>
  <para>
   El conjunto de pruebas de OCI8 está en el directorio <filename>ext/oci8/tests</filename>.
   Después de ejecutar las pruebas de OCI8, este directorio también contendrá los registros
   de cualquier fallo.
  </para>
  <para>
   Antes de ejecutar las pruebas de PHP, edite <filename>details.inc</filename>
   y establezca $user, $password y la cadena de conexión $dbase. El
   conjunto de pruebas de OCI8 ha sido desarrollado usando
   la cuenta <literal>SYSTEM</literal>. Algunas pruebas fallarán si
   el usuario de las mismas no tiene permisos equivalentes.
  </para>
  <para>
   Si se está comprobando Oracle Database Resident Connection Pooling,
   establezca $test_drcp a &true; y asegúrese de que
   la cadena de conexión utiliza un servidor de la agrupación DRCP apropiado.
  </para>
  <para>
   Una alternativa a editar <filename>details.inc</filename> es el
   establecimiento de variables de entorno, por ejemplo:
   <programlisting>
<![CDATA[
    $ export PHP_OCI8_TEST_USER=system
    $ export PHP_OCI8_TEST_PASS=oracle
    $ export PHP_OCI8_TEST_DB=localhost/XE
    $ export PHP_OCI8_TEST_DRCP=FALSE
]]>
   </programlisting>
   Observe que en algunas shell, estas variables no se propagan correctamente
   por proceso de PHP y que las pruebas fallarán al conectar si se utiliza
   este método.
  </para>
  <para>
   Lo siguiente es establecer cualquier entorno necesario para la base de datos de Oracle.
   Con Oracle 10<emphasis>g</emphasis>R2 XE, haga lo siguiente:
   <programlisting>
<![CDATA[
    $ . /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh
]]>
   </programlisting>
  </para>
  <para>
   Con Oracle 11<emphasis>g</emphasis>R2 XE:
   <programlisting>
<![CDATA[
    $ . /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh
]]>
   </programlisting>
  </para>
  <para>
   Para otras versiones de la base de datos de Oracle, haga:
   <programlisting>
<![CDATA[
    $ . /usr/local/bin/oraenv
]]>
   </programlisting>
  </para>
  <para>
   Algunas shells requieren que &php.ini; contenga <literal>E</literal> en el
   parámetro variables_order, por ejemplo:
   <programlisting>
<![CDATA[
    variables_order = "EGPCS"
]]>
   </programlisting>
  </para>
  <para>
   Ejecute todas las pruebas de PHP con:
   <programlisting>
<![CDATA[
    $ cd your_php_src_directory
    $ make test
]]>
   </programlisting>
   o ejecute únicamente las pruebas de OCI8 con
   <programlisting>
<![CDATA[
    $ cd your_php_src_directory
    $ make test TESTS=ext/oci8
]]>
   </programlisting>
  </para>
  <para>
   Cuando hayan finalizado las pruebas, revise cualquier fallo. En sistemas
   lentos, algunas pruebas podrían tomar más tiempo que el tiempo de espera de prueba
   predeterminado de <filename>run-tests.php</filename>. Para corregir esto,
   establezca la variable de entorno <literal>TEST_TIMEOUT</literal> a
   un número mayor de segundos.
  </para>
  <para>
   En máquinas rápidas con una base de datos local configurada para una carga ligera
   (p.ej. Oracle 11<emphasis>g</emphasis>R2 XE), algunas pruebas podrían ocasionar los errores
   ORA-12516 u ORA-12520. Para evitarlo, aumente el parámetro <literal>PROCESSES</literal>
   de la base de datos siguiendo estos pasos:
  </para>
  <para>
   Conéctese como propietario del software de Oracle:
   <programlisting>
<![CDATA[
    $ su - oracle
]]>
   </programlisting>
  </para>
  <para>
   Establezca el entorno de Oracle necesario con <filename>oracle_env.sh</filename> u
   <filename>oraenv</filename>, tal como está descrito arriba.
  </para>
  <para>
   Inicie la herramienta de línea de comandos SQL*Plus y
   aumente <literal>PROCESSES</literal>
   <programlisting>
<![CDATA[
    $ sqlplus / as sysdba
    SQL> alter system set processes=100 scope=spfile
]]>
   </programlisting>
  </para>
  <para>
   Reinicie la base de datos:
   <programlisting>
<![CDATA[
    SQL> startup force
]]>
   </programlisting>
  </para>
</section>

<!-- 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
-->