<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/oci8.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'oci8.test.php',
    1 => 'Тестирование',
    2 => 'Тестирование',
  ),
  'up' => 
  array (
    0 => 'oci8.setup.php',
    1 => 'Установка и настройка',
  ),
  'prev' => 
  array (
    0 => 'oci8.installation.php',
    1 => 'Установка',
  ),
  'next' => 
  array (
    0 => 'oci8.configuration.php',
    1 => 'Настройка во время выполнения',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/oci8/testing.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="oci8.test" class="section">
 <h2 class="title">Тестирование</h2>
 <p class="para">
  Набор тестов для модуля OCI8 располагается в директории
  <var class="filename">ext/oci8/tests</var>. После запуска тестов модуля OCI8
  этот каталог также будет содержать журналы сбоев.
 </p>
 <p class="para">
  Перед запуском тестов PHP необходимо отредактировать файл
  <var class="filename">details.inc</var> и задать значения переменным
  $user, $password и строке соединения $dbase. Набор тестов OCI8
  был разработан с учётной записью
  <code class="literal">SYSTEM</code>. Некоторые тесты не будут выполняться, если
  у тестирующего пользователя нет аналогичных разрешений.
 </p>
 <p class="para">
  Если тестируется пул резидентных подключений к базе данных Oracle
  (Database Resident Connection Pooling), необходимо установить для переменной
  $test_drcp значение <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> и проверить, что в строке
  соединения установили сервер, который соответствует пулу DRCP.
 </p>
 <p class="para">
  В качестве альтернативы редактированию файла
  <var class="filename">details.inc</var> выступает установка переменных
  окружения, например:
  <div class="example-contents">
<div class="cdata"><pre>
    $ 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
</pre></div>
  </div>

  Обратите внимание, в ряде оболочек эти переменные транслируются
  в PHP-процесс неправильно, и через этот метод тесты не смогут подключиться.
 </p>
 <p class="para">
  Затем необходимо установить необходимое окружение для базы данных Oracle. Если PHP
  запускается на тех же машинах, что и база данных Orcale, можно запустить:
  <div class="example-contents">
<div class="cdata"><pre>
    $ . /usr/local/bin/oraenv
</pre></div>
  </div>

 </p>
 <p class="para">
  В Oracle 11<em>g</em>R2 XE выполняют:
  <div class="example-contents">
<div class="cdata"><pre>
    $ . /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh
</pre></div>
  </div>

 </p>
 <p class="para">
  Отдельные оболочки требуют, чтобы в файле <var class="filename">php.ini</var> параметр
  variables_order содержал литеру <code class="literal">E</code>, например:
  <div class="example-contents">
<div class="cdata"><pre>
    variables_order = &quot;EGPCS&quot;
</pre></div>
  </div>

 </p>
 <p class="para">
  Запуск всех PHP-тестов выполняют командой:
  <div class="example-contents">
<div class="cdata"><pre>
    $ cd your_php_src_directory
    $ make test
</pre></div>
  </div>

  или запускают только OCI8-тесты:
  <div class="example-contents">
<div class="cdata"><pre>
    $ cd your_php_src_directory
    $ make test TESTS=ext/oci8
</pre></div>
  </div>

 </p>
 <p class="para">
  После завершения тестов просмотрите журналы на наличие ошибок.
  На медленных системах отдельные тесты выполняются дольше, чем время ожидания теста
  по умолчанию, которое указали в файле <var class="filename">run-tests.php</var>.
  Чтобы это исправить, переменной окружения <code class="literal">TEST_TIMEOUT</code>
  устанавливают большее количество секунд.
 </p>
 <p class="para">
  На быстрых машинах с локальной базой данных, которую настроили на небольшую нагрузку
  (например, Oracle 11<em>g</em>R2 XE), часть тестов завершится
  неудачно с ошибками ORA-12516 или ORA-12520. Чтобы предотвратить это,
  значение параметра базы данных <code class="literal">PROCESSES</code> увеличивают
  следующими действиями:
 </p>
 <p class="para">
  Подключиться к базе данных в роли суперпользователя:
  <div class="example-contents">
<div class="cdata"><pre>
    $ su - oracle
</pre></div>
  </div>

 </p>
 <p class="para">
  Установить необходимое окружение Oracle через сценарии
  <var class="filename">oracle_env.sh</var> или
  <var class="filename">oraenv</var>, как описали предыдущие параграфы.
 </p>
 <p class="para">
  Запустить утилиту командной строки SQL*Plus и увеличить значение
  параметра <code class="literal">PROCESSES</code>
  <div class="example-contents">
<div class="cdata"><pre>
    $ sqlplus / as sysdba
    SQL&gt; alter system set processes=100 scope=spfile
</pre></div>
  </div>

 </p>
 <p class="para">
  Перезапустить базу данных:
  <div class="example-contents">
<div class="cdata"><pre>
    SQL&gt; startup force
</pre></div>
  </div>

 </p>
</div><?php manual_footer($setup); ?>