From 252b5f51a371e192ab023ccd6962c99884c25873 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 31 Aug 2026 13:51:43 +0200 Subject: [PATCH] info: fix the assert, dl and getrusage return docs, and the E_ALL value --- reference/info/functions/assert.xml | 61 +++++++++---------- reference/info/functions/dl.xml | 10 +-- .../info/functions/get-defined-constants.xml | 6 +- reference/info/functions/getrusage.xml | 9 ++- 4 files changed, 41 insertions(+), 45 deletions(-) diff --git a/reference/info/functions/assert.xml b/reference/info/functions/assert.xml index 20bd60766b..1729cf4c5a 100644 --- a/reference/info/functions/assert.xml +++ b/reference/info/functions/assert.xml @@ -1,5 +1,5 @@ - + @@ -14,30 +14,30 @@ mixedassertion Throwablestringnulldescription&null; - + Функция assert определяет ожидания: утверждения, которые проверяются в средах разработки и тестирования, но перед развёртыванием в производственной среде код оптимизируют — удаляют проверки утверждений, чтобы исключить накладные расходы. - - + + Утверждения помогают отлаживать код. В одном случае утверждениями проверяют, выполняются ли предварительные условия: корректные условия вычисляются как значение &true;, а ложность условий указывает на ошибки программирования. В другом сценарии проверяют доступность конкретной функции модуля или не накладывает ли система конкретные ограничения. - - + + Утверждения не включают в производственный код и не проверяют утверждениями стандартные операции времени выполнения наподобие проверки входных параметров, поскольку код с утверждениями сломается, когда проверку ожиданий отключат в конфигурации PHP. Поэтому в производственной среде разворачивают код, который работает правильно даже при отключении проверки утверждений. - - + + Функция assert проверяет, выполняется ли ожидание, установленное в параметре assertion. Функция assert выполнит действие, которое сконфигурировали во втором параметре, если условие не выполнилось и поэтому вернуло значение &false;. - + Поведение конструкции assert определяется следующими INI-настройками: @@ -118,7 +118,7 @@ assert.exception &true; - Со значением &true; функция выбрасывает исключение AssertionError, + Со значением &true; функция выбрасывает исключение AssertionError, если ожидание не оправдалось. @@ -180,7 +180,7 @@ При передаче в параметр description значения - с типом Throwable функция выбрасывает исключение, + с типом Throwable функция выбрасывает исключение, но только если утверждение assertion не прошло проверку. @@ -220,24 +220,21 @@ &reftitle.returnvalues; - + Функция assert возвращает значение &true;, если хотя бы одно из следующих утверждений истинно: - + zend.assertions=0 zend.assertions=-1 assert.active=0 - assert.exception=1 - assert.bail=1 - В параметр description передали объект пользовательского исключения. - + Функция assert проверяет утверждения и возвращает &true; при истинности аргумента assertion, но только если ни одно из отключающих проверки условий не выполняется, иначе функция возвращает &false;. - + @@ -271,7 +268,7 @@ 8.0.0 - При передаче в параметр description экземпляра класса Throwable + При передаче в параметр description экземпляра класса Throwable исключение выбрасывается, если утверждение не прошло проверку, независимо от значения опции assert.exception. @@ -279,7 +276,7 @@ 8.0.0 - При передаче в параметр description экземпляра класса Throwable + При передаче в параметр description экземпляра класса Throwable пользовательская callback-функция не вызывается, даже если её установили. @@ -326,10 +323,10 @@ echo 'Привет!'; ?> ]]> - + Приведённый пример выведет следующее, если утверждения включили в директиве zend.assertions=1: - + 2) in example.php:2 @@ -339,10 +336,10 @@ Stack trace: thrown in example.php on line 2 ]]> - + Приведённый пример выведет следующее, если утверждения отключили путём установки для директивы значений zend.assertions=0 или zend.assertions=-1: - + ]]> - + Приведённый пример выведет следующее, если утверждения включили: - + - + Приведённый пример выведет следующее, если утверждения выключили: - + ]]> - + Приведённый пример выведет следующее, если утверждения включили: - + - + Приведённый пример выведет следующее, если утверждения выключили: - + - + @@ -90,13 +90,13 @@ &reftitle.returnvalues; - + &return.success; Если механизм загрузки модулей недоступен или отключён - (значение off настройки enable_dl в &php.ini;), будет выдана ошибка - E_ERROR и выполнение прекращается. Если + (значение off настройки enable_dl в &php.ini;), поднимается + ошибка уровня E_WARNING и возвращается &false;. Если dl не сможет загрузить заданную библиотеку, то в дополнение к &false; будет выдано сообщение E_WARNING. - + diff --git a/reference/info/functions/get-defined-constants.xml b/reference/info/functions/get-defined-constants.xml index ea8e05ec9b..df4e82fbc1 100644 --- a/reference/info/functions/get-defined-constants.xml +++ b/reference/info/functions/get-defined-constants.xml @@ -1,5 +1,5 @@ - + @@ -60,7 +60,7 @@ Array [E_USER_ERROR] => 256 [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 + [E_ALL] => 30719 [TRUE] => 1 ) @@ -127,7 +127,7 @@ Array [E_USER_ERROR] => 256 [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 + [E_ALL] => 30719 [TRUE] => 1 ) ]]> diff --git a/reference/info/functions/getrusage.xml b/reference/info/functions/getrusage.xml index bed8a42c14..0703475f86 100644 --- a/reference/info/functions/getrusage.xml +++ b/reference/info/functions/getrusage.xml @@ -1,5 +1,5 @@ - + @@ -102,12 +102,11 @@ echo $dat["ru_stime.tv_sec"]; // время на системные задач - + Если getrusage вызвана с mode равным 1 (RUSAGE_CHILDREN), то будет - собираться информация по использованию ресурсов потоками (что означает, что внутри - функция будет вызываться с RUSAGE_THREAD). - + собираться информация по использованию ресурсов дочерними процессами. +