diff --git a/reference/oci8/testing.xml b/reference/oci8/testing.xml index 2c3c59360..9095f4eda 100644 --- a/reference/oci8/testing.xml +++ b/reference/oci8/testing.xml @@ -1,136 +1,130 @@ - + -
- Тестирование -
- - Набор тестов для OCI8 находится в директории - ext/oci8/tests. После прогона этих тестов, в этой - директории также окажутся файлы журналов произошедших событий и ошибок. - -
-
- - Перед запуском тестов необходимо отредактировать файл - details.inc и задать значения переменным - $user, $password и строке соединения $dbase. Набор тестов OCI8 - разрабатывался с использованием учётной записи - SYSTEM. Некоторые тесты не будут выполняться, если - у тестирующего пользователя нет аналогичных прав доступа. - - - Для тестирования функции Oracle создания пулов соединений - (Database Resident Connection Pooling) необходимо установить переменную - $test_drcp в &true;, а также убедитесь, что в строке - соединения задан соответствующий адрес DRCP сервера. - - - В качестве альтернативы редактированию файла - details.inc можно задать значения переменным - окружения, например: - +
+ Тестирование + + Набор тестов для модуля OCI8 распологается в директории + ext/oci8/tests. После запуска тестов модуля OCI8 + этот каталог также будет содержать журналы сбоев. + + + Перед запуском тестов PHP необходимо отредактировать файл + details.inc и задать значения переменным + $user, $password и строке соединения $dbase. Набор тестов OCI8 + был разработан с учётной записью + SYSTEM. Некоторые тесты не будут выполняться, если + у тестирующего пользователя нет аналогичных разрешений. + + + Если тестируется пул резидентных подключений к базе данных Oracle + (Database Resident Connection Pooling), необходимо установить для переменной + $test_drcp значение &true; и проверить, что в строке + соединения установили сервер, который соответствует пулу DRCP. + + + В качестве альтернативы редактированию файла + details.inc выступает установка переменных + окружения, например: + - - Обратите внимание, что в некоторых оболочках эти переменные могут - неправильно транслироваться в PHP процесс, и в тестах будут возникать - ошибки подключения к базе данных. Будьте аккуратны при использовании этого - метода настройки модуля. - - - Далее необходимо задать окружение базы данных Oracle. Если вы используете PHP - на тех же машинах, что и Oracle Database, вы можете запустить: - + + Обратите внимание, в ряде оболочек эти переменные транслируются + в PHP-процесс неправильно, и через этот метод тесты не смогут подключиться. + + + Затем необходимо установить необходимое окружение для базы данных Oracle. Если PHP + запускается на тех же машинах, что и база данных Orcale, можно запустить: + - - - - Для Oracle 11gR2 XE: - + + + + В Oracle 11gR2 XE выполняют: + - - - - Некоторые оболочки требуют, чтобы в &php.ini; параметр - variables_order содержал литеру E, например: - + + + + Отдельные оболочки требуют, чтобы в файле &php.ini; параметр + variables_order содержал литеру E, например: + - - - - Запуск всех PHP тестов можно осуществить командой: - + + + + Запуск всех PHP-тестов выполняют командой: + - - либо можно запустить только OCI8 тесты: - + + или запускают только OCI8-тесты: + - - - - По завершении тестирования, просмотрите журналы на наличие ошибок. - На слабых машинах время выполнения некоторых тестов может превысить - значение настройки времени ожидания в файле run-tests.php. - Чтобы это исправить, задайте переменной окружения - TEST_TIMEOUT значение побольше (значение в секундах). - - - На быстрых вычислительных системах с локальной базой данных, рассчитанных - на небольшие нагрузки (например, Oracle 11gR2 XE), некоторые тесты могут - вызывать ORA-12516 или ORA-12520 ошибки. Для их предотвращения необходимо - увеличить значение параметра базы данных PROCESSES - по инструкции ниже: - - - Подключиться к базе данных в роли суперпользователя: - + + + + После завершения тестов просмотрите журналы на наличие ошибок. + На медленных системах отдельные тесты выполняются дольше, чем время ожидания теста + по умолчанию, которое указали в файле run-tests.php. + Чтобы это исправить, переменной окружения TEST_TIMEOUT + устанавливают большее количество секунд. + + + На быстрых машинах с локальной базой данных, которую настроили на небольшую нагрузку + (например, Oracle 11gR2 XE), часть тестов завершится + неудачно с ошибками ORA-12516 или ORA-12520. Чтобы предотвратить это, + значение параметра базы данных PROCESSES увеличивают + следующими действиями: + + + Подключиться к базе данных в роли суперпользователя: + - - - - Задать необходимое окружение с помощью сценариев - oracle_env.sh или - oraenv, как описано выше. - - - Запустить утилиту командной строки SQL*Plus и увеличить значение - PROCESSES - + + + + Установить необходимое окружение Oracle через сценарии + oracle_env.sh или + oraenv, как описали предыдущие параграфы. + + + Запустить утилиту командной строки SQL*Plus и увеличить значение + параметра PROCESSES + alter system set processes=100 scope=spfile ]]> - - - - Перезапустить базу данных: - + + + + Перезапустить базу данных: + startup force ]]> - - -
-
+ + +