diff --git a/language-snippets.ent b/language-snippets.ent index b697772193..a623d943cc 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -847,7 +847,7 @@ $compareFunc = static function ($item1, $item2) { '> - + @@ -2119,37 +2119,36 @@ GnuPG: или ресурс, который вернула функция -Содержит -экземпляр Oracle для подключения. Это может быть -Easy Connect - string, или Connect Name из файла -tnsnames.ora, или имя локального экземпляра Oracle. + + Идентификатор экземпляра Oracle, к которому требуется подключиться: + строка Easy Connect, + Connect Name из файла tnsnames.ora или имя локального экземпляра Oracle. -Если не указано отдельно или &null;, PHP использует - переменные окружения, такие как TWO_TASK (на Linux) - или LOCAL (на Windows) - и ORACLE_SID для определения - экземпляра Oracle для соединения. +При пропуске аргумента или передаче значения &null; + PHP определяет экземпляр Oracle для подключения + по переменным окружения: TWO_TASK на Linux + или LOCAL на Windows, + и ORACLE_SID. - Для использования метода Easy Connect, PHP должен быть слинкован с клиентскими библиотеками версии Oracle - 10g или старше. Easy Connect string для Oracle 10g принимает следующую форму: - [//]host_name[:port][/service_name]. Начиная с Oracle 11g синтаксис таков: + Метод Easy Connect сработает, только если PHP слинкован с клиентскими библиотеками версии Oracle + 10g или старше. Формат строки Easy Connect для Oracle 10g: + [//]host_name[:port][/service_name]. Начиная с Oracle 11g синтаксис расширили: [//]host_name[:port][/service_name][:server_type][/instance_name]. - В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности. - Обратитесь к документации Oracle. Названия служб могут быть определены с помощью запуска Oracle утилиты lsnrctl status + В Oracle 19c ввели дополнительные параметры, включая настройки времени ожидания и проверки активности. + Подробности содержит документация Oracle. Названия служб выводятся при запуске Oracle-утилиты lsnrctl status на сервере базы данных. - Файл tnsnames.ora может находиться в поисковом пути Oracle Net, который включает + Компонент Oracle Net ищет файл tnsnames.ora в каталогах /your/path/to/instantclient/network/admin, - $ORACLE_HOME/network/admin и /etc. В качестве альтернативного варианта - можно установить TNS_ADMIN таким образом, чтобы путь $TNS_ADMIN/tnsnames.ora был читаемым. - Убедитесь, что веб-сервер имеет доступ к этому файлу. + $ORACLE_HOME/network/admin и /etc. Альтернатива — + установить переменную окружения TNS_ADMIN, чтобы файл считывался по пути $TNS_ADMIN/tnsnames.ora. + Процессу веб-сервера требуется доступ на чтение файла конфигурации. "> -Определяет кодировку, которую будут использовать клиентские библиотеки Oracle. +Определяет кодировку для клиентских библиотек Oracle. Кодировка не обязательно должна совпадать с кодировкой самой базы данных. Oracle сделает всё возможное, чтобы преобразовать данные из или в эту кодировку, если кодировка не совпадает. В зависимости от кодировок это не всегда даёт приемлемые результаты. Преобразование также занимает некоторое время. @@ -2217,8 +2216,8 @@ Oracle сделает всё возможное, чтобы преобразов в базе данных.'> Для запросов, -которые возвращают большое количество рядов, производительность может быть -значительно увеличена за счёт увеличения значения опции +которые возвращают большое количество рядов, производительность +значительно увеличивают за счёт увеличения значения опции oci8.default_prefetch или вызова функции oci_set_prefetch. '> @@ -2539,7 +2538,7 @@ xmlns="http://docbook.org/ns/docbook"> resultОбрабатываемый результат запроса. -Этот результат может быть получен с помощью функции mysql_query.'> +Результат получают функцией mysql_query.'> field_offsetЧисловое смещение поля. @@ -2708,11 +2707,11 @@ xmlns="http://docbook.org/ns/docbook"> linkТолько для процедурного стиля: идентификатор соединения stomp, полученный из stomp_connect."> headersАссоциативный массив, содержащий дополнительные заголовки (пример: receipt)."> -Также может быть указан заголовок транзакции, означающий что приём сообщения должен являться частью именованной транзакции."> +Заголовок транзакции включает приём сообщения в состав именованной транзакции."> Stomp асинхронен по своей сути. -Синхронная связь может быть реализована добавлением receipt-заголовка. Это заставит методы ничего не возвращать, пока -сервер не подтвердит получение сообщения или не будет превышено время ожидания сообщения."> +Синхронную связь реализуют путём добавлением receipt-заголовка, которые заставят методы не возвращать значений, +пока сервер не подтвердит получение сообщения или не истечёт время ожидания сообщения."> @@ -3715,8 +3714,8 @@ local: { зашифрованными полезными нагрузками. - Опция применяется и может быть указана только тогда, когда - опция algorithm равна + Опция применяется и указывается только при равенстве + значения опции algorithm значению константы MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED или MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. @@ -3758,8 +3757,8 @@ local: { MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE - Опция применяется и может быть указана только тогда, когда - опция algorithm равна + Опция применяется и указывается только при равенстве + значения опции algorithm значению константы MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED или MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE. @@ -3969,11 +3968,11 @@ local: { - Документы BSON технически могут содержать повторяющиеся ключи, поскольку документы хранятся в виде списка пар ключ-значение; + Документы BSON технически поддерживают повторяющиеся ключи, поскольку документы хранятся в виде списка пар ключ-значение; однако приложениям следует воздерживаться от создания документов с дубликатами ключей, - поскольку поведение сервера и драйвера может быть неопределённым. - Поскольку объекты и массивы PHP не могут иметь повторяющихся ключей, - данные также могут быть потеряны при декодировании документа BSON с повторяющимися ключами. + поскольку поведение сервера и драйвера иногда остаётся неопределённым. + При декодировании BSON-документа с повторяющимися ключами данные иногда теряются, + поскольку объекты и массивы в PHP не поддерживают повторных ключей. '> @@ -4993,11 +4992,11 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была - Стандартный CA пакет может быть переопределён глобально с помощью - установки или openssl.cafile или openssl.capath строк конфигурации, - или же на уровне каждого запроса используя опции контекста - cafile или - capath. + Стандартный CA-пакет переопределяется глобально — + через директиву openssl.cafile или openssl.capath — + лиоб на уровне каждого запроса через опции контекста + cafile + или capath. diff --git a/reference/filter/functions/filter-has-var.xml b/reference/filter/functions/filter-has-var.xml index 51efd38c60..b6db403508 100644 --- a/reference/filter/functions/filter-has-var.xml +++ b/reference/filter/functions/filter-has-var.xml @@ -1,10 +1,10 @@ - + filter_has_var - Проверяет, содержит ли суперглобальный массив заданного типа переменную с конкретным названием + Проверяет, содержится ли ключ в сыром суперглобальном массиве &reftitle.description; @@ -32,7 +32,7 @@ var_name - Название переменной для проверки. + Ключ для проверки. @@ -45,6 +45,40 @@ + + &reftitle.errors; + + Функция выбрасывает ошибку ValueError, + если значение параметра input_type + не совпадает со значениями констант семейства INPUT_*. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Функция теперь выбрасывает ошибку ValueError, + если значение параметра input_type не совпадает со значениями констант + семейства INPUT_*; + раньше возвращалось &false;. + + + + + + + + filter_input_array - Получает несколько переменных извне PHP и, при необходимости, фильтрует их + Извлекает элементы из сырого суперглобального массива и фильтрует значения &reftitle.description; @@ -15,8 +15,8 @@ booladd_empty&true; - Эта функция полезна для получения множества переменных без - многократного вызова функции filter_input. + Функция извлекает набор элементов + вместо многократного вызова функции filter_input. @@ -26,128 +26,219 @@ type - Одна из констант INPUT_*. + Константа семейства INPUT_*. - Содержимое фильтруемых суперглобальных переменных – это исходное «сырое» содержимое, - предоставленное SAPI, до внесения пользователем каких-либо изменений - в суперглобальные переменные. - Для фильтрации изменённого суперглобального содержимого - используйте функцию filter_var_array. + Функция фильтрует только «сырые» значения, + которыми SAPI заполняет суперглобальные массивы исходно. + Новые и изменённые значения суперглобальных массивов + фильтруют функцией filter_var_array. - - - - - - + + &reftitle.returnvalues; - В случае успешного выполнения, функция возвращает массив (&array;), - содержащий значения запрошенных переменных. + Функция возвращает массив (&array;) запрошенных элементов, + если выполнилась успешно. - Функция возвращает значение &false; в случае возникновения ошибки. - Если входной массив, определяемый параметром type, не заполнен, - функция вернёт значение &null;, если флаг FILTER_NULL_ON_FAILURE - не задан. + При ошибке функция возвращает &false;. + Функция возвращает &null;, + если обозначенный параметром type входной массив + не заполнен. - Недостающие записи входного массива будут заполнены в возвращаемый массив (&array;), - если значение параметра add_empty равно &true;. - В этом случае отсутствующим записям будем присвоено значение &null;, - если только не используется флаг FILTER_NULL_ON_FAILURE, - в этом случае записям будет присвоено значение &false;. + Недостающие элементы входного массива функция добавляет в возвращаемый массив (&array;) + как элементы со значением &null;, если значение параметра add_empty + равно &true;, и игнорирует, если для третьего параметра установили &false;. + В отличие от функции filter_input, + флаг FILTER_NULL_ON_FAILURE не изменяет поведение функции + и не заставляет добавлять элемент со значением &null; для недостающих элементов. - Элемент возвращаемого массива (&array;) будет &false;, - если фильтр не сработал, если только не используется флаг FILTER_NULL_ON_FAILURE, - в этом случае он будет &null;. + В элемент возвращаемого массива (&array;) запишется значение &false;, + если значение элемента не прошло фильтр, если только не установили флаг FILTER_NULL_ON_FAILURE, + который заставит добавить для элемента значение &null;. + При установке флага FILTER_FORCE_ARRAY функция оборачивает результат + провала фильтрации в одноэлементный массив, как и остальные результаты. + + + + &reftitle.errors; + + Функция выбрасывает ошибку ValueError, + если значение параметра type + не совпадает со значениями констант семейства INPUT_*. + + + Функция выбрасывает ошибку TypeError, + если обозначенный параметром type входной массив заполнен, + а в параметр options передали массив (&array;) + с нестроковым (&string;) ключом, + и ошибку ValueError, + если массив опций содержит пустой ключ. + + + Начиная с PHP 8.5.0 функция выбрасывает исключение + Filter\FilterFailedException, + если для элемента входного массива + установили флаг FILTER_THROW_ON_FAILURE + и значение не прошло фильтр, + и ошибку ValueError, + если для такого элемента флаг FILTER_THROW_ON_FAILURE указали вместе + с флагом FILTER_NULL_ON_FAILURE. + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Функция теперь выбрасывает ошибку ValueError, + если значение параметра type не совпадает со значениями + констант семейства INPUT_*; + раньше входной массив обрабатывался как незаполненный. + + + + 8.0.0 + + Функция выбрасывает ошибку TypeError, + если обозначенный параметром type входной массив заполнен, + а в массиве options передали массив + с нестроковым (&string;) ключом, + и ошибку ValueError, + если массив опций содержит пустой ключ; раньше выдавалось предупреждение + E_WARNING и возвращалось значение &false;. + + + + + &reftitle.examples; - Пример использования <function>filter_input_array</function> + Пример фильтрации входных данных функцией <function>filter_input_array</function> + + Пример фильтрует аргументы GET-запроса + ?email=user@example.com&age=twenty&url=https://example.com. + Элемент age не проходит фильтр, + поскольку значение twenty не относится к целочисленным; + значение за пределами диапазона от 1 до 120 тоже не прошло бы фильтрацию. + 'libgd