1
0
mirror of https://github.com/php/doc-uk.git synced 2026-03-23 22:52:14 +01:00
Files
archived-doc-uk/language-snippets.ent

5585 lines
273 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: mproshchuk Status: ready -->
<!ENTITY installation.enabled.disable
'Це розширення початково увімкнено. Для вимкнення застосовується наступна опція
під час компіляції: '>
<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed
'<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>
Генератор випадкових чисел ініціалізується автоматично.</entry></row>'>
<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis> в PHP 5.3.0. Вкрай не рекомендується на нього
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis> в PHP 5.3.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure
'<caution xmlns="http://docbook.org/ns/docbook">
<para>
Ця функція не генерує криптографічно безпечні значення, тож <emphasis>не
повинна</emphasis> використовуватись для криптографічних цілей чи тих, що
вимагають використання непередбачуваних значень.
</para>
<para>
Якщо потрібна криптографічно безпечна випадковість, можна використати
<classname>Random\Randomizer</classname> разом з рушієм
<classname>Random\Engine\Secure</classname>. Для простих випадків є функції
<function>random_int</function> і <function>random_bytes</function>, які
забезпечують зручний і безпечний <acronym>API</acronym> до системного
<acronym>CSPRNG</acronym>.
</para>
</caution>'>
<!ENTITY caution.mt19937-tiny-seed
'<caution xmlns="http://docbook.org/ns/docbook">
<para>
Оскільки рушій Mt19937 (“Mersenne Twister”) приймає тільки одне 32-бітне ціле
число як сід, кількість можливих випадкових послідовностей обмежена до лише
2<superscript>32</superscript> (тобто 4ʼ294ʼ967ʼ296), не зважаючи на
величезний період Mt19937 у 2<superscript>19937</superscript>-1.
</para>
<para>
Якщо покладатися на неявний чи явний випадковий сід, дуплікати зʼявляться
набагато швидше. Однакові сіди очікуються з імовірністю у 50&#37; менше ніж
через 80ʼ000 випадково згенерованих сідів, відповідно до парадоксу днів
народжень. Імовірність у 10&#37; настає після 30ʼ000 сідів, згенерованих
випадковим чином.
</para>
<para>
Через це Mt19937 непридатний для застосунків, де повторювані послідовності не
повинні виникати з більш ніж незначною ймовірністю. Якщо потрібне
відтворюване сідування, обидва рушії
<classname>Random\Engine\Xoshiro256StarStar</classname> і
<classname>Random\Engine\PcgOneseq128XslRr64</classname> підтримують набагато
довші сіди, які навряд випадково співпадуть. Якщо відтворюваність не потрібна,
то для цього є рушій <classname>Random\Engine\Secure</classname>, який надає
криптографічно безпечну випадковість.
</para>
</caution>'>
<!-- Notes -->
<!ENTITY note.bin-safe
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція є бінарно
безпечною.</simpara></note>'>
<!ENTITY note.clearstatcache
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Рузультати цієї функції
кешуються. Докладніше: <function>clearstatcache</function>.</simpara></note>'>
<!ENTITY note.context-support
'<para xmlns="http://docbook.org/ns/docbook"><type>resource</type>
<link linkend="stream.contexts">контекст потоку</link>.</para>'>
<!ENTITY note.exec-bg
'<note xmlns="http://docbook.org/ns/docbook"><para>Якщо програма запускається за
допомогою цієї функції, то для продовження роботи у фоновому режимі її вивід
повинен спрямовуватись у файл або інший вихідний потік. Недотримання цієї умови
змусить PHP виконувати програму до її завершення.</para></note>'>
<!ENTITY note.exec-bypass-shell
'<note xmlns="http://docbook.org/ns/docbook"><para>У Windows
<function>exec</function> спершу запуститься cmd.exe, щоб виконати команду. Для
запуску зовнішньої програми без участі cmd.exe використовується
<function>proc_open</function> з опцією
<parameter>bypass_shell</parameter>.</para></note>'>
<!ENTITY note.extractto-windows
'<note xmlns="http://docbook.org/ns/docbook"><para>Файлові системи Windows NTFS
не підтримують використання деяких символів у назвах файлів, а саме
<literal>&lt;|&gt;*?":</literal>. Не підтримуються також назви файлів з крапкою
в кінці. На відміну від деяких інструментів розпакування, цей метод не замінює
ці символи на підкреслення, а натомість не витягує такі файли.</para></note>'>
<!ENTITY note.func-callback
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Замість назви функції,
можна передавати масив, що містить посилання на обʼєкт та назву
метода.</simpara></note>'>
<!ENTITY note.func-callback-exceptions
'<note xmlns="http://docbook.org/ns/docbook"><para>Зворотні виклики,
зареєстровані через функції <function>call_user_func</function> і
<function>call_user_func_array</function>, не будуть викликатись при наявності
неспійманих винятків, викинутих в попередніх зворотніх викликах.</para></note>'>
<!ENTITY note.funcbyref
'<note xmlns="http://docbook.org/ns/docbook"><para>Якщо параметри передаються
за посиланням, то будь-які зміни їхніх значень буде відображено у значеннях,
які повертає ця функція. Починаючи з PHP 7, поточні значення також буде
повернено, якщо параметри передано за значенням.</para></note>'>
<!ENTITY note.funcnoparam
'<note xmlns="http://docbook.org/ns/docbook"><para>Оскільки для визначення
параметрів цієї функції потрібен контекст виконання, її не можна передавати як
параметр функції у версіях PHP, раніших за 5.3.0. Якщо функцію все ж треба
передати, то спочатку її необхідно призначити змінній, яку вже потім можна
передавати.</para></note>'>
<!ENTITY note.func-named-params
'<note xmlns="http://docbook.org/ns/docbook"><para>Починаючи з PHP 8.0.0,
сімейство функцій func_*() стало більш прозорим щодо названих параметрів,
обробляючи їх так, ніби всі передані позиційно, а пропущеним аргументам
призначаються стандартні значення. Ця функція ігнорує набір невідомих названих
варіативних параметрів. Набір невідомих названих параметрів доступний через
варіативний параметр.</para></note>'>
<!ENTITY note.line-endings
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Якщо виникають проблеми з
розпізнаванням закінчення рядків під час читання чи створення файлів на
компʼютері Macintosh, може допомогти застосування директиви <link
linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link> під час
виконання.</simpara></note>'>
<!ENTITY note.no-remote
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція незастосовна
для роботи з <link linkend="features.remote-files">віддаленими файлами</link>,
оскільки файл повинен бути доступним через файлову систему
сервера.</simpara></note>'>
<!ENTITY note.not-bin-safe
'<warning xmlns="http://docbook.org/ns/docbook"><simpara> Ця функція (поки-що)
не є безпечною для двійкових даних!</simpara></warning>'>
<!ENTITY note.no-key-association
'<note xmlns="http://docbook.org/ns/docbook"><simpara> Ця функція призначає нові
ключі для елементів в масиві <parameter>array</parameter>. Вона видаляє
будь-які наявні ключі, а не просто перевпорядковує їх.</simpara></note>'>
<!ENTITY note.no-windows
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Для Windows-платформ ця
функція нереалізована.</simpara></note>'>
<!ENTITY note.no-windows.extension
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Для Windows-платформ це
розширення недоступне.</simpara></note>'>
<!ENTITY note.no-zts
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція не доступна в
інтерпретаторі PHP, зібраному з увімкненою ZTS (Безпека потоку Zend). Щоб
перевірити, чи увімкнена ZTS, виконується команда <command>php -i</command> або
перевіряється вбудована константа <constant>PHP_ZTS</constant>.</simpara></note>'>
<!ENTITY note.randomseed
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Не потрібно
ініціалізазувати генератор випадкових чисел функціями <function>srand</function>
або <function>mt_srand</function>, оскільки це відбувається автоматично.
</simpara></note>'>
<!ENTITY note.is-superglobal
'<note xmlns="http://docbook.org/ns/docbook"><para>Це "суперглобальна" або
автоматична глобальна змінна. Тобто ця змінна доступна будь-де в скрипті та її
не потрібно оголошувати як <command>global $variable;</command>, щоб отримати
доступ до неї всередині функції чи метода.
</para></note>'>
<!ENTITY note.uses-ob
'<note xmlns="http://docbook.org/ns/docbook"><para>Якщо передано аргумент
<parameter>return</parameter>, ця функція застосовує внутрішній буфер виводу,
тож вона не може використовуватись всередині функції зворотнього виклику
<function>ob_start</function>.</para></note>'>
<!ENTITY note.uses-ob-php70
'<note xmlns="http://docbook.org/ns/docbook"><para> До PHP 7.1.0, якщо передано
аргумент <parameter>return</parameter>, ця функція застосовує внутрішній буфер
виводу, тож вона не може використовуватись всередині функції зворотнього виклику
<function>ob_start</function>.</para></note>'>
<!ENTITY note.filesystem-time-res
'<note xmlns="http://docbook.org/ns/docbook"><para>Варто зауважити, що точність
часових міток у різних файлових систем може бути різна.</para></note>'>
<!ENTITY note.uses-autoload
'<note xmlns="http://docbook.org/ns/docbook"><para>Ця функція буде
використовувати будь-який зареєстрований <link
linkend="language.oop5.autoload">автозавантажувач</link>, якщо клас ще не
відомий.</para></note>'>
<!ENTITY note.network.header.sapi
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Заголовки будуть доступні та виводитимуться, тільки якщо використовується
SAPI, який їх підтримує.
</para>
</note>
'>
<!ENTITY note.sigchild
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Якщо PHP скомпільовано з --enable-sigchild, значення, що повертається цією
функцією, не визначене.
</para>
</note>
'>
<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
<para>
Якщо два члени порівняння однакові, їхній порядок зберігається. До PHP 8.0.0,
їхній відносний порядок у впорядкованому масиві був невизначеним.
</para>
</note>
'>
<!ENTITY note.reset-index
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Скидає внутрішній вказівник масиву на перший елемент.
</para>
</note>
'>
<!ENTITY note.resource-migration-8.0-dead-function
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Ця функція ні на що не впливає. До PHP 8.0.0, вона використовувалася для
закриття ресурсу.
</para>
</note>
'>
<!-- Tips -->
<!ENTITY tip.fopen-wrapper
'<tip xmlns="http://docbook.org/ns/docbook"><simpara>URL як назву файлу можна
використовувати з цією функцією, якщо ввімкнені <link
linkend="ini.allow-url-fopen">обгортки fopen</link>. Докладніше про те, як
вказати назву файлу: <function>fopen</function>. На сторінці <xref
linkend="wrappers"/> є посилання на інформацію про можливості різних обгорток,
примітки щодо їхнього використання, інформацію про будь-які попередньо визначені
цими обгортками змінні.</simpara></tip>'>
<!ENTITY tip.fopen-wrapper.stat
'<tip xmlns="http://docbook.org/ns/docbook"><simpara>Починаючи з PHP 5.0.0, ця
функція також може бути використана з <emphasis>деякими</emphasis>
URL-обгортками. На сторінці <xref linkend="wrappers"/> вказано, які обгортки
підтримують сімейство функцій <function>stat</function>.</simpara></tip>'>
<!ENTITY tip.ob-capture
'<tip xmlns="http://docbook.org/ns/docbook"><simpara>Як і для будь-чого, що
виводить свій результат прямо в браузер, можна використовувати <link
linkend="book.outcontrol">функції контролю виводу</link> для перехоплення виводу
даних цією функцією, та збереження їх, наприклад, у вигляді рядка
(<type>string</type>).</simpara></tip>'>
<!ENTITY tip.userlandnaming
'<tip xmlns="http://docbook.org/ns/docbook"><simpara>Див. <xref
linkend="userlandnaming" />.</simpara></tip>'>
<!-- Warnings -->
<!ENTITY warn.escapeshell
'<warning xmlns="http://docbook.org/ns/docbook"><para>Варто застосувати
<function>escapeshellarg</function> або <function>escapeshellcmd</function> до
даних, введених користувачами, щоб гарантувати, що користувачі не зможуть
обманом змусити систему виконати довільні команди.</para></warning>'>
<!ENTITY warn.experimental
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Це розширення —
<emphasis>ЕКСПЕРИМЕНТАЛЬНЕ</emphasis>. Його поведінка, назви функцій та
документація можуть бути змінені без попередження в майбутніх випусках PHP.
Використання цього розширення є ризикованим для розробника.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.3.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 5.4.0.</simpara></warning>'>
<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 5.4.0.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-5-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.5.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-6-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.6.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.0.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-1-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.1.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-1-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.1.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.0.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 8.0.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.1.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.2.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-2-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.2.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.2.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 8.0.0. Вкрай не рекомендується на нього
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-2-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.2.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.2.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 8.0.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.3.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.3.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.3.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 8.0.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-7-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.4.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.4.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.4.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 8.0.0. Вкрай не рекомендується на неї
покладатися.</simpara></warning>'>
<!ENTITY warn.feature.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 8.0.0.</simpara>
</warning>'>
<!ENTITY warn.deprecated.function-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.0.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-8-1-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.1.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-8-2-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.2.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-8-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 8.3.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-8-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.3.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 8.4.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.function-8-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.4.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY removed.php.future
'Цей застарілий функціонал буде <emphasis
xmlns="http://docbook.org/ns/docbook">обов&apos;язково</emphasis>
<emphasis xmlns="http://docbook.org/ns/docbook">видалено</emphasis> у
майбутньому.'>
<!ENTITY warn.deprecated.function.removed-5-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis> та <emphasis>ВИЛУЧЕНА</emphasis> в PHP
5.3.0.</simpara></warning>'>
<!ENTITY warn.deprecated.function.removed-5-5-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis> та <emphasis>ВИЛУЧЕНА</emphasis> в PHP
5.5.0.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-5-3-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.3.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.func-5-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.4.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-5-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.4.0. Вкрай не рекомендується на
нього покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.func-5-5-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.5.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.5.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.5.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 4.1.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей функціонал
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.6.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.removed.function-7-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>
<!ENTITY warn.removed.function-7-4-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.4.0.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.2.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 8.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.4.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 8.0.0.</simpara></warning>'>
<!ENTITY warn.deprecated.alias-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 8.0.0.</simpara></warning>'>
<!ENTITY warn.removed.alias-8-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Цей псевдонім
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 8.0.0.</simpara></warning>'>
<!ENTITY warn.experimental.func
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція —
<emphasis>ЕКСПЕРИМЕНТАЛЬНА</emphasis>. Її поведінка, назва та документація
можуть бути змінені без попередження в майбутніх випусках PHP. Використання цієї
функції є ризикованим для розробника.</simpara></warning>'>
<!ENTITY warn.imaprecodeyaz
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Розширення <link
linkend="book.imap">IMAP</link>, <link linkend="book.recode">recode</link> та
<link linkend="book.yaz">YAZ</link> не можна використовувати разом тому, що вони
використовують однакові внутнішні символи. Примітка: Версія Yaz 2.0 та новіші
цієї проблеми не мають.</simpara></warning>'>
<!ENTITY warn.install.cgi
'<warning xmlns="http://docbook.org/ns/docbook"><para>Використання сервера в
CGI-режимі робить його вразливим до деяких атак. В розділі <link
linkend="security.cgi-bin">Безпека CGI</link> описано, як захиститися від
них.</para></warning>'>
<!ENTITY warn.passwordhashing
'<warning xmlns="http://docbook.org/ns/docbook">
<para>
Не рекомендовано використовувати цю функцію для захисту паролів через її
швидкий алгоритм гешування. Докладніше: <link
linkend="faq.passwords.fasthash">ЧаПи щодо гешування паролів</link>.
</para>
</warning>
'>
<!ENTITY warn.ssl-non-standard
'<warning xmlns="http://docbook.org/ns/docbook"><para>Якщо використовувати SSL,
Microsoft IIS порушуватиме протокол, закриваючи зʼєднання без надсилання
індикатора <literal>close_notify</literal>. Коли буде досягнуто кінця даних, PHP
повідомлятиме: "SSL: Fatal Protocol Error". Щоб обійти це, значення <link
linkend="ini.error-reporting">error_reporting</link> має бути знижене до рівня,
який не включає попереджень. PHP може виявити несправне програмне забезпечення
сервера IIS та приховати попередження, якщо відкривати потік за допомогою
обгортки <literal>https://</literal>. Якщо розробник використовує
<function>fsockopen</function> для створення сокета <literal>ssl://</literal>,
то він сам має виявляти та приховувати це попередження.</para></warning>'>
<!ENTITY warn.undocumented.class
'<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
Наразі цей клас не документований. Доступний лише список його властивостей і
методів.
</simpara>
</warning>
'>
<!ENTITY warn.undocumented.func
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Наразі ця функція не
документована. Доступний лише список її параметрів.
</simpara></warning>'>
<!-- Deprecation and removal warnings designed for use with a list of
alternatives. See en/reference/regex/functions/ereg.xml and
en/reference/regex/reference.xml for examples of these in action. -->
<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Ця функція <emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 4.1.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Цей функціонал <emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Його можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Ця функція <emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.3.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Ця функція <emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 5.5.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!ENTITY warn.removed.feature.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Цей функціонал <emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Його можна замінити на:
</para>
'>
<!ENTITY warn.removed.function.7-0-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Ця функція <emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Цей функціонал <emphasis>ЗАСТАРІВ</emphasis>, починаючи з PHP 7.1.0, та
<emphasis>ВИЛУЧЕНИЙ</emphasis> в PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Його можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives
'<para xmlns="http://docbook.org/ns/docbook">
Ця функція <emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.1.0, та
<emphasis>ВИЛУЧЕНА</emphasis> в PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!ENTITY warn.deprecated.function-8-1-0.alternatives
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 8.1.0. Вкрай не рекомендується
на неї покладатися.</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
Її можна замінити на:
</para>
'>
<!-- Misc -->
<!ENTITY version.exists.asof 'Існує, починаючи з PHP '>
<!ENTITY version.trunk.changelog 'В майбутньому'>
<!ENTITY no.function.parameters
'<para xmlns="http://docbook.org/ns/docbook">У цієї функції немає
параметрів.</para>'>
<!ENTITY example.outputs
'<para xmlns="http://docbook.org/ns/docbook">Поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.5
'<para xmlns="http://docbook.org/ns/docbook">В PHP 5 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.53
'<para xmlns="http://docbook.org/ns/docbook">В PHP 5.3 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.54
'<para xmlns="http://docbook.org/ns/docbook">В PHP 5.4 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.55
'<para xmlns="http://docbook.org/ns/docbook">В PHP 5.5 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.56
'<para xmlns="http://docbook.org/ns/docbook">В PHP 5.6 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.7
'<para xmlns="http://docbook.org/ns/docbook">В PHP 7 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.70
'<para xmlns="http://docbook.org/ns/docbook">В PHP 7.0 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.71
'<para xmlns="http://docbook.org/ns/docbook">В PHP 7.1 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.72
'<para xmlns="http://docbook.org/ns/docbook">В PHP 7.2 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.73
'<para xmlns="http://docbook.org/ns/docbook">В PHP 7.3 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.8
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.8.similar
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8 поданий вище приклад
виведе щось схоже на:</para>'>
<!ENTITY example.outputs.80
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.0 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.81
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.1 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.82
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.2 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.82.similar
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.2 поданий вище приклад
виведе щось схоже на:</para>'>
<!ENTITY example.outputs.83
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.3 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.83.similar
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.3 поданий вище приклад
виведе щось схоже на:</para>'>
<!ENTITY example.outputs.84
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.4 поданий вище приклад
виведе:</para>'>
<!ENTITY example.outputs.84.similar
'<para xmlns="http://docbook.org/ns/docbook">В PHP 8.4 поданий вище приклад
виведе щось схоже на:</para>'>
<!ENTITY example.outputs.32bit
'<para xmlns="http://docbook.org/ns/docbook">На 32-бітних машинах поданий вище
приклад виведе:</para>'>
<!ENTITY example.outputs.64bit
'<para xmlns="http://docbook.org/ns/docbook">На 64-бітних машинах поданий вище
приклад виведе:</para>'>
<!ENTITY example.outputs.similar
'<para xmlns="http://docbook.org/ns/docbook">Поданий вище приклад виведе щось
схоже на:</para>'>
<!ENTITY examples.outputs
'<para xmlns="http://docbook.org/ns/docbook">Подані вище приклади
виведуть:</para>'>
<!ENTITY examples.outputs.32bit
'<para xmlns="http://docbook.org/ns/docbook">На 32-бітних машинах подані вище
приклади виведуть:</para>'>
<!ENTITY examples.outputs.64bit
'<para xmlns="http://docbook.org/ns/docbook">На 64-бітних машинах подані вище
приклади виведуть:</para>'>
<!ENTITY examples.outputs.similar
'<para xmlns="http://docbook.org/ns/docbook">Подані вище приклади виведуть
щось схоже на:</para>'>
<!ENTITY array.resetspointer
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<function>скидатиме</function> вказівник <type>array</type> вхідного масиву
після використання.</simpara></note>'>
<!ENTITY array.changelog.by-ref
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер функція видасть <constant>E_WARNING</constant>, якщо
<parameter>callback</parameter> очікує параметр за посиланням.
</entry>
</row>'>
<!ENTITY array.changelog.require-only-one
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер ця функція може викликатись лише з одним параметром. Раніше потрібні
були щонайменше два.
</entry>
</row>'>
<!ENTITY seealso.array.sorting
'<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">Порівняння
функцій, що впорядкувують масиви</link>'>
<!ENTITY sort.flags.parameter
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
<para>
Необов&apos;язковий другий параметр <parameter>flags</parameter> можна
використовувати для зміни способу впорядкування, вказавши значення:
</para>
<para>
Прапорці типу впорядкування:
<itemizedlist>
<listitem>
<simpara><constant>SORT_REGULAR</constant> — звичайне порівняння
елементів. Докладніше у розділі <link
linkend="language.operators.comparison">Оператори
порівняння</link></simpara>
</listitem>
<listitem>
<simpara><constant>SORT_NUMERIC</constant> — числове порівняння
елементів</simpara>
</listitem>
<listitem>
<simpara><constant>SORT_STRING</constant> — рядкове порівняння
елементів</simpara>
</listitem>
<listitem>
<simpara>
<constant>SORT_LOCALE_STRING</constant> — рядкове порівняння елементів,
відповідно до поточної локалізації. Використовується локалізація, котру
можна змінити за допомогою <function>setlocale</function>
</simpara>
</listitem>
<listitem>
<simpara>
<constant>SORT_NATURAL</constant> — "природнє" рядкове порівняння, як у
<function>natsort</function>
</simpara>
</listitem>
<listitem>
<simpara>
<constant>SORT_FLAG_CASE</constant> — можна поєднати (побітове АБО) з
<constant>SORT_STRING</constant> або <constant>SORT_NATURAL</constant>
для впорядкування рядків без урахування регістру
</simpara>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
'>
<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
&return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
<para>
Якщо функція порівняння повертає <emphasis>не цілі</emphasis> значення, такі
як <type>float</type>, вони будуть приведені до типу <type>int</type> під час
повернення з функції зворотнього виклику. Тож значення, схожі на
<literal>0.99</literal> або <literal>0.1</literal> будуть приведені до цілого
<literal>0</literal>, отже члени порівняння вважатимуться однаковими.
</para>
</caution>'>
<!ENTITY sort.callback.description.presort
'<caution xmlns="http://docbook.org/ns/docbook">
<para>
Сортувальна функція зворотнього виклику повинна опрацьовувати будь-яке
значення з будь-якого масиву у будь-якій послідовності, не залежно від їхнього
початкового порядку. Це тому, що кожен масив впорядковується перед порівнянням
його з іншими масивами. Наприклад:
<programlisting role="php">
<![CDATA[
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 та $item2 можуть бути "string", 1 чи ["value" => 1]
$compareFunc = static function ($item1, $item2) {
$value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
$value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
return $value1 <=> $value2;
};
?>
]]>
</programlisting>
</para>
</caution>'>
<!ENTITY ini.shorthandbytes
'<simpara xmlns="http://docbook.org/ns/docbook">Коли використовується
<type>int</type>, значення вимірюється в байтах. Також можна робити скорочений
запис, як це описано в <link linkend="faq.using.shorthandbytes">цих
ЧаПах</link>.
</simpara>'>
<!ENTITY info.deprecated.alias
'Для зворотньої сумісності, можна використовувати такий застарілий псевдонім: '>
<!ENTITY info.function.alias 'Ця функція є псевдонімом до: '>
<!ENTITY info.method.alias 'Цей метод є псевдонімом до: '>
<!ENTITY info.function.alias.deprecated
'<simpara xmlns="http://docbook.org/ns/docbook">Цей псевдонім функції є
застарілим та існує тільки для зворотньої сумісності. Не рекомендується його
використовувати, оскільки він може бути вилучений з PHP в майбутньому.
</simpara>'>
<!ENTITY ext.windows.path.dll
'Щоб це розширення працювало у Windows, системна змінна <envar
xmlns="http://docbook.org/ns/docbook">PATH</envar> повинна мати доступ до файлів
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>. Як це зробити,
написано в <acronym xmlns="http://docbook.org/ns/docbook">ЧаПах</acronym> під
назвою "<link xmlns="http://docbook.org/ns/docbook"
linkend="faq.installation.addtopath">Як додати PHP-теку до PATH у
Windows</link>". Хоча копіювання DLL-файлів з PHP-теки в системну теку Windows
теж спрацює (тому, що системна тека зазвичай є в змінній <envar
xmlns="http://docbook.org/ns/docbook">PATH</envar>), проте цього не слід робити.
<emphasis xmlns="http://docbook.org/ns/docbook">Це розширення вимагає, щоб
наступні файли були в <envar>PATH</envar>:</emphasis> '>
<!ENTITY manual.migration.seealso 'Див. також керівництво з переходу на версії PHP'>
<!ENTITY style.oop 'Об&apos;єктно-орієнтований стиль'>
<!ENTITY style.procedural 'Процедурний стиль'>
<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">resource</link>'>
<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>
<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>
<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>
<!ENTITY parameter.context
'У розділі посібника <link xmlns="http://docbook.org/ns/docbook"
linkend="context">контекст</link> міститься опис <literal
xmlns="http://docbook.org/ns/docbook">контекстів</literal>.'>
<!ENTITY parameter.use_include_path
'Коли встановлено &true;, пошук назви файлу також здійснюється в середині <link
xmlns="http://docbook.org/ns/docbook"
linkend="ini.include-path">include_path</link>'>
<!-- Returns -->
<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.2.0</entry>
<entry>
Тепер повертається значення типу &true;. До цього був <type>bool</type>.
</entry>
</row>'>
<!ENTITY return.falseforfailure ' або &false; в разі помилки'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; повертає &false; в разі помилки.'>
<!ENTITY return.success 'Повертає &true; у разі успіху&return.falseforfailure;.'>
<!ENTITY return.nullorfalse 'Повертає &null; у разі успіху&return.falseforfailure;.'>
<!ENTITY return.void 'Не повертає значень.'>
<!ENTITY return.true.always 'Завжди повертає &true;.'>
<!ENTITY return.callbacksort
'Порівняльна функція має повертати ціле число, котре менше, рівне або більше
нуля, якщо перший параметр вважається відповідно меншим, рівним або більшим за
другий.'>
<!ENTITY return.falseproblem
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція може
повертати як логічне &false;, так і не логічне значення, яке прирівнюється до
&false;. Докладніше про це описано в розділі <link
linkend="language.types.boolean">Логічні типи даних</link>. Для перевірки
значення, яке повертає ця функція, використовується <link
linkend="language.operators.comparison">оператор ===</link>.</simpara></warning>'>
<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Виклик цієї функції для об&apos;єктів є застарілим. Краще перетворити &object;
в &array;, застосувавши <function>get_mangled_object_vars</function>, або
використати методи класу, який імплементує
<interfacename>Iterator</interfacename>, наприклад
<classname>ArrayIterator</classname>.
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>7.4.0</entry>
<entry>
Примірники класів <link xmlns="http://docbook.org/ns/docbook"
linkend="book.spl">SPL</link> тепер розглядаються як порожні об&apos;єкти, які
не мають властивостей, замість виклику метода інтерфейсу
<interfacename>Iterator</interfacename> з такою ж назвою, як і в цієї функції.
</entry>
</row>
'>
<!ENTITY standard.changelog.binary-safe-string-comparison
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.2.0</entry>
<entry>
Тепер ця функція повертає <literal>-1</literal> або <literal>1</literal>, а не
від&apos;ємне або додатнє число, як раніше.
</entry>
</row>
'>
<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>finfo</classname>, що повертається функцією
<function>finfo_open</function>.</para>'>
<!ENTITY fileinfo.changelog.finfo-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>finfo</parameter> має бути примірником
<classname>finfo</classname>, а не &resource;, як раніше.
</entry>
</row>'>
<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>x509</parameter></term>
<listitem>
<para>
Список можливих значень є в параграфі <link
linkend="openssl.certparams">Параметри ключа/сертифіката</link>.
</para>
</listitem>
</varlistentry>'>
<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>csr</parameter></term>
<listitem>
<para>
Список можливих значень є в параграфі <link
linkend="openssl.certparams">Параметри CSR</link>.
</para>
</listitem>
</varlistentry>'>
<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>key</parameter></term>
<listitem>
<para>
Список можливих значень є в параграфі <link
linkend="openssl.certparams">Параметри публічного/приватного ключа</link>.
</para>
</listitem>
</varlistentry>'>
<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція доступна тільки,
якщо PHP скомпільовано з використанням <option
role="configure">--with-t1lib[=DIR]</option>.
</simpara></note>'>
<!ENTITY note.freetype
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція доступна тільки,
якщо PHP скомпільовано з підтримкою freetype (<option
role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>
<!ENTITY note.gd.notrequired
'<note xmlns="http://docbook.org/ns/docbook"><para>Ця функція не потребує
бібліотеки зображень GD.</para></note>'>
<!ENTITY note.gd.interpolation
'<note xmlns="http://docbook.org/ns/docbook"><para>На цю функцію впливає спосіб
інтерполяції, встановлений функцією
<function>imagesetinterpolation</function>.</para></note>'>
<!ENTITY gd.image.description
'<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>image</parameter></term><listitem><para>Об&apos;єкт
<classname>GdImage</classname>, що повертається однією з функцій створення
зображення, такою як
<function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>
<!ENTITY gd.font.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>font</parameter></term><listitem><para>Може бути 1, 2, 3, 4, 5 для
вбудованих шрифтів в кодуванні latin2 (де більші числа відповідають більшим
шрифтам) або примірником класу <classname>GdFont</classname>, що повертається
функцією <function>imageloadfont</function>.</para></listitem></varlistentry>'>
<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Параметром <parameter>font</parameter> тепер може бути як і примірник
<classname>GdFont</classname>, так і &integer;. Раніше допускався тільки
&integer;.
</entry>
</row>'>
<!ENTITY gd.ttf.fontfile "
<varlistentry xmlns='http://docbook.org/ns/docbook'>
<term><parameter>fontfile</parameter></term>
<listitem>
<para>
Спосіб використання обраного шрифту TrueType.
</para>
<para>
Залежно від версії бібліотеки GD, яку використовує PHP, <emphasis>якщо
<parameter>fontfile</parameter> не починається з <literal>/</literal>, то
до назви файлу буде дописано <literal>.ttf</literal></emphasis> і
бібліотека шукатиме цей файл у визначеній нею теці.
</para>
<para>
Використовуючи версії бібліотеки GD, раніші за 2.0.18, &quot;розділювачем
шляхів&quot; для декількох файлів шрифтів буде символ
<literal>пропуску</literal>, а не крапка з комою. Ненавмисне використання
цієї функції призведе до попередження: <literal>Warning: Could not
find/open font</literal>. Єдиним рішенням для цих пошкоджених версій є
переміщення файлу шрифту в шлях, що не містить в назві пропусків.
</para>
<para>
В багатьох випадках, коли шрифт знаходиться в тій самій теці, що і
скрипт, який використовує його, наступний трюк позбавить від будь-яких
проблем з його підключенням.
<programlisting role='php'>
<![CDATA[
<?php
// Встановити змінну середовища для GD
putenv('GDFONTPATH=' . realpath('.'));
// Назва шрифту, що буде використано (увага — відсутнє розширення .ttf)
$font = 'SomeFont';
?>
]]>
</programlisting>
</para>
<note>
<para>
Варто зауважити, що <link linkend='ini.open-basedir'>open_basedir</link>
<emphasis>не</emphasis> застосовується до
<parameter>fontfile</parameter>.
</para>
</note>
</listitem>
</varlistentry>
">
<!ENTITY gd.return.identifier 'Повертає об&apos;єкт зображення в разі успіху або &false; в разі помилок.'>
<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Проте, якщо libgd не може вивести зображення, ця функція повертає &true;.</simpara></caution>'>
<!ENTITY gd.identifier.color "Ідентифікатор кольору, створений за допомогою <function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function>.">
<!ENTITY gd.value.red 'Значення червоного компонента.'>
<!ENTITY gd.value.green 'Значення зеленого компонента.'>
<!ENTITY gd.value.blue 'Значення синього компонента.'>
<!ENTITY gd.source.height 'Висота початкового зображення.'>
<!ENTITY gd.source.width 'Ширина початкового зображення.'>
<!ENTITY gd.image.path 'Шлях або відкритий ресурс потоку (котрий автоматично закривається після повернення з цієї функції) для збереження файла. Якщо не встановлено або дорівнює &null;, буде виведено двійковий код зображення.'>
<!ENTITY gd.image.new 'Створює нове зображення з файла або URL'>
<!ENTITY gd.image.source 'Ресурс початкового зображення.'>
<!ENTITY gd.image.destination 'Ресурс цільового зображення.'>
<!ENTITY gd.image.output 'Вивід зображення в браузер чи файл.'>
<!ENTITY gd.image.colors 'Якщо створено зображення з файлу, розпізнаються тільки кольори, які використовуються в зображенні. Кольори, присутні тільки в палітрі, не розпізнаються.'>
<!ENTITY gd.font.size 'Розмір шрифту в пунктах.'>
<!ENTITY gd.constants.types
'<simpara xmlns="http://docbook.org/ns/docbook">
Використовується, як значення, яке повертає функція
<function>imagetypes</function>
</simpara>'>
<!ENTITY gd.constants.color
'<simpara xmlns="http://docbook.org/ns/docbook">
Певний колір, що можна використати замість обраного функціями
<function>imagecolorallocate</function> або
<function>imagecolorallocatealpha</function>.
</simpara>'>
<!ENTITY gd.constants.affine
'<simpara xmlns="http://docbook.org/ns/docbook">
Константа типу афінного перетворення, яку використовує функція
<function>imageaffinematrixget</function>.
</simpara>'>
<!ENTITY gd.constants.arc
'<simpara xmlns="http://docbook.org/ns/docbook">
Константа стилю, яку використовує функція
<function>imagefilledarc</function>.
</simpara>'>
<!ENTITY gd.constants.gd2
'<simpara xmlns="http://docbook.org/ns/docbook">
Константа типу, яку використовує функція <function>imagegd2</function>.
</simpara>'>
<!ENTITY gd.constants.effect
'<simpara xmlns="http://docbook.org/ns/docbook">
Ефект альфа-змішування, який використовує функція
<function>imagelayereffect</function>.
</simpara>'>
<!ENTITY gd.constants.filter
'<simpara xmlns="http://docbook.org/ns/docbook">
Особливий GD-фільтр, який використовує функція
<function>imagefilter</function>.
</simpara>'>
<!ENTITY gd.constants.type
'<simpara xmlns="http://docbook.org/ns/docbook">
Константа типу зображення, яку використовують функції
<function>image_type_to_mime_type</function> та
<function>image_type_to_extension</function>.
</simpara>'>
<!ENTITY gd.constants.png-filter
'<simpara xmlns="http://docbook.org/ns/docbook">
Особливий PNG-фільтр, який використовує функція
<function>imagepng</function>.
</simpara>'>
<!ENTITY gd.constants.flip
'<simpara xmlns="http://docbook.org/ns/docbook">
Використовується разом з <function>imageflip</function>, доступна, починаючи з
PHP 5.5.0.
</simpara>'>
<!ENTITY gd.constants.interpolation
'<simpara xmlns="http://docbook.org/ns/docbook">
Використовується разом з <function>imagesetinterpolation</function>, доступна,
починаючи з PHP 5.5.0.
</simpara>'>
<!ENTITY gd.changlog.t1lib
'<row xmlns="http://docbook.org/ns/docbook">
<entry>7.0.0</entry><entry>PHP більше не підтримує T1Lib, тому ця функція була
вилучена.</entry>
</row>'>
<!ENTITY gd.deprecated.gd-formats
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Формати зображень GD та
GD2 є пропрієтарними форматами зображень libgd. Їх слід вважати
<emphasis>застарілими</emphasis>, а використовувати тільки з метою розробки та
тестування.</simpara></warning>'>
<!ENTITY gd.changelog.image-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер <parameter>image</parameter> має бути примірником
<classname>GdImage</classname>. Раніше очікувався
<literal>gd</literal>-<type>resource</type>.
</entry>
</row>'>
<!-- CSV -->
<!ENTITY warning.csv.escape-parameter
'<warning xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
Якщо значенням параметра <parameter>escape</parameter> не є порожній рядок
(<literal>""</literal>), то результатом може бути CSV, що не відповідає вимогам
<link xlink:href="&url.rfc;4180">RFC 4180</link> або не зможе оброблятись
функціями PHP CSV. Типовим значенням параметра <parameter>escape</parameter> є
<literal>"\\"</literal>, але рекомендовано явно вказати порожній рядок. Типове
значення зміниться в наступній версії PHP, та не раніше, ніж в PHP 9.0.
</simpara></warning>'>
<!-- DBM notes -->
<!ENTITY dbm.dbm-identifier.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>dbm_identifier</parameter></term><listitem><para>Ідентифікатор
посилання DBM, що його повертає функція
<function>dbmopen</function>.</para></listitem></varlistentry>'>
<!-- JSON notes -->
<!ENTITY json.implementation.superset '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<para>
PHP реалізує повний набір JSON, як визначено в стандарті <link
xlink:href="&url.rfc;7159">RFC 7159</link>.
</para>
</note>
'>
<!-- cURL notes -->
<!ENTITY curl.ch.description
'<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>ch</parameter></term>
<listitem><para>cURL-дескриптор, якого повертає
<function>curl_init</function>.</para></listitem></varlistentry>'>
<!ENTITY curl.mh.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mh</parameter></term><listitem><para>Мультидескриптор cURL, якого
повертає <function>curl_multi_init</function>.</para></listitem></varlistentry>'>
<!ENTITY curl.sh.description
'<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Спільний cURL-дескриптор, якого повертає
<function>curl_share_init</function>.</para></listitem></varlistentry>'>
<!ENTITY curl.changelog.handle-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>handle</parameter> тепер має бути примірником класу
<classname>CurlHandle</classname>; раніше очікувався <type>resource</type>.
</entry>
</row>'>
<!ENTITY curl.changelog.multi-handle-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>multi_handle</parameter> тепер має бути примірником класу
<classname>CurlMultiHandle</classname>; раніше очікувався
<type>resource</type>.
</entry>
</row>'>
<!ENTITY curl.changelog.share-handle-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>share_handle</parameter> тепер має бути примірником класу
<classname>CurlShareHandle</classname>; раніше очікувався
<type>resource</type>.
</entry>
</row>'>
<!-- dba notes -->
<!ENTITY dba.parameter.dba
'Примірник <classname
xmlns="http://docbook.org/ns/docbook">Dba\Connection</classname>, якого повертає
функція <function xmlns="http://docbook.org/ns/docbook">dba_open</function> або
<function xmlns="http://docbook.org/ns/docbook">dba_popen</function>.'>
<!ENTITY dba.changelog.dba-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
Тепер параметр <parameter>dba</parameter> має бути примірником
<classname>Dba\Connection</classname>. раніше очікувався дійсний
<literal>dba</literal> &resource;.
</entry>
</row>'>
<!-- dbase notes -->
<!ENTITY dbase.type-conversion
'<para xmlns="http://docbook.org/ns/docbook">
Кожне поле перетворюється у відповідний тип PHP, проте:
<itemizedlist>
<listitem>
<simpara>
Дати залишаються рядками.
</simpara>
</listitem>
<listitem>
<simpara>
Значення DateTime перетворюються в рядки.
</simpara>
</listitem>
<listitem>
<simpara>
Цілі числа за межами діапазону
<constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant>
повертаються, як рядки.
</simpara>
</listitem>
<listitem>
<simpara>
До dbase 7.0.0, логічні (<literal>L</literal>) перетворювалися на
<literal>1</literal> або <literal>0</literal>.
</simpara>
</listitem>
</itemizedlist>
</para>'>
<!-- enchant entities -->
<!ENTITY enchant.param.broker
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>broker</parameter></term>
<listitem>
<para>
Брокер Enchant, якого повертає <function>enchant_broker_init</function>.
</para>
</listitem>
</varlistentry>'>
<!ENTITY enchant.param.dictionary
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>dictionary</parameter></term>
<listitem>
<para>
Словник Enchant, якого повертає
<function>enchant_broker_request_dict</function> або
<function>enchant_broker_request_pwl_dict</function>.
</para>
</listitem>
</varlistentry>'>
<!ENTITY enchant.changelog.broker-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>broker</parameter> тепер має бути примірником класу
<classname>EnchantBroker</classname>; раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY enchant.changelog.dictionary-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>dictionary</parameter> тепер має бути примірником класу
<classname>EnchantDictionary</classname>; раніше очікувався &resource;.
</entry>
</row>'>
<!-- IMAP notes -->
<!ENTITY imap.changelog.imap-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>imap</parameter> має бути примірником
<classname>IMAP\Connection</classname>; раніше очікувався дійсний &resource;
<literal>imap</literal>.
</entry>
</row>'>
<!ENTITY imap.imap-parameter.imap
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Примірник
<classname>IMAP\Connection</classname>.</para></listitem></varlistentry>'>
<!-- Deprecated -->
<!ENTITY imap.imap-stream.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Потік IMAP, якого повертає
функція <function>imap_open</function>.</para></listitem></varlistentry>'>
<!ENTITY imap.pattern
'<para xmlns="http://docbook.org/ns/docbook">Визначає, де в ієрархії поштових
скриньок почати пошук.</para><para xmlns="http://docbook.org/ns/docbook">У
значенні параметру <parameter>pattern</parameter> можна використовувати два
спеціальні символи: "<literal>*</literal>" і
"<literal>&#37;</literal>". "<literal>*</literal>" —
повернути всі поштові скриньки. Якщо значення <parameter>pattern</parameter>
дорівнюватиме "<literal>*</literal>", то повернеться список усієї
ієрархії поштових скриньок. "<literal>&#37;</literal>" — повернути тільки
поточний рівень. Якщо значення <parameter>pattern</parameter>
дорівнюватиме "<literal>&#37;</literal>", то повернеться тільки верхній рівень
поштових скриньок; "<literal>~/mail/&#37;</literal>" на
<literal>UW_IMAPD</literal> поверне усі поштові скриньки в теці
<filename>~/mail</filename>, крім тих, що в її підтеках.</para>'>
<!ENTITY imap.mailboxname.insecure
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Передавати у цей параметр неперевірені дані <emphasis>небезпечно</emphasis>,
якщо увімкнено <link
linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link>.
</simpara></warning>'>
<!-- intl notes -->
<!ENTITY intl.parameter.intl-calendar
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>IntlCalendar</classname>.</para>'>
<!ENTITY intl.error.intl-calendar
'<para xmlns="http://docbook.org/ns/docbook">У разі помилки також повертається
&false;. Для визначення причини помилки використовується
<function>intl_get_error_code</function> або налаштовується Intl для викидання
<link linkend="ini.intl.use-exceptions">виключень</link>.</para>'>
<!ENTITY intl.codepoint.parameter
'<para xmlns="http://docbook.org/ns/docbook">Значення кодової точки типу
<type>int</type> (наприклад <literal>0x2603</literal> для <emphasis>U+2603
SNOWMAN</emphasis>) або символ UTF-8 типу <type>string</type> (напр.
<literal>"\u{2603}"</literal>)</para>'>
<!ENTITY intl.codepoint.return
'<para xmlns="http://docbook.org/ns/docbook">Якщо кодова точка була передана як
<type>string</type> в кодуванні UTF-8, то тип значення, що повертається —
<type>string</type>, інакше ж повернеться <type>int</type>. Повертає &null; у
разі невдачі.</para>'>
<!ENTITY intl.codepoint.example 'Тестування різних кодових точок'>
<!ENTITY intl.locale-len.return
'<para xmlns="http://docbook.org/ns/docbook">Повертає &null;, якщо довжина
параметра <parameter>locale</parameter> перевищує
<constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>
<!ENTITY intl.property.parameter
'<para xmlns="http://docbook.org/ns/docbook">Властивість Unicode, яка шукається
(див. конастанти <literal>IntlChar::PROPERTY_*</literal>).</para>'>
<!ENTITY intl.property.example 'Тестування різних властивостей'>
<!-- LDAP notes -->
<!ENTITY ldap.parameter.ldap
'Примірник <classname
xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, якого
повертає <function
xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>
<!ENTITY ldap.parameter.result
'Примірник <classname
xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, якого повертає
<function xmlns="http://docbook.org/ns/docbook">ldap_list</function> або
<function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>
<!ENTITY ldap.parameter.entry
'Примірник <classname
xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>
<!ENTITY ldap.warn.control-paged
'<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
Ця функція <emphasis>ЗАСТАРІЛА</emphasis>, починаючи з PHP 7.4.0, та
<emphasis>ВИЛУЧЕНА</emphasis> В PHP 8.0.0. Замість неї використовується
параметр <parameter>controls</parameter> функції
<function>ldap_search</function>. Докладніше: <link
linkend="ldap.controls">Елементи керування LDAP</link>.
</simpara>
</warning>'>
<!ENTITY ldap.changelog.controls-nullable
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Параметр <parameter>controls</parameter> тепер може бути &null;; раніше
початково було <literal>[]</literal>.
</entry>
</row>'>
<!ENTITY ldap.changelog.ldap-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>ldap</parameter> має бути примірником
<classname>LDAP\Connection</classname>; раніше очікувався дійсний &resource;
<literal>ldap link</literal>.
</entry>
</row>'>
<!ENTITY ldap.changelog.entry-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>entry</parameter> має бути примірником
<classname>LDAP\ResultEntry</classname>; раніше очікувався дійсний
&resource; <literal>ldap result entry</literal>.
</entry>
</row>'>
<!ENTITY ldap.changelog.result-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>result</parameter> має бути примірником
<classname>LDAP\Result</classname>; раніше очікувався дійсний &resource;
<literal>ldap result</literal>.
</entry>
</row>'>
<!ENTITY ldap.changelog.return-result-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер повертає примірника <classname>LDAP\Result</classname>; раніше
повертався &resource;.
</entry>
</row>'>
<!ENTITY ldap.changelog.return-result-entry-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер повертає примірника <classname>LDAP\ResultEntry</classname>; раніше
повертався &resource;.
</entry>
</row>'>
<!ENTITY ldap.return-result
'Повертає примірника <classname
xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>
<!ENTITY ldap.return-result-array
'Повертає примірника <classname
xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, масив примірників
<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>
<!ENTITY ldap.return-result-array-info
'<para xmlns="http://docbook.org/ns/docbook">Також можливо шукати паралельно.
Тоді перший параметр має бути масивом примірників
<classname>LDAP\Connection</classname>. Якщо пошуковики мають використовувати
різні базові DN і фільтр, то небхідно передати масив базових DN і/або
масив фільтрів, як параметри. Ці масиви мають бути однакових розмірів з масивом
примірників <classname>LDAP\Connection</classname>, оскільки перші елементи
масивів використовуються для одного пошуку, другі використовуються для іншого і
так далі. Виконавши паралельний пошук, повернеться масив примірників
<classname>LDAP\Result</classname>, окрім випадків помилок, коли значення, що
повернеться, буде &false;.</para>'>
<!-- mbstring notes -->
<!ENTITY note.mbstring.encoding.internal
'<note xmlns="http://docbook.org/ns/docbook"><para>Для цієї функції буде
використане внутрішнє кодування символів або те, яке визначене функцією
<function>mb_regex_encoding</function>.</para></note>'>
<!ENTITY note.mbstring.encoding.current
'<note xmlns="http://docbook.org/ns/docbook"><para>Кодування символів, визначене
функцією <function>mb_regex_encoding</function>, буде стандартним для цієї
функції.</para></note>'>
<!ENTITY mbstring.encoding.parameter
'<para xmlns="http://docbook.org/ns/docbook">Параметром
<parameter>encoding</parameter> вказується кодування символів. Якщо він
пропущений або &null;, використається внутрішнє кодування.</para>'>
<!ENTITY mbstring.warning.e-modifier
'<warning xmlns="http://docbook.org/ns/docbook"><para>Не можна використовувати
модифікатор <literal>e</literal>, працюючи з неперевіреними вхідними даними тому,
що не відбувається автоматичного екранування (на відміну від
<function>preg_replace</function>). Ігнорування цієї поради, швидше за все,
зробить програму вразливою до віддаленого виконання коду.</para></warning>'>
<!ENTITY mbstring.changelog.encoding-nullable
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>encoding</parameter> тепер може бути &null;.
</entry>
</row>'>
<!ENTITY mbstring.changelog.needle-empty
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
<parameter>needle</parameter> тепер може бути порожнім рядком.
</entry>
</row>'>
<!-- mcrypt notes -->
<!ENTITY mcrypt.parameter.cipher
'<para xmlns="http://docbook.org/ns/docbook">Одна з констант
<constant>MCRYPT_ciphername</constant> або назва алгоритму у вигляді
рядка.</para>'>
<!ENTITY mcrypt.parameter.iv
'<para xmlns="http://docbook.org/ns/docbook">Використовується для ініціалізації в
режимах CBC, CFB, OFB, а також в деяких алгоритмах у режимі STREAM. Якщо
параметр IV не визначено, проте він необхідний для алгоритму, то функція
виводить попередження та застосовує IV, де всі байти є
"<literal>\0</literal>".</para>'>
<!ENTITY mcrypt.parameter.iv.strict
'<para xmlns="http://docbook.org/ns/docbook">Використовується для ініціалізації в
режимах CBC, CFB, OFB, а також в деяких алгоритмах у режимі STREAM. Якщо
вказаний IV-розмір не підтримується в режимі ланцюга або IV взагалі не вказано,
проте він необхідний для режиму ланцюга, функція видасть попередження та поверне
&false;.</para>'>
<!ENTITY mcrypt.parameter.mode
'<para xmlns="http://docbook.org/ns/docbook">Одна з констант
<constant>MCRYPT_MODE_modename</constant> або один з рядків: "ecb", "cbc",
"cfb", "ofb", "nofb", "stream".</para>'>
<!-- MCVE notes -->
<!ENTITY mcve.conn.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>conn</parameter></term><listitem><para>Ресурс MCVE_CONN, якого
повертає <function>m_initengine</function>.</para></listitem></varlistentry>'>
<!-- memcached notes -->
<!ENTITY memcached.note.delete-time
'<note xmlns="http://docbook.org/ns/docbook"><simpara>
Починаючи з memcached 1.3.0 (випущено в 2009) цей функціонал більше не
підтримується. Використання ненульового <parameter>time</parameter>
спричинить помилку під час видалення.
<methodname>Memcached::getResultCode</methodname> поверне
<constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
</simpara></note>
'>
<!ENTITY memcached.parameter.expiration
'Термін зберігання, стандарно — 0. Докладніше: <link
linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Терміни
зберігання</link>.'>
<!ENTITY memcached.parameter.server_key
'Ключ, що визначає сервер, на якому зберігатиметься значення або з якого його
можна отримати. Замість гешування ключа елемента, гешується ключ сервера, з яким
буде взаємодіяти memcached. Це дозволяє об&apos;єднувати пов&apos;язані елементи
на єдиному сервері для пришвидшення одночасних операцій.'>
<!ENTITY memcached.parameter.items 'Масив пар ключ/значення для зберігання на сервері.'>
<!ENTITY memcached.parameter.key 'Ключ, під яким зберігається значення.'>
<!ENTITY memcached.parameter.value 'Значення для зберігання.'>
<!ENTITY memcached.result.getresultcode 'За необхідності використовується <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>.'>
<!ENTITY memcached.result.delete-multi
'<para xmlns="http://docbook.org/ns/docbook">
Повертає масив, проіндексовиний за <parameter>keys</parameter>. Кожен
елемент, у якого вилучено ключ або ключем є одна з констант
<constant>Memcached::RES_<replaceable>*</replaceable></constant> (коли
вилучення невдале), дорівнює &true;.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<methodname>Memcached::getResultCode</methodname> повертає код результату для
останньої виконаної операції вилучення, тобто операції вилучення для
попереднього елемента <parameter>keys</parameter>.
</para>
'>
<!-- password notes -->
<!ENTITY password.parameter.algo '<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Константа алгоритму для паролю</link>, що позначає алгоритм для гешування пароля.'>
<!ENTITY password.parameter.hash 'Геш, створений функцією <function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>
<!ENTITY password.parameter.options 'Асоціативниий масив опцій. Документація щодо доступних опцій для кожного алгоритму викладена на сторінці <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Константи алгоритмів для паролів</link>.'>
<!ENTITY password.parameter.password 'Користувацький пароль.'>
<!-- pspell notes -->
<!ENTITY pspell.changelog.pspell-dictionary
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>dictionary</parameter> має бути примірником
<classname>PSpell\Dictionary</classname>; раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY pspell.changelog.pspell-config
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>config</parameter> має бути примірником
<classname>PSpell\Config</classname>; раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY pspell.parameter.pspell-dictionary
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PSpell\Dictionary</classname>.</para>'>
<!ENTITY pspell.parameter.pspell-config
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PSpell\Config</classname>.</para>'>
<!-- RNP -->
<!ENTITY rnp.parameter.ffi-description 'Об&apos;єкт FFI, якого повертає rnp_ffi_create.'>
<!ENTITY rnp.parameter.key-format 'Ключовий формат даних (GPG, KBX, G10).'>
<!ENTITY rnp.parameter.loadsave-flags 'Варто прочитати опис прапорців RNP_LOAD_SAVE_*.'>
<!-- socket entities -->
<!ENTITY sockets.changelog.socket-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер <parameter>socket</parameter> є примірником
<classname>Socket</classname>; раніше це був <type>resource</type>.
</entry>
</row>'>
<!ENTITY sockets.changelog.address-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер <parameter>address</parameter> є примірником
<classname>AddressInfo</classname>; раніше це був <type>resource</type>.
</entry>
</row>'>
<!-- geaman notes -->
<!ENTITY gearman.parameter.host "Ім'я хоста сервера завдань.">
<!ENTITY gearman.parameter.port 'Порт сервера завдань.'>
<!ENTITY gearman.parameter.functionname 'Зареєстрована функція, яку викликає робочий процес'>
<!ENTITY gearman.parameter.workload 'Серіалізовані дані для обробки'>
<!ENTITY gearman.parameter.data 'Додаткові дані, які можуть бути потрібні для завершення роботи'>
<!ENTITY gearman.parameter.context 'Контекст застосунку, що асоціюється із завданням'>
<!ENTITY gearman.parameter.unique 'Унікальний ID завдання'>
<!ENTITY gearman.parameter.jobhandle 'Дескриптор завдання, що призначається сервером Gearman'>
<!ENTITY gearman.parameter.callback
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>callback</parameter></term>
<listitem>
<para>
Назва функції або методу для виклику, що має повертати <link
linkend="gearman.constants">Gearman-значення</link>.
</para>
<para>
Якщо оператор return відсутній, то типовим значенням є
<constant>GEARMAN_SUCCESS</constant>.
</para>
<methodsynopsis>
<type>int</type><methodname><replaceable>callback</replaceable></methodname>
<methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
<methodparam><type>mixed</type><parameter>context</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>task</parameter></term>
<listitem>
<para>
Завдання, для якого викликається зворотній виклик.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<para>
Те, що передано в <methodname>GearmanClient::addTask</methodname> (або
рівнозначний метод) як <parameter>context</parameter>.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>'>
<!ENTITY gearman.note.callback
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Зворотній виклик спрацьовує лише для завдань, які були додані (напр. методом
<methodname>GearmanClient::addTask</methodname>) після виклику цього методу.
</para>
</note>'>
<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Список підтримуваних часових поясів</title>'>
<!ENTITY date.timezone.intro
"<para xmlns='http://docbook.org/ns/docbook'>
Це повний список часових поясів, які підтримує PHP. Вони призначені для
використання з, наприклад, функцією
<function>date_default_timezone_set</function>.<caution><simpara>Поведінка не
вказаних тут часових поясів є невизначеною.</simpara></caution></para><note
xmlns='http://docbook.org/ns/docbook'><simpara>Найновішу версію бази даних
часових поясів можна отримати, встановивши PECL-розширення <link
xlink:href='&url.pecl.package.get;timezonedb'
xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">
<!ENTITY date.timezone.bc
'<simpara xmlns="http://docbook.org/ns/docbook">Не рекомендовано використовувати
перераховані тут часові пояси (крім UTC). Вони існують лише для зворотньої
сумісності і можуть спричинити помилки. Більше того, ці часові пояси можуть бути
вилучені з бази даних часових поясів IANA у будь-який момент.</simpara>'>
<!ENTITY date.timezone.posix-signs
'<simpara xmlns="http://docbook.org/ns/docbook">
Нехтуючи наведеним вище попередженням, необхідно зазначити, що база даних
часових поясів IANA, яку підтримує PHP, використовує POSIX-символи, тож
часові пояси <literal>Etc/GMT+n</literal> та <literal>Etc/GMT-n</literal>,
зворотні до загальноприйнятих.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
Наприклад, часовий пояс, додатній на 8 годин щодо GMT, який використовується в
Китаї і на заході Австралії (та інших місцях), у цій базі даних є
насправді <literal>Etc/GMT-8</literal>, а не <literal>Etc/GMT+8</literal>, як
можна було б очікувати.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
Знову ж таки, настійно рекомендується використовувати часовий пояс відповідно
до розташування, як от <literal>Asia/Shanghai</literal> або
<literal>Australia/Perth</literal> для прикладу вище.
</simpara>'>
<!ENTITY date.timezone.abbrev-volatile
'<simpara xmlns="http://docbook.org/ns/docbook">
Ці скорочення часових поясів слід розглядати як дуже мінливі, бо у різних
випусках timezonedb вони можуть відрізнятися і на них не варто покладатися.
Рекомендується уникати використання скорочень часових поясів.
</simpara>'>
<!ENTITY date.timezone.errors.description
'<para xmlns="http://docbook.org/ns/docbook">
Якщо часовий пояс хибний, то під час кожного виклику функції дати/часу
виникатиме <constant>E_WARNING</constant>. Див.
<function>date_default_timezone_set</function>.</para>'>
<!ENTITY date.timezone.errors.changelog
'<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
Тепер видає помилки часових зон рівня <constant>E_STRICT</constant> та
<constant>E_NOTICE</constant>.</para></entry></row>'>
<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
Необов&apos;язковий параметр <parameter>timestamp</parameter> — це позначка часу Unix
типу <type>int</type>, яка стандартно дорівнює поточному місцевому часу, якщо
<parameter>timestamp</parameter> не вказаний або &null;. Тобто є результатом
функції <function>time</function>.
</para></listitem></varlistentry>'>
<!ENTITY date.datetime.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Тільки процедурний стиль: об&apos;єкт
<classname>DateTime</classname> повертається функцією
<function>date_create</function></para></listitem></varlistentry>'>
<!ENTITY date.datetime.description.modified
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Тільки процедурний стиль: об&apos;єкт
<classname>DateTime</classname> повертається функцією
<function>date_create</function>. Вона змінює цей
об&apos;єкт.</para></listitem></varlistentry>'>
<!ENTITY date.datetimezone.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>object</parameter></term><listitem><para>Тільки процедурний стиль:
об&apos;єкт <classname>DateTimeZone</classname> повертається функцією
<function>timezone_open</function></para></listitem></varlistentry>'>
<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Повертає змінений об&apos;єкт <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для ланцюжків методів &return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Повертає змінений об&apos;єкт <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для ланцюжків методів.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Повертає новий об&apos;єкт <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> зі зміненими даними &return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Повертає новий об&apos;єкт <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> зі зміненими даними.'>
<!ENTITY date.timezone.dbversion 'У основі цього списку база даних часових поясів'>
<!ENTITY date.timezone.africa 'Африка'>
<!ENTITY date.timezone.america 'Америка'>
<!ENTITY date.timezone.antarctica 'Антартика'>
<!ENTITY date.timezone.arctic 'Арктика'>
<!ENTITY date.timezone.asia 'Азія'>
<!ENTITY date.timezone.atlantic 'Атлантика'>
<!ENTITY date.timezone.australia 'Австралія'>
<!ENTITY date.timezone.europe 'Європа'>
<!ENTITY date.timezone.indian 'Індійський'>
<!ENTITY date.timezone.pacific 'Тихоокеанський'>
<!ENTITY date.timezone.others 'Інші'>
<!ENTITY date.timezone.abbreviations 'Скорочення'>
<!ENTITY date.formats 'Пояснення коректних форматів надано в <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">Формати дати й часу</link>.'>
<!ENTITY date.formats.parameter 'Рядок дати/часу. &date.formats;'>
<!-- DomXml Notes -->
<!ENTITY node.inserted
'Цей вузол не відображатиметься в документі, якщо його не буде вставлено (напр.)
функцією <function
xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>.'>
<!-- Dom Notes -->
<!ENTITY dom.node.inserted
'Цей вузол не відображатиметься в документі, якщо його не буде вставлено (напр.)
функцією <function
xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>.'>
<!ENTITY dom.malformederror
'<para xmlns="http://docbook.org/ns/docbook">Хоча неправильний HTML має успішно
завантажитися, ця функція може генерувати <constant>E_WARNING</constant>,
виявивши неправильну розмітку. <link
linkend="function.libxml-use-internal-errors">Функції обробки помилок
libxml</link> можна використовувати для обробки цих помилок.</para>'>
<!ENTITY dom.note.utf8
'<note xmlns="http://docbook.org/ns/docbook"><para>Розширення DOM використовує
кодування UTF-8. Обробляти інші кодування можна за допомогою
<function>mb_convert_encoding</function>,
<methodname>UConverter::transcode</methodname> або
<function>iconv</function>.</para></note>'>
<!ENTITY dom.note.json
'<note xmlns="http://docbook.org/ns/docbook"><para>Результатом застосування
<function>json_encode</function> до об&apos;єкта
<classname>DOMDocument</classname> буде кодування порожнього
об&apos;єкта.</para></note>'>
<!ENTITY dom.domdocument.html5
'<warning xmlns="http://docbook.org/ns/docbook">
<para>
Ця функція аналізує вхідні дані за допомогою парсера HTML 4. Правила аналізу
HTML 5, які використовують більш сучасні браузери — інакші. Залежно від
вхідних даних, DOM-структура може бути зміненою у результаті. Отже, ця функція
не придатна для безпечного очищення HTML-коду.
</para>
<para>
Повідінка функції під час парсину HTML може залежати від версії
<literal>libxml</literal>, що використовується та частково від граничних
випадків і обробки помилок. Для парсингу згідно стандарту HTML 5
використовується метод
<methodname>Dom\HTMLDocument::createFromString</methodname> або
<methodname>Dom\HTMLDocument::createFromFile</methodname>, починаючи з PHP
8.4.
</para>
<para>
До прикладу, деякі елементи HTML неявно закривають батьківський елемент одразу
після себе. Правила автоматичного закривання батьківських елементів в HTML 4
та HTML 5 відрізняються, і тому клас <classname>DOMDocument</classname>
може бачити DOM-структури, що відрізняються від тих, що бачить браузер,
дозволяючи зловмиснику поламати вихідний HTML-код.
</para>
</warning>'>
<!-- Dom Examples -->
<!ENTITY dom.book.example
'<para xmlns="http://docbook.org/ns/docbook">У наступних прикладах
використовується <filename>book.xml</filename> з таким вмістом:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE books [
<!ELEMENT books (book+)>
<!ELEMENT book (title, author+, xhtml:blurb?)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT blurb (#PCDATA)>
<!ELEMENT author (#PCDATA)>
<!ATTLIST books xmlns CDATA #IMPLIED>
<!ATTLIST books xmlns:xhtml CDATA #IMPLIED>
<!ATTLIST book id ID #IMPLIED>
<!ATTLIST author email CDATA #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
<book id="php-basics">
<title>PHP Basics</title>
<author email="jim.smith@basics.php">Jim Smith</author>
<author email="jane.smith@basics.php">Jane Smith</author>
<xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
</book>
<book id="php-advanced">
<title>PHP Advanced Programming</title>
<author email="jon.doe@advanced.php">Jon Doe</author>
</book>
</books>
]]></programlisting>'>
<!-- Dom entities -->
<!ENTITY dom.parameter.options
'<para xmlns="http://docbook.org/ns/docbook">
<link linkend="language.operators.bitwise">Побітове
<literal>АБО</literal></link> <link linkend="libxml.constants">констант опцій
libxml</link>.
</para>'>
<!ENTITY dom.parameters.register_node_ns
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>registerNodeNS</parameter></term>
<listitem>
<para>
Визначає, чи необхідно автоматично реєструвати префікси простору імен в
області видимості контекстного вузла для об&apos;єкта
<classname>DOMXPath</classname>. Потрібно для того, щоб не викликати метод
<methodname>DOMXPath::registerNamespace</methodname> для кожного простору
імен в області видимості. Коли префікси збігаються, реєструється тільки
префікс простору імен найближчого нащадка.
</para>
</listitem>
</varlistentry>'>
<!ENTITY dom.errors.hierarchy.parent
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
<listitem>
<para>
Виникає, якщо тип батьківського вузла не дозволяє тип дочірнього вузла,
котрий передано в параметр <parameter>nodes</parameter>, або якщо вузол,
який потрібно додати, є одним із предків цього вузла або ним самим.
</para>
</listitem>
</varlistentry>'>
<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
<listitem>
<para>
Виникає, якщо тип цього вузла не дозволяє тип дочірнього вузла,
котрий передано в параметр <parameter>nodes</parameter>, або якщо вузол,
який потрібно додати, є одним із предків цього вузла або ним самим.
</para>
</listitem>
</varlistentry>'>
<!ENTITY dom.errors.wrong_document
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Виникає, якщо один з переданих <parameter>nodes</parameter> було створено не
в тому документі, що і цей вузол.
</para>
</listitem>
</varlistentry>'>
<!ENTITY dom.changelog.previous_hierarchy_exception
'Раніше викидалося виключення <classname
xmlns="http://docbook.org/ns/docbook">DOMException</classname> з кодом <constant
xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>
<!ENTITY dom.c14n.xpath_array
'<listitem xmlns="http://docbook.org/ns/docbook">
<para>
Масив XPath-шляхів для фільтації шляхів. Кожен елемент в ньому — це
асоціативний масив, що містить:
<itemizedlist>
<listitem>
<simpara>
Обов&apos;язковий елемент з ключем <literal>query</literal> та значенням виразу
XPath у вигляді рядка.
</simpara>
</listitem>
<listitem>
<simpara>
Необов&apos;язковий елемент з ключем <literal>namespaces</literal> та
значенням, що є масивом, де зіставлено префікси простору імен (ключі) з
URI простору імен (значення).
</simpara>
</listitem>
</itemizedlist>
</para>
</listitem>'>
<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure
'<para xmlns="http://docbook.org/ns/docbook">
Під час збоїв буде видаватись <constant>E_WARNING</constant>.
</para>'>
<!ENTITY fs.validfp.all
'<para xmlns="http://docbook.org/ns/docbook">Вказівник на файл має бути дійсним
та має вказувати на файл, успішно відкритий функцією
<function>fopen</function> або <function>fsockopen</function> (та не закритий
функцією <function>fclose</function>).</para>'>
<!ENTITY fs.file.pointer
'<para xmlns="http://docbook.org/ns/docbook">Вказівник файлової системи типу
<type>resource</type>, якого повертає функція
<function>fopen</function>.</para>'>
<!ENTITY fs.file.32bit
'<note xmlns="http://docbook.org/ns/docbook"><simpara>
Оскільки цілочисельний тип в PHP є знаковим, а багато платформ
використовують 32-бітні цілі числа, деякі функції файлової системи можуть
повертати неочікувані результати для файлів, розмір яких перевищує 2 ГБ.
</simpara></note>'>
<!ENTITY ini.scanner.typed
'<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 5.6.1, можна визначати, як
<constant>INI_SCANNER_TYPED</constant>. У цьому режимі логічні, нульові та
цілочисельні типи збережуться за можливості. Рядки
<literal>"true"</literal>, <literal>"on"</literal> та
<literal>"yes"</literal> перетворяться на &true;. Відповідно,
<literal>"false"</literal>, <literal>"off"</literal>,
<literal>"no"</literal> та <literal>"none"</literal> — на &false;.
<literal>"null"</literal> перетвориться на &null;. Також, усі числові рядки
перетворяться в цілі числа за можливості.
</para>'>
<!-- GNUPG -->
<!ENTITY gnupg.identifier
'<para xmlns="http://docbook.org/ns/docbook">Ідентифікатор GnuPG, якого повертає
<function>gnupg_init</function> або <classname>gnupg</classname>.</para>'>
<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">Відбиток ключа.</para>'>
<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">У разі помилки викидає <classname>HaruException</classname>.</para>'>
<!-- ODBC -->
<!ENTITY odbc.connection.id
'<para xmlns="http://docbook.org/ns/docbook">Ідентифікатор з&apos;єднання ODBC.
Докладніше: <function>odbc_connect</function>.</para>'>
<!ENTITY odbc.parameter.catalog 'Каталог (&apos;qualifier&apos; мовою ODBC 2).'>
<!ENTITY odbc.parameter.schema 'Схема (&apos;owner&apos; мовою ODBC 2).'>
<!ENTITY odbc.parameter.search
'Цей параметр може містити наступні шаблони пошуку: <literal
xmlns="http://docbook.org/ns/docbook">&#x25;</literal> — щоб вибирати нуль або
більше символів, та <literal xmlns="http://docbook.org/ns/docbook">_</literal>
щоб вибрати один символ.'>
<!ENTITY odbc.result.driver-specific 'Драйвер може оголошувати додаткові стовпці.'>
<!-- OAUTH -->
<!ENTITY oauth.callback.error
'Видає помилку рівня <constant
xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>, якщо функцію
зворотнього виклику (callback) не можна викликати, або її не визначено.'>
<!ENTITY oauth.changelog.error.null 'Раніше в разі помилки замість &false; повертався &null;.'>
<!-- Oracle -->
<!ENTITY oci.db
"<para xmlns='http://docbook.org/ns/docbook'
xmlns:xlink='http://www.w3.org/1999/xlink'>Містить
<literal>примірник Oracle</literal> для з'єднання. Це може бути або <link
xlink:href='&url.oracle.oic.connect;'>Easy Connect string</link>, або Connect
Name з файлу <filename>tnsnames.ora</filename>, або назва локального примірника
Oracle.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Якщо не вказано або &null;, то PHP
використовує змінні оточення, як от <constant>TWO_TASK</constant> (в Linux) або
<constant>LOCAL</constant> (у Windows) та <constant>ORACLE_SID</constant>, щоб
визначити <literal>примірник Oracle</literal> для з'єднання.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Для використання методу називання Easy Connect, PHP має бути скомпоновано з
Oracle 10<emphasis>g</emphasis> або новішими клієнтськими бібліотеками. Easy
Connect string для Oracle 10<emphasis>g</emphasis> має форму
<emphasis>[//]назва_хосту[:порт][/назва_сервісу]</emphasis>. Починаючи з Oracle
11<emphasis>g</emphasis>, синтаксис наступний:
<emphasis>[//]назва_хосту[:порт][/назва_сервісу][:тип_сервера][/назва_примірника]</emphasis>.
Додаткові можливості були запроваджені в Oracle 19c, як от налаштування
обмеженого у часі та постійного з'єднання. Докладніше про це у документації
Oracle. Назви служб можна побачити, запустивши утиліту Oracle
<literal>lsnrctl status</literal> на машині сервера бази даних.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Файл <filename>tnsnames.ora</filename> може бути на шляху пошуку Oracle Net, що
містить <filename>/ваш/шлях/до/instantclient/network/admin</filename>,
<filename>$ORACLE_HOME/network/admin</filename> та <filename>/etc</filename>.
Як варіант, можна встановити <literal>TNS_ADMIN</literal>, тоді буде прочитано
файл <filename>$TNS_ADMIN/tnsnames.ora</filename>. Вебсервер має мати право
на читання цього файлу.
</para>">
<!ENTITY oci.charset
"<para xmlns='http://docbook.org/ns/docbook'>Визначає набір символів, які
використовують клієнтські бібліотеки Oracle. Кодування може не збігатися з тим,
що використовує база даних. Якщо так, Oracle намагатиметься перекодувати дані.
Залежно від кодування, це може не давати прийнятні результати. Перетворення
також збільшуватиме час виконання.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Якщо не визначено, то клієнтські
бібліотеки Oracle оберуть кодування, яке вказано в змінній оточення
<constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Визначення цього параметра може
скоротити час з'єднання.
</para>">
<!ENTITY oci.sessionmode
'<para xmlns="http://docbook.org/ns/docbook">Цей параметр доступний, починаючи з
PHP 5 (PECL OCI8 1.1) та має такі допустимі значення:
<constant>OCI_DEFAULT</constant>, <constant>OCI_SYSOPER</constant> і
<constant>OCI_SYSDBA</constant>. Якщо вказано <constant>OCI_SYSOPER</constant>
або <constant>OCI_SYSDBA</constant>, то ця функція намагатиметься встановити
привілейоване підключення за допомогою зовнішніх облікових даних. Привілейовані
з&apos;єднання початково вимкнені. Для увімкнення необхідно директиві <link
linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link> встановити
значення <literal>On</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
У PHP 5.3 (PECL OCI8 1.3.4) вводиться значення режиму
<constant>OCI_CRED_EXT</constant>. Воно вказує Oracle використовувати зовнішню
автентифікацію або автентифікацію операційної системи, котра має бути
налаштована в базі даних. Прапорець <constant>OCI_CRED_EXT</constant> дозволено
використовувати тільки з іменем користувача &quot;/&quot; та порожнім паролем.
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link> може
бути <literal>On</literal> або <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> можна поєднувати з режимами
<constant>OCI_SYSOPER</constant> або
<constant>OCI_SYSDBA</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> не підтримується у Windows з міркувань
безпеки.
</para>'>
<!ENTITY oci.datatypes
'<para xmlns="http://docbook.org/ns/docbook">Докладніше про зіставлення типів
даних, яке виконується розширенням OCI8: <link linkend="oci8.datatypes">Типи
даних, які підтримує драйвер</link>.</para>'>
<!ENTITY oci.parameter.connection
'<para xmlns="http://docbook.org/ns/docbook">Ідентифікатор з&apos;єднання Oracle,
якого повертає <function>oci_connect</function>, <function>oci_pconnect</function>,
<function>oci_new_connect</function>.</para>'>
<!ENTITY oci.availability.note.10g
'<note xmlns="http://docbook.org/ns/docbook"><title>Вимога до версії
Oracle</title><para>Ця функція доступна, якщо PHP скомпоновано з бібліотеками
Oracle Database версії 10<emphasis>g</emphasis> і новішими.</para></note>'>
<!ENTITY oci.clientinfo.tip
'<tip xmlns="http://docbook.org/ns/docbook"><title>Швидкодія</title><para>Зі
старішими версіями OCI8 або Oracle Database, клієнтські дані можна записувати,
використовуючи пакунок Oracle <literal>DBMS_APPLICATION_INFO</literal>. Це менш
ефективно, ніж використання
<function>oci_set_client_info</function>.</para></tip>'>
<!ENTITY oci.roundtrip.caution
'<caution xmlns="http://docbook.org/ns/docbook"><title>Підказка щодо
round-trip</title><para>Деякі (але не всі) функції OCI8 завжди спричиняють
round-trip (надсилання запиту до бази даних, вибірку з бази, отримання відповіді
від неї). Проте цього не стається, якщо увімкнено кешування результатів.
</para></caution>'>
<!ENTITY oci.use.setprefetch
'<para xmlns="http://docbook.org/ns/docbook">Для вибірки з великою кількістю
рядків можна значно покращити продуктивність, збільшивши <link
linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link> або
використавши <function>oci_set_prefetch</function>.
</para>'>
<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>Дійсний ідентифікатор оператора
OCI8, створений функцією <function>oci_parse</function> та опрацьований за
допомогою <function>oci_execute</function>, або ідентифікатор оператора
<literal>REF CURSOR</literal>.</para>">
<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status
'<para xmlns="http://docbook.org/ns/docbook">Параметр
<parameter>status</parameter> записується у разі успішного виклику
<function>pcntl_waitpid</function>.</para>'>
<!-- PS Notes -->
<!ENTITY ps.note.visible
'<para xmlns="http://docbook.org/ns/docbook">Замітка не буде видимою на
надрукованому документі або під час його перегляду, проте вона стане видимою,
якщо документ конвертовано в pdf за допомогою Acrobat Distiller™ або
Ghostview.</para>'>
<!-- Notes for safe-mode limited functions: -->
<!-- Not used in EN anymore -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>
<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Коли увімкнено <link
linkend="features.safe-mode">безпечний режим</link>, то PHP перевірятиме, чи
файли або теки, над якими здійснюється операція, мають такий же UID (власника),
що й скрипт, який виконується.</simpara></note>'>
<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck.dir
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Коли увімкнено <link
linkend="features.safe-mode">безпечний режим</link>, то PHP перевірятиме, чи
тека, наю якою здійснюється операція, має такий же UID (власника), що й скрипт,
який виконується.</simpara></note>'>
<!ENTITY note.open-basedir.func
'<note xmlns="http://docbook.org/ns/docbook"><para>Ця функція залежить від <link
linkend="ini.open-basedir">open_basedir</link>.</para></note>'>
<!ENTITY note.language-construct
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Оскільки це мовна
конструкція, а не функція, її не можна викликати через <link
linkend="functions.variable-functions">змінні-функції</link> або <link
linkend="functions.named-arguments">названі параметри</link>.</simpara></note>'>
<!-- Common pieces in features/safe-mode.xml
Jade doesn't allow in-line entities, so I put them here... Though they
should have been inline in safe-mode.xml -->
<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck
'Перевіряє, чи файли/теки, над якими здійснюється операція, мають такий же UID
(власника), що й скрипт, який виконується.'>
<!-- Not used in EN anymore -->
<!ENTITY warn.sm.exec
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Коли увімкнено <link
linkend="features.safe-mode">безпечний режим</link>, командний рядок екранується
за допомогою <function>escapeshellcmd</function>. Таким чином, <literal>echo y |
echo x</literal> стане <literal>echo y \| echo x</literal>.</simpara></warning>'>
<!-- Not used in EN anymore -->
<!ENTITY note.exec-path
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Коли увімкнено <link
linkend="features.safe-mode">безпечний режим</link>, дозволено виконувати файли,
котрі є всередині <link
linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. З практичних
міркувань наразі заборонено мати складові <literal>..</literal> в рядку шляху
до виконуваного файлу.</simpara></note>'>
<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck.dir
'Перевіряє, чи тека, над якою здійснюється операція, має такий же UID (власника),
що й скрипт, який виконується.'>
<!-- Not used in EN anymore -->
<!ENTITY sm.disabled
'Ця функція заблокована в <link xmlns="http://docbook.org/ns/docbook"
linkend="features.safe-mode">безпечному режимі</link>.'>
<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Це розширення не має директив конфігурації, що визначені в &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Це розширення не має визначених типів ресурсу.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Це розширення не має визначених констант.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Для побудови цього розширення не потрібні зовнішні бібліотеки.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Для використання цих функцій не потрібне встановлення. Вони є частиною ядра PHP.</para>'>
<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title
'<para xmlns="http://docbook.org/ns/docbook">Тут є коротке пояснення директив
конфігурації.</para>'>
<!-- Common pieces for reference part BEGIN-->
<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime
'<simpara xmlns="http://docbook.org/ns/docbook">
На поведінку цих функцій випливають налаштування в &php.ini;.
</simpara>'>
<!ENTITY ini.php.constants
'Докладніша інформація та визначення режимів INI_* на сторінці <xref
xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>.'>
<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants
'<simpara xmlns="http://docbook.org/ns/docbook">
Константи, описані нижче — визначені цим розширенням, тож доступні, коли
розширення скомпільовано як частина PHP або динамічно підключене під час
виконання.
</simpara>'>
<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core
'<simpara xmlns="http://docbook.org/ns/docbook">
Константи, описані нижче, завжди доступні, бо є частиною ядра PHP.
</simpara>'>
<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes
'<simpara xmlns="http://docbook.org/ns/docbook">
Класи, описані нижче — визначені цим розширенням, тож доступні, коли розширення
скомпільовано як частина PHP або динамічно підключене під час виконання.
</simpara>'>
<!-- PDO entities -->
<!ENTITY pdo.driver-constants
'<simpara xmlns="http://docbook.org/ns/docbook">Константи, описані нижче —
визначені цим драйвером, тож доступні, коли розширення скомпільовано як частина
PHP або динамічно підключене під час виконання. До того ж, ці спеціальні
константи драйвера потрібно використовувати тільки для нього. Використання
спеціальних атрибутів драйвера з іншим драйвером може спричинити неочікувану
поведінку. Методом <function>PDO::getAttribute</function> можна отримати атрибут
<constant>PDO_ATTR_DRIVER_NAME</constant>, щоб перевірити сумісність коду для
поточного драйвера з іншими драйверами.</simpara>'>
<!ENTITY pdo.errors.exception-not-errmode
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Виключення викидається
навіть якщо атрибут <constant>PDO::ATTR_ERRMODE</constant> не є
<constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>
<!-- PDO errors -->
<!ENTITY pdo.errors
'<para xmlns="http://docbook.org/ns/docbook">
Видає помилку рівня <constant>E_WARNING</constant>, якщо атрибут
<constant>PDO::ATTR_ERRMODE</constant> дорівнює
<constant>PDO::ERRMODE_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Викидає <classname>PDOException</classname>, якщо атрибут
<constant>PDO::ATTR_ERRMODE</constant> дорівнює
<constant>PDO::ERRMODE_EXCEPTION</constant>.
</para>'>
<!-- PECL entities -->
<!ENTITY pecl.moved 'Це розширення &link.pecl; не входить до складу PHP.'>
<!ENTITY pecl.bundled 'Це розширення &link.pecl; входить до складу PHP.'>
<!ENTITY pecl.info
'Інструкція щодо встановлення цього PECL-розширення є в розділі посібника <link
xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Встановлення
PECL-розширень</link>. Більше інформації, як от нові випуски, файли для
завантаження, файли з початковим кодом, інформація для дописувачів та список
змін знаходиться тут: '>
<!ENTITY pecl.info.dead
'Це розширення більше не оновлюється. Тим не менш, початковий код цього
розширення ще доступний у рамках <acronym
xmlns="http://docbook.org/ns/docbook">PECL</acronym> <acronym
xmlns="http://docbook.org/ns/docbook">SVN</acronym> тут: '>
<!ENTITY pecl.info.dead.git
'Це розширення більше не оновлюється. Тим не менш, початковий код цього
розширення ще доступний у рамках <acronym
xmlns="http://docbook.org/ns/docbook">PECL</acronym> <acronym
xmlns="http://docbook.org/ns/docbook">GIT</acronym> тут: '>
<!ENTITY pecl.windows.download
'Файл <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> цього
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>-розширення наразі
недоступний. Докладніше про це у розділі <link
xmlns="http://docbook.org/ns/docbook"
linkend="install.windows.building">Збирання на платформі Windows</link>.'>
<!ENTITY pecl.windows.download.avail
'Двійкові файли Windows (<acronym
xmlns="http://docbook.org/ns/docbook">DLL</acronym>) цього <acronym
xmlns="http://docbook.org/ns/docbook">PECL</acronym>-розширення доступні на
вебсайті PECL.'>
<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>
<!ENTITY pecl.moved-ver 'Це розширення переміщено до сховища &link.pecl; та
більше не входить до складу PHP, починаючи з PHP '>
<!-- PGSQL entities -->
<!ENTITY pgsql.parameter.connection
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PgSql\Connection</classname>.</para>'>
<!ENTITY pgsql.parameter.connection-with-unspecified-default
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PgSql\Connection</classname>. Якщо параметр
<parameter>connection</parameter> не визначено, то виконується стандартне
з&apos;єднання, тобто останнє, виконане функцією <function>pg_connect</function>
або <function>pg_pconnect</function>. <warning><simpara>Починаючи з PHP 8.1.0,
використання стандартного з&apos;єднання є
застарілим.</simpara></warning></para>'>
<!ENTITY pgsql.parameter.connection-with-nullable-default
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PgSql\Connection</classname>. Якщо параметр
<parameter>connection</parameter>&null;, то виконується стандартне
з&apos;єднання, тобто останнє, виконане функцією <function>pg_connect</function>
або <function>pg_pconnect</function>. <warning><simpara>Починаючи з PHP 8.1.0,
використання стандартного з&apos;єднання є
застарілим.</simpara></warning></para>'>
<!ENTITY pgsql.parameter.result
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PgSql\Result</classname>, якого повертає одна з функцій
<function>pg_query</function>, <function>pg_query_params</function> або
<function>pg_execute</function> (серед інших).</para>'>
<!ENTITY pgsql.parameter.lob
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>PgSql\Lob</classname>, якого повертає
<function>pg_lo_open</function>.</para>'>
<!ENTITY pgsql.parameter.mode
'<para xmlns="http://docbook.org/ns/docbook">Необов&apos;язковий параметр, яким
вказується спосіб індексування масиву (<type>array</type>).
<parameter>mode</parameter> може мати значення однієї з констант:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> або
<constant>PGSQL_BOTH</constant>. Якщо задано <constant>PGSQL_NUM</constant>, то
функція поверне масив з числовими індексами; якщо
<constant>PGSQL_ASSOC</constant>, то з асоціативними індексами; якщо
<constant>PGSQL_BOTH</constant>, то і з числовими, і з асоціативними
індексами.</para>'>
<!ENTITY pgsql.changelog.connection-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>connection</parameter> має бути примірником
<classname>PgSql\Connection</classname>. Раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY pgsql.changelog.result-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>result</parameter> має бути примірником
<classname>PgSql\Result</classname>. Раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY pgsql.changelog.lob-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>lob</parameter> має бути примірником
<classname>PgSql\Lob</classname>. Раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY pgsql.changelog.return-result-object
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер повертається примірник <classname>PgSql\Result</classname>. Раніше
повертався &resource;.
</entry>
</row>'>
<!-- Common pieces for reference part END -->
<!ENTITY windows.builtin
'<simpara xmlns="http://docbook.org/ns/docbook">Версія PHP для Windows має
вбудовану підтримку цього розширення. Не потрібно додатково підключати будь-яке
розширення для використання цих функцій.</simpara>'>
<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">безпечний режим</link>'>
<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">безпечний режим для SQL</link>'>
<!-- BCMath Notes -->
<!ENTITY bc.scale.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>scale</parameter></term><listitem><para>Необов&apos;язковий параметр,
яким вказується кількість знаків після крапки в результаті. Якщо опущено,
застосовується межа, що встановлена глобально функцією
<function>bcscale</function>, або ж <literal>0</literal>, якщо межа ще не
встановлена.</para></listitem></varlistentry>'>
<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer
'<note xmlns="http://docbook.org/ns/docbook"><para>
Ціле число (<type>int</type>) від -128 до 255 включно вважається кодом символу
ASCII (від&apos;ємні значення збільшуються на 256, що дає доступ до розширеного
діапазону ASCII). Інші цілі числа вважаються рядками, що містять ціле десяткове
число у вигляді цифр.</para></note>'>
<!ENTITY note.ctype.parameter.non-string
'<warning xmlns="http://docbook.org/ns/docbook"><para> Починаючи з PHP 8.1.0,
параметр, що не є рядком — застарів. У майбутньому параметр вважатиметься
виключно рядком, а не кодом символу з ASCII. Залежно від наміченої поведінки,
параметр буде або приведено до &string;, або явно опрацьовано функцією
<function>chr</function>.</para></warning>'>
<!ENTITY ctype.result.empty-string
'Якщо викликано з порожнім рядком — результатом буде &false;.'>
<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.1.0</entry>
<entry>
Тепер параметр <parameter>ftp</parameter> має бути примірником
<classname>FTP\Connection</classname>. Раніше очікувався &resource;.
</entry>
</row>'>
<!ENTITY ftp.parameter.ftp
'<para xmlns="http://docbook.org/ns/docbook">Примірник
<classname>FTP\Connection</classname>.</para>'>
<!-- GMP Notes -->
<!ENTITY gmp.return
'GMP-номер типу <type xmlns="http://docbook.org/ns/docbook">resource</type> в
PHP 5.5 і старіших версіях, або об&apos;єкт <classname
xmlns="http://docbook.org/ns/docbook">GMP</classname> в PHP 5.6 і новіших.'>
<!ENTITY gmp.parameter
'<para xmlns="http://docbook.org/ns/docbook">GMP-номер типу
<type>resource</type> в PHP 5.5 та старіших версіях, об&apos;єкт
<classname>GMP</classname> в PHP 5.6 та новіших, або ж числовий рядок за
можливості перетворення останнього на число.</para>'>
<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Тільки процедурний стиль:
об&apos;єкт <classname>mysqli_result</classname>, якого повертає одна з функцій
<function>mysqli_query</function>, <function>mysqli_store_result</function>,
<function>mysqli_use_result</function> або
<function>mysqli_stmt_get_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><para>Тільки процедурний стиль:
об&apos;єкт <classname>mysqli</classname>, якого повертає функція
<function>mysqli_connect</function> або
<function>mysqli_init</function></para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>statement</parameter></term><listitem><para>Тільки процедурний стиль:
об&apos;єкт <classname>mysqli_stmt</classname>, якого повертає функція
<function>mysqli_stmt_init</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd
'Доступно тільки з <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note
'<note xmlns="http://docbook.org/ns/docbook"><para>MySQLnd завжди використовує
стандартне кодування символів на сервері. Це кодування надсилається на етапі
з&apos;єднання/автентифікації, які використовує
mysqlnd.</para><para>Libmysqlclient використовує кодування символів, вказане у
файлі <filename>my.cnf</filename>, або явним викликом функції
<function>mysqli_options</function> перед викликом
<function>mysqli_real_connect</function>, але після
<function>mysqli_init</function>.</para></note>'>
<!ENTITY mysqli.integer.overflow.as.string.note
'<note xmlns="http://docbook.org/ns/docbook"><para>Якщо кількість рядків
перевищує <constant>PHP_INT_MAX</constant>, вона буде повернена як
&string;.</para></note>'>
<!ENTITY mysqli.sqlinjection.warning
'<warning xmlns="http://docbook.org/ns/docbook"><title>Попередження з безпеки:
SQL-ін&apos;єкція</title><para>Якщо рядок запиту має містити введені
користувачем значення, то потрібно виконати <link
linkend="mysqli.quickstart.prepared-statements">підготовлений запит</link>. Або
ж дані мають бути правильно відформатовані, а всі рядки — екрановані функцією
<function>mysqli_real_escape_string</function>.</para></warning>'>
<!ENTITY mysqli.conditionalexception
'<para xmlns="http://docbook.org/ns/docbook"> Якщо увімкнені звіти про помилки
mysqli (<constant>MYSQLI_REPORT_ERROR</constant>) і запитана операція не
виконалась, буде виведено попередження, але якщо встановлено режим
<constant>MYSQLI_REPORT_STRICT</constant>, буде викинуто виключення
<classname>mysqli_sql_exception</classname>.</para>'>
<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning
'<para xmlns="http://docbook.org/ns/docbook">Якщо задано хибний шаблон
регулярного виразу, виведеться повідомлення рівня
<constant>E_WARNING</constant>.</para>'>
<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module
'<simpara xmlns="http://docbook.org/ns/docbook">Ця функція доступна, якщо PHP
встановлено як модуль вебсервера Apache.</simpara>'>
<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro
'<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager) — це
основна реалізація PHP FastCGI з деякими додатковими можливостями, корисними
(здебільшого) для високо-навантажених сайтів.</para>'>
<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration
'<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML створив правило
додавання ітеративних властивостей до більшості методів. Їх не можна побачити за
допомогою <function>var_dump</function> або іншими способами дослідження
об&apos;єктів.</simpara></note>'>
<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold
'<para xmlns="http://docbook.org/ns/docbook">Назви стовпців, що повертаються,
коли увімкнено опцію <constant>SQLITE_ASSOC</constant> або
<constant>SQLITE_BOTH</constant>, буде впорядковано відповідно до значення
директиви <link linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>.</para>'>
<!ENTITY sqlite.decode-bin
'<para xmlns="http://docbook.org/ns/docbook">Якщо парареметр
<parameter>decode_binary</parameter> дорівнює &true; (стандартно), PHP декодує
двійкові дані, ніби вони були закодовані функцією
<function>sqlite_escape_string</function>. Якщо немає взаємодії з базами
даних, створених програмами, що підтримують SQLite, то краще залишити стандартне
значення.</para>'>
<!ENTITY sqlite.no-unbuffered
'<note xmlns="http://docbook.org/ns/docbook"><para>Цю функцію не можна
використовувати з небуферизованими дескрипторами результатів.</para></note>'>
<!ENTITY sqlite.param-compat
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Для сумісності з іншими
розширеннями баз даних (як от MySQL) підтримуються два синтаксиси. Кращою формою
є перша, де параметр <parameter>dbhandle</parameter> є першим параметром
функції.</simpara></note>'>
<!ENTITY sqlite.result-type
'<para xmlns="http://docbook.org/ns/docbook">Необов&apos;язковий параметр
<parameter>result_type</parameter> має бути константою, що вказує, як
індексувати масив, що повертається. Якщо задано
<constant>SQLITE_ASSOC</constant>, то повернуться асоціативні індекси
(названі поля); якщо <constant>SQLITE_NUM</constant>, то повернуться числові
індекси (порядкові номери полів); якщо <constant>SQLITE_BOTH</constant>, то і
числові, і асоціативні індекси. Стандартною для цієї функції є константа
<constant>SQLITE_BOTH</constant>.</para>'>
<!-- Database Notes -->
<!ENTITY database.field-case
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція є
<emphasis>чутливою до регістру</emphasis> назв полів.</simpara></note>'>
<!ENTITY database.fetch-null
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція встановлює
NULL-полям значення PHP &null;.</simpara></note>'>
<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>З&apos;єднання
MySQL. Якщо не задано, буде обрано останнє з&apos;єднання, встановлене функцією
<function>mysql_connect</function>. Якщо з&apos;єднатися не вдалось, функція
спробує встановити нове, ніби викликавши функцію
<function>mysql_connect</function> без параметрів. Якщо з&apos;єднання не
вдалося знайти або встановити, буде виведено повідомлення рівня
<constant>E_WARNING</constant></para></listitem></varlistentry>'>
<!ENTITY mysql.linkid-noreopen.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>З&apos;єднання
MySQL. Якщо не задано, буде обрано останнє з&apos;єднання, встановлене функцією
<function>mysql_connect</function>. Якщо з&apos;єднання не вдалося знайти або
встановити, буде виведено повідомлення рівня
<constant>E_WARNING</constant></para></listitem></varlistentry>'>
<!ENTITY mysql.result.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Результат типу
<type>resource</type> для опрацювання, якого повертає функція
<function>mysql_query</function>.</para></listitem></varlistentry>'>
<!ENTITY mysql.field-offset.req.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Числовий зсув поля.
Значення <parameter>field_offset</parameter> починається з <literal>0</literal>.
Якщо зсуву <parameter>field_offset</parameter> не існує, буде виведено
повідомлення рівня
<constant>E_WARNING</constant>.</para></listitem></varlistentry>'>
<!ENTITY mysql.alternative.note
'<para xmlns="http://docbook.org/ns/docbook">Це розширення застаріле, починаючи
з PHP 5.5.0, та вилучене з PHP 7.0.0. Натомість використовуються розширення
<link linkend="book.mysqli">MySQLi</link> або
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Докладніше описано у керівництві
<link linkend="mysqlinfo.api.choosing">MySQL: вибір API</link>.
Цю функцію можна замінити на:</para>'>
<!ENTITY mysql.alternative.note.4-3-0
'<para xmlns="http://docbook.org/ns/docbook">Ця функція застаріла, починаючи з
PHP 4.3.0, та разом з <link linkend="book.mysql">початковим розширенням
MySQL</link> була вилучена з PHP 7.0.0. Краще використати розширення
<link linkend="book.mysqli">MySQLi</link> або
<link linkend="ref.pdo-mysql">PDO_MySQL</link>, які жваво розробляються.
Докладніше описано у керівництві <link linkend="mysqlinfo.api.choosing">MySQL:
вибір API</link>. Цю функцію можна замінити на:</para>'>
<!ENTITY mysql.alternative.note.5-3-0
'<para xmlns="http://docbook.org/ns/docbook">Ця функція застаріла, починаючи з
PHP 5.3.0, та разом з <link linkend="book.mysql">початковим розширенням
MySQL</link> була вилучена з PHP 7.0.0. Краще використати розширення
<link linkend="book.mysqli">MySQLi</link> або
<link linkend="ref.pdo-mysql">PDO_MySQL</link>, які жваво розробляються.
Докладніше описано у керівництві <link linkend="mysqlinfo.api.choosing">MySQL:
вибір API</link>. Цю функцію можна замінити на:</para>'>
<!ENTITY mysql.alternative.note.5-4-0
'<para xmlns="http://docbook.org/ns/docbook">Ця функція застаріла, починаючи з
PHP 5.4.0, та разом з <link linkend="book.mysql">початковим розширенням
MySQL</link> була вилучена з PHP 7.0.0. Краще використати розширення
<link linkend="book.mysqli">MySQLi</link> або
<link linkend="ref.pdo-mysql">PDO_MySQL</link>, які жваво розробляються.
Докладніше описано у керівництві <link linkend="mysqlinfo.api.choosing">MySQL:
вибір API</link>. Цю функцію можна замінити на:</para>'>
<!ENTITY mysql.alternative.note.5-5-0
'<para xmlns="http://docbook.org/ns/docbook">Ця функція застаріла, починаючи з
PHP 5.5.0, та разом з <link linkend="book.mysql">початковим розширенням
MySQL</link> була вилучена з PHP 7.0.0. Краще використати розширення
<link linkend="book.mysqli">MySQLi</link> або
<link linkend="ref.pdo-mysql">PDO_MySQL</link>, які жваво розробляються.
Докладніше описано у керівництві <link linkend="mysqlinfo.api.choosing">MySQL:
вибір API</link>. Цю функцію можна замінити на:</para>'>
<!ENTITY mysql.close.connections.result.sets
'<para xmlns="http://docbook.org/ns/docbook">
Відкриває непостійні з&apos;єднання MySQL, а набори результатів автоматично
знищує, коли PHP-скрипт завершується. Та незважаючи на те, що явне закриття
з&apos;єднань і очищення наборів результатів необов&apos;язкове, робити це
рекомендується. Це негайно вивільнить ресурси PHP та MySQL, а отже покращить
продуктивність. Докладніше:
<link linkend="language.types.resource.self-destruct">Вивільнення
ресурсів</link></para>'>
<!-- Xattr entities -->
<!ENTITY xattr.namespace
'<para xmlns="http://docbook.org/ns/docbook">Розширені атрибути мають два різні
простори імен: "user" і "root". Простір "user" доступний усім користувачам, а
"root" тільки тим, хто має root-права. xattr початково працює в просторі імен
"user", але це можна змінити за допомогою параметра
<parameter>flags</parameter>.</para>'>
<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Вказуючи числову
IPv6-адресу (напр. <literal>fe80::1</literal>), необхідно взяти IP-адресу в
квадратні дужки, наприклад,
<literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>
<!-- Notes for tidy -->
<!ENTITY tidy.object 'Об&apos;єкт <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>.'>
<!ENTITY tidy.conf-enc
'<para xmlns="http://docbook.org/ns/docbook">Параметр
<parameter>config</parameter>, що може бути як масивом, так і рядком. Рядок буде
вважатися назвою файлу налаштувань, а масив - власне налаштуваннями. Пояснення
всіх опцій є на сторінці <link xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="&url.tidy.conf;">&url.tidy.conf;</link>.</para><para>Параметр
<parameter>encoding</parameter>, яким вказується кодування вхідних/опрацьованих
документів. Можливі значення для <parameter>encoding</parameter>:
<literal>ascii</literal>, <literal>latin0</literal>, <literal>latin1</literal>,
<literal>raw</literal>, <literal>utf8</literal>, <literal>iso2022</literal>,
<literal>mac</literal>, <literal>win1252</literal>, <literal>ibm858</literal>,
<literal>utf16</literal>, <literal>utf16le</literal>,
<literal>utf16be</literal>, <literal>big5</literal> або
<literal>shiftjis</literal>.</para>'>
<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat
'<warning xmlns="http://docbook.org/ns/docbook"><para>Ми не рекомендуємо
використовувати потоковий MPM у виробничому середовищі з Apache 2.
Замість нього краще обрати prefork MPM, який початково йде з Apache 2.0 та 2.2.
Докладніше — у розділі <link linkend="faq.installation.apache2">Apache 2 з
потоковим MPM</link></para></warning>'>
<!ENTITY warn.install.third-party-support
'<warning xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<para>
Збірки від сторонніх розробників вважаються неофіційними і безпосередньо
проектом PHP не підтримуються. Про знайдені вади, якщо вони не можуть бути
відтворені на <link xlink:href="&url.php.downloads;">офіційних збірках</link>,
необхідно повідомляти постачальників цих неофіційних збірок.
</para>
</warning>'>
<!ENTITY note.apache.slashes
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Варто зауважити, що у
файлі налаштувань Apache на Windows значення шляху (напр.
<filename>c:\directory\file.ext</filename>) мають містити звичайні слеші, а не
зворотні: <filename>c:/directory/file.ext</filename>. Слеш в кінці також є
обов&apos;язковим, коли шлях веде до теки.</simpara></note>'>
<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Автори та помічники'>
<!ENTITY Credit.Introduction
'<para xmlns="http://docbook.org/ns/docbook"> Є багато розробників, які
допомагають нам зараз або дуже допомогли в минулому. Також є багато тих, що
допомагають нам користувацькими замітками на сторінках посібника, які постійно
включаються в основну документацію. Всі списки нижче
впорядковані за алфавітом.
</para>'>
<!ENTITY Credit.Authors.and.Editors 'Автори та редактори'>
<!ENTITY Credit.Past.Authors.Text 'Варто відзначити наступних учасників, які
внесли значний вклад та/або продовжують це робити, додаючи
матеріал до посібника:'>
<!ENTITY Credit.Past.Editors.Text 'Наступні учасники зробили значний внесок
до редагування посібника:'>
<!ENTITY Credit.Note.Editors.Title 'Редактори заміток користувачів'>
<!ENTITY Credit.Note.Editors.Active 'Поточні найактивніші редактори:'>
<!ENTITY Credit.Note.Editors.Inactive 'Ці люди також доклали чимало зусиль,
редагуючи замітки користувачів:'>
<!ENTITY listendand ' та'>
<!-- runkit entities -->
<!ENTITY note.runkit.selfmanipulation
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Цю функцію не можна
використати для впливу на метод (чи ланцюжок методів), що
виконується.</simpara></note>'>
<!ENTITY note.runkit.internal-override
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Зазвичай тільки
користувацькі функції можна вилучати, переназивати чи змінювати. Проте, якщо
увімкнути директиву <literal>runkit.internal_override</literal> в
&php.ini;, то стане можливо перевизначати вбудовані функції.</simpara>
</note>'>
<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Підсистема публічних
ключів використовується для керування публічними ключами сервера, на якому
клієнт <emphasis>вже</emphasis> пройшов автентифікацію. Натомість для
автентифікації у віддаленій системі за допомогою публічного ключа застосовується
функція <function>ssh2_auth_pubkey_file</function>.</simpara></note>'>
<!-- Session notes -->
<!ENTITY returns.session.storage.retval
'Результат (зазвичай &true; у разі успіху, &false; у разі невдачі). Варто
зазначити, що значення повертається до PHP для внутрішньої обробки.'>
<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>writer</parameter></term><listitem><para>Тільки для процедурних
викликів. Примірник <classname>XMLWriter</classname>, що буде оброблятися. Цей
об&apos;єкт повертається функцією <function>xmlwriter_open_uri</function> або
<function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>
<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер <parameter>writer</parameter> має бути примірником
<classname>XMLWriter</classname>. Раніше очікувався <type>resource</type>.
</entry>
</row>'>
<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Ця функція працює тільки в режимі WSDL.</para></note>">
<!-- Stomp notes -->
<!ENTITY stomp.param.link
"<varlistentry xmlns='http://docbook.org/ns/docbook'><term>
<parameter>link</parameter></term><listitem><para>Тільки процедурний стиль:
Ідентифікатор з'єднання Stomp, якого повертає функція
<function>stomp_connect</function>.</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers
"<varlistentry xmlns='http://docbook.org/ns/docbook'><term>
<parameter>headers</parameter></term><listitem><para>Асоціативний масив, що
містить додаткові заголовки (наприклад:
&quot;receipt&quot;).</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction
"<note xmlns='http://docbook.org/ns/docbook'><para>Можна вказати заголовок
транзакції, який сигналізує, що підтвердження повідомлення має бути частиною
названої транзакції.</para></note>">
<!ENTITY stomp.note.sync
"<tip xmlns='http://docbook.org/ns/docbook'><simpara>Stomp за своєю суттю є
асинхронним. Синхронні з'єднання можна встановлювати, додавши заголовок
&quot;receipt&quot;. Це призведе до того, що методи нічого не повертатимуть,
доки сервер не підтвердить отримання повідомлення або доки не мине час
очікування читання.</simpara></tip>">
<!-- SVN notes -->
<!ENTITY svn.relativepath
"<note xmlns='http://docbook.org/ns/docbook'><simpara>Відносні шляхи
розкриваються так, ніби поточною текою є та, що містить виконуваний файл PHP.
Щоб використовувати теку, в якій виконується скрипт, застосовується функція
<function>realpath</function> або dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status
'Інформація про допустимі значення є на сторінці <link
xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">Константи
статусу</link>.'>
<!ENTITY svn.referto.type
'Інформація про допустимі значення є на сторінці <link
xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">Константи
типу</link>.'>
<!-- FANN notes -->
<!ENTITY fann.ann.description
'<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
нейронної мережі.</para>'>
<!ENTITY fann.train.description
'<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
навчальних даних нейронної мережі.</para>'>
<!ENTITY fann.errdat.description
'<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
нейронної мережі або навчальних даних нейронної мережі.</para>'>
<!ENTITY fann.return.void
'<para xmlns="http://docbook.org/ns/docbook">Значення не повертається.</para>'>
<!ENTITY fann.return.bool
'<para xmlns="http://docbook.org/ns/docbook">Повертає &true; у разі успіху або
&false; у разі невдачі.</para>'>
<!ENTITY fann.return.ann
'<para xmlns="http://docbook.org/ns/docbook">Повертає ресурс
(<type>resource</type>) нейронної мережі у разі успіху або &false; у разі
помилки.</para>'>
<!ENTITY fann.return.train
'<para xmlns="http://docbook.org/ns/docbook">Повертає ресурс
(<type>resource</type>) тренувальних даних у разі успіху або &false; у разі
помилки.</para>'>
<!ENTITY fann.note.function.fann-2.2
'<note xmlns="http://docbook.org/ns/docbook"><para>Ця функція доступна тільки,
якщо розширення fann зібрано разом з libfann &gt;= 2.2.</para></note>'>
<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Повертає &true; в разі успіху.'>
<!ENTITY imagick.imagick.throws 'Кидає ImagickException в разі помилки.'>
<!ENTITY imagick.imagickdraw.throws 'Кидає ImagickDrawException в разі помилки.'>
<!ENTITY imagick.imagickpixel.throws 'Кидає ImagickPixelException в разі помилки.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Кидає ImagickPixelIteratorException в разі помилки.'>
<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.2.9 або новішою.'>
<!ENTITY imagick.method.available.0x631 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.1 або новішою.'>
<!ENTITY imagick.method.available.0x632 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.2 або новішою.'>
<!ENTITY imagick.method.available.0x636 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.6 або новішою.'>
<!ENTITY imagick.method.available.0x637 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.7 або новішою.'>
<!ENTITY imagick.method.available.0x638 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.8 або новішою.'>
<!ENTITY imagick.method.available.0x639 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.3.9 або новішою.'>
<!ENTITY imagick.method.available.0x640 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.0 або новішою.'>
<!ENTITY imagick.method.available.0x641 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.1 або новішою.'>
<!ENTITY imagick.method.available.0x642 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.2 або новішою.'>
<!ENTITY imagick.method.available.0x643 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.3 або новішою.'>
<!ENTITY imagick.method.available.0x644 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.4 або новішою.'>
<!ENTITY imagick.method.available.0x645 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.5 або новішою.'>
<!ENTITY imagick.method.available.0x647 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.7 або новішою.'>
<!ENTITY imagick.method.available.0x649 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.4.9 або новішою.'>
<!ENTITY imagick.method.available.0x653 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.5.3 або новішою.'>
<!ENTITY imagick.method.available.0x657 'Цей метод доступний, якщо Imagick зібраний з ImageMagick версії 6.5.7 або новішою.'>
<!ENTITY imagick.method.not.available.0x700 'Цей метод не доступний, якщо Imagick зібраний з ImageMagick версії 7.0.0 або новішою.'>
<!ENTITY imagick.constant.available 'Ця константа доступна, якщо Imagick зібраний з ImageMagick версії '>
<!ENTITY imagick.deprecated.function-3-4-4
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ЗАСТАРІЛА</emphasis> починаючи з Imagick 3.4.4. Вкрай не
рекомендується на неї покладатися.</simpara></warning>'>
<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info
'Стандартно — <constant
xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Див.
список <link xmlns="http://docbook.org/ns/docbook"
linkend="imagick.constants.channel">констант каналу</link>.'>
<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz
'Міра уподібнення кольорів. Наприклад, якщо значення fuzz дорівнює 10, то
червоний колір з насиченістю від 100 до 102 тепер вважатиметься одним
кольором.'>
<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel
'Константа каналу, дійсна для поточного режиму каналу. Для застосування її до
кількох каналів необхідно поєднати <link
xmlns="http://docbook.org/ns/docbook"
linkend="imagick.constants.channel">константи каналу</link> побітовими
операторами. &imagick.default.channel.info;'>
<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'Рівень прозорості: 1.0 — непрозорий і 0.0 — повністю прозорий.'>
<!ENTITY imagick.imagickexception.throw 'Викидає
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname>
у разі помилки.'>
<!ENTITY imagick.bestfit.note
'<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Поведінка параметра <parameter>bestfit</parameter> змінилася в Imagick 3.0.0.
Раніше він не діяв на зображення розмірів 400x400 та 200x150. Починаючи з
Imagick 3.0.0, такі зображення отримають розмір 400x300, оскільки це "найкраще
підходить" для заданих розмірів. Якщо параметр <parameter>bestfit</parameter>
використовується, необхідно вказати як висоту, так і ширину.
</simpara>
</note>'>
<!ENTITY note.openssl.cnf
'<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Для правильної роботи цієї функції необхідно встановити коректний файл
<filename>openssl.cnf</filename>. Докладніше про це — у примітках розділу про
<link linkend="openssl.installation">Встановлення OpenSSL</link>.
</simpara>
</note>'>
<!ENTITY note.openssl.param-notext
'<para xmlns="http://docbook.org/ns/docbook">
Необов&apos;язковий параметр <parameter>notext</parameter> впливає на кількість
тексту у виводі. Якщо дорівнює &false;, то до виводу буде включена додаткова
зрозуміла людині інформація. Початковим значенням параметра
<parameter>notext</parameter> є &true;.
</para>'>
<!-- COM/Dotnet -->
<!ENTITY com.variant-arith
'<note xmlns="http://docbook.org/ns/docbook">
<para>
Як і у всіх інших варіантних арифметичних функцій, параметри цієї функції
можуть мати PHP-тип (ціле число, рядок, десятковий дріб, логічний або &null;)
або бути примірником класу COM, VARIANT чи DOTNET. Типи, вбудовані в PHP,
будуть перетворені у "варіанти" за правилами, описаними в конструкторі класу
<xref linkend="class.variant"/>. В об&apos;єктів COM і DOTNET значеннями
"варіантів" будуть початкові значення властивостей цих об&apos;єктів.
</para>
<para>
Варіантні арифметичні функції є надбудовами однойменних функцій бібліотеки COM.
Докладніша інформація про ці функції є в документації до бібліотеки MSDN.
Функції в PHP називаються дещо інакше, ніж в бібліотеці MDSN. Наприклад,
<function>variant_add</function> в PHP відповідає <literal>VarAdd()</literal> в
MSDN.
</para>
</note>
'>
<!-- phar -->
<!ENTITY phar.write
'<note xmlns="http://docbook.org/ns/docbook"><para>Для роботи з об&apos;єктами
<classname>Phar</classname> цей метод потребує, щоб директива &php.ini;
<literal>phar.readonly</literal> мала значення <literal>0</literal>. Інакше буде
викинуто <classname>PharException</classname>.</para></note>'>
<!ENTITY phar.note.performance
'<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Методи <function>Phar::addFile</function>,
<function>Phar::addFromString</function> і
<function>Phar::offsetSet</function> зберігають новий phar-архів після кожного
виклику. Якщо важлива продуктивність, то натомість необхідно використовувати
<function>Phar::buildFromDirectory</function> або
<function>Phar::buildFromIterator</function>.
</simpara>
</note>'>
<!ENTITY phardata.note.performance
'<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Методи <function>PharData::addFile</function>,
<function>PharData::addFromString</function> і
<function>PharData::offsetSet</function> зберігають новий phar-архів після
кожного виклику. Якщо важлива продуктивність, то натомість необхідно
використовувати <function>PharData::buildFromDirectory</function> або
<function>PharData::buildFromIterator</function>.
</simpara>
</note>'>
<!-- XML -->
<!ENTITY libxml.required
'<para xmlns="http://docbook.org/ns/docbook">
Це розширення потребує підключеного PHP-розширення
<link linkend="book.libxml">libxml</link>. Отже, команда конфігурації має
містити прапорець <option role="configure">--with-libxml</option> (для версій,
старіших за PHP 7.4 — <option role="configure">--enable-libxml</option>), хоча
це все одно виконується неявно, бо libxml є стандартним розширенням.
</para>'>
<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note
'<caution xmlns="http://docbook.org/ns/docbook"><para>Ця функція доступна тільки,
якщо PHP зібрано разом з libxml версії 20620 або новішою.</para></caution>'>
<!-- inotify -->
<!ENTITY inotify.instance.description
'Ресурс, що повертається функцією
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>
<!-- User streams -->
<!ENTITY userstream.not.implemented.warning
'<para xmlns="http://docbook.org/ns/docbook">Виводить
<constant>E_WARNING</constant>, якщо цей метод не вдалося викликати (напр. не
реалізований).</para>'>
<!ENTITY userstream.updates.context
'<note xmlns="http://docbook.org/ns/docbook"><para>Властивість
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
оновиться, якщо передано правильний контекст до функції виклику.</para></note>'>
<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Повертає &true; в разі успіху.'>
<!ENTITY gmagick.gmagickexception.throw 'Викидає
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> у
разі помилки.'>
<!-- Reflection -->
<!ENTITY reflection.export.return
'Якщо параметр <parameter
xmlns="http://docbook.org/ns/docbook">return</parameter> дорівнює &true;, то
то повернеться рядок (<type
xmlns="http://docbook.org/ns/docbook">string</type>), а інакше — &null;.'>
<!ENTITY reflection.export.param.return
'Якщо задано &true;, результат буде повернено, а якщо &false; (початково), то
результат буде виведено.'>
<!ENTITY reflection.invoke.reference
'У переданому списку параметрів мають бути посилання, якщо функція очікує
параметри-посилання.'>
<!ENTITY reflection.export.param.name
'Об&apos;єкт <classname
xmlns="http://docbook.org/ns/docbook">Reflection</classname>, що експортується.'>
<!ENTITY reflection.getattributes.param.name
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
<para>
Повернути примірники <classname>ReflectionAttribute</classname> для атрибутів
з даною назвою класу.
</para>
</listitem>
</varlistentry>'>
<!ENTITY reflection.getattributes.param.flags
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
<para>
Прапорці, що визначають, як саме фільтрувати результати, якщо вказано параметр
<parameter>name</parameter>.
</para>
<para>
<literal>0</literal> (початкове значення) — повертаються результати для
атрибутів, які мають назву класу <parameter>name</parameter>.
</para>
<para>
<constant>ReflectionAttribute::IS_INSTANCEOF</constant> — повертаються
результати для атрибутів із застосуваннями <literal>instanceof</literal>.
</para>
</listitem>
</varlistentry>'>
<!-- SPL -->
<!ENTITY spl.datastructures.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Структури даних</title>'>
<!ENTITY spl.exceptions.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Виключення</title>'>
<!ENTITY spl.exceptions.intro '
<para xmlns="http://docbook.org/ns/docbook">
SPL містить набір стандартних виключень.
</para>
<para xmlns="http://docbook.org/ns/docbook">Також варто переглянути <xref
linkend="reserved.exceptions" />.
</para>
'>
<!ENTITY spl.files.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Обробка файлів</title>'>
<!ENTITY spl.files.intro
'<partintro xmlns="http://docbook.org/ns/docbook"><para>SPL містить набір класів
для роботи з файлами.</para></partintro>'>
<!ENTITY spl.interfaces.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Інтерфейси</title>'>
<!ENTITY spl.interfaces.intro
'<para xmlns="http://docbook.org/ns/docbook">SPL містить набір
інтерфейсів.</para><para xmlns="http://docbook.org/ns/docbook">Також варто
переглянути <xref linkend="reserved.interfaces" />.</para>'>
<!ENTITY spl.interfaces.list
'<title xmlns="http://docbook.org/ns/docbook">Список інтерфейсів</title>'>
<!ENTITY spl.iterators.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Ітератори</title>'>
<!ENTITY spl.iterators.intro
'<para xmlns="http://docbook.org/ns/docbook">SPL містить набір ітераторів для
проходження об&apos;єктів.</para>'>
<!ENTITY spl.misc.intro.title
'<title xmlns="http://docbook.org/ns/docbook">Різні класи та інтерфейси</title>'>
<!ENTITY spl.misc.intro
'<partintro xmlns="http://docbook.org/ns/docbook"><para>Класи та інтерфейси, які
не увійшли в жодну з категорій SPL.</para></partintro>'>
<!-- ZIP -->
<!ENTITY zip.filename.separator
'<note xmlns="http://docbook.org/ns/docbook"><simpara>Для найкращої сумісності
рекомендується завжди використовувати косу риску (<literal>/</literal>) як
роздільник тек в назвах ZIP-файлів.</simpara></note>'>
<!-- Win32Service -->
<!ENTITY win32service.false.error
', &false; якщо виникли складнощі з параметрами, або <link
xmlns="http://docbook.org/ns/docbook"
linkend="win32service.constants.errors">Код помилки Win32</link> у разі збою.'>
<!ENTITY win32service.success.false.error
'Повертає &true; у разі успіху&win32service.false.error;'>
<!ENTITY win32service.noerror.false.error
'повертається <constant
xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> у разі
успіху&win32service.false.error;'>
<!-- SNMP -->
<!ENTITY snmp.set.type.values
'<para xmlns="http://docbook.org/ns/docbook">
<acronym>MIB</acronym> дає означення типу для ID об&apos;єкта. Тип можна
вказувати одним з символів:
</para>
<table xmlns="http://docbook.org/ns/docbook">
<title>types</title>
<tgroup cols="2">
<tbody>
<row><entry>=</entry><entry>Тип, взятий з MIB</entry></row>
<row><entry>i</entry><entry>INTEGER</entry> </row>
<row><entry>u</entry><entry>INTEGER</entry></row>
<row><entry>s</entry><entry>STRING</entry></row>
<row><entry>x</entry><entry>HEX STRING</entry></row>
<row><entry>d</entry><entry>DECIMAL STRING</entry></row>
<row><entry>n</entry><entry>NULLOBJ</entry></row>
<row><entry>o</entry><entry>OBJID</entry></row>
<row><entry>t</entry><entry>TIMETICKS</entry></row>
<row><entry>a</entry><entry>IPADDRESS</entry></row>
<row><entry>b</entry><entry>BITS</entry></row>
</tbody>
</tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
Якщо під час компіляції бібліотеки <acronym>SNMP</acronym> задано
<constant>OPAQUE_SPECIAL_TYPES</constant>, будуть доступні наступні типи:
</para>
<table xmlns="http://docbook.org/ns/docbook">
<title>types</title>
<tgroup cols="2">
<tbody>
<row><entry>U</entry><entry>беззнаковий int64</entry></row>
<row><entry>I</entry><entry>знаковий int64</entry></row>
<row><entry>F</entry><entry>десятковий дріб (float)</entry></row>
<row><entry>D</entry><entry>десятковий дріб подвійної точності (double)</entry></row>
</tbody>
</tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping
'<para xmlns="http://docbook.org/ns/docbook">
Більшість з них мають зрозумілий ASN.1-тип. "s", "x", "d" та "b" вказують на
один тип — OCTET STRING, а беззнаковий тип "u" використовується для обробки
значень Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note
'<para xmlns="http://docbook.org/ns/docbook">
Якщо MIB-файли підключені до дерева MIB, бо вказані в налаштуваннях libsnmp або
за допомогою "snmp_read_mib", то потрібно задавати параметр
<parameter>type</parameter> зі значенням "=" для усіх ID об&apos;єктів,
оскільки тип можна автоматично зчитувати з MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note
'<para xmlns="http://docbook.org/ns/docbook">
Варто зазначити, що є два способи задати значення змінній, яка має тип BITS, як
от "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
<simpara>
Використавши тип "b" та список бітових чисел. Цей спосіб не рекомендований,
оскільки на GET-запит для однакових OID може бути відповідь, напр., 0xF8.
</simpara>
</listitem>
<listitem>
<simpara>
Використавши тип "x" та шістнадцяткове число, проте без(!) звичного префікса
"0x".
</simpara>
</listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
Докладніше це описано у параграфі з прикладами.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect
'<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
Стандартно цей метод не кидає виключення. Щоб увімкнути виключення
SNMPException у відповідь на помилки бібліотеки, полю
<parameter>exceptions_enabled</parameter> класу SNMP необхідно задати потрібне
значення. Докладніше: <link linkend="snmp.props.exceptions-enabled">пояснення
<parameter>SNMP::$exceptions_enabled</parameter></link>.
</para>
</refsect1>
'>
<!-- Eio -->
<!ENTITY eio.callback.proto
'<para xmlns="http://docbook.org/ns/docbook">
Функція <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter>
викликається після виконання запиту. Вона має відповідати наступному шаблону:
<programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>Користувацькі дані, що будуть в запиті.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>Значення результату, що стосується запиту; повертається
системним викликом.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>Необов&apos;язковий ресурс запиту, який використовують з такими
функціями, як <function>eio_get_last_error</function>.</para></listitem>
</varlistentry>
</variablelist>
</para>
'>
<!ENTITY eio.request.pri.values
'<para xmlns="http://docbook.org/ns/docbook">Пріоритет запиту: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant> або &null;.
Якщо параметру <parameter xmlns="http://docbook.org/ns/docbook">pri</parameter>
задано значення &null;, то пріоритетом буде
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>
<!ENTITY eio.warn.relpath
'<warning xmlns="http://docbook.org/ns/docbook"><simpara
xmlns="http://docbook.org/ns/docbook">Потрібно уникати відносних
шляхів</simpara></warning>
'>
<!ENTITY trader.arg.array.of.real 'Масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.high 'Найвища ціна, масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.low 'Найнижча ціна, масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.close 'Ціна під час закриття, масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.open 'Ціна під час відкриття, масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.volume 'Обсяг торгів, масив дійсних значень.'>
<!ENTITY trader.arg.array.of.real.periods 'Масив дійсних значень.'>
<!ENTITY trader.arg.penetration 'Відсоток проникнення одної свічки в іншу.'>
<!ENTITY trader.arg.vfactor 'Коефіцієнт обсягу. Допустимі значення від 1 до 0.'>
<!ENTITY trader.arg.time.period 'Число періоду. Допустимі значення від 2 до 100000.'>
<!ENTITY trader.arg.fast.period 'Число періоду для швидкого рухомого середнього (MA). Допустимі значення від 2 до 100000.'>
<!ENTITY trader.arg.slow.period 'Число періоду для повільного рухомого середнього (MA). Допустимі значеннян від 2 до 100000.'>
<!ENTITY trader.arg.signal.period 'Згладжування сигнальної лінії (число періоду). Допустимі значення від 1 до 100000.'>
<!ENTITY trader.arg.fastk.period 'Часовий проміжок побудови лінії Fast-K. Допустимі значення від 1 до 100000.'>
<!ENTITY trader.arg.fastd.period 'Згладжування для створення лінії Fast-D. Допустимі значення від 1 до 100000, зазвичай дорівнює 3.'>
<!ENTITY trader.arg.slowk.period 'Згладжування для створення лінії Slow-K. Допустимі значення від 1 до 100000, зазвичай дорівнює 3.'>
<!ENTITY trader.arg.slowd.period 'Згладжування для створення лінії Slow-D. Допустимі значення від 1 до 100000.'>
<!ENTITY trader.arg.min.period 'Значення менше за мінімальне, яке буде змінено на мінімальний період. Допустимі значення від 2 до 100000.'>
<!ENTITY trader.arg.max.period 'Значення вище за мінімальне, яке буде змінено на максимальний період. Допустимі значення від 2 до 100000.'>
<!ENTITY trader.arg.ma.type
'Тип рухомого середнього. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fast.ma.type
'Тип рухомого середнього для швидкого MA. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slow.ma.type
'Тип рухомого середнього для повільного MA. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fastd.ma.type
'Тип рухомого середнього для Fast-D. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.fastk.ma.type
'Тип рухомого середнього для Fast-K. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slowd.ma.type
'Тип рухомого середнього для Slow-D. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.slowk.ma.type
'Тип рухомого середнього для Slow-K. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.signal.ma.type
'Тип рухомого середнього для сигнальної лінії. Застовується одна з констант
<link xmlns="http://docbook.org/ns/docbook"
linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>
<!ENTITY trader.arg.nbdevup
'Коефіцієнт відхилення для верхньої межі. Допустимі значення від <link
xmlns="http://docbook.org/ns/docbook"
linkend="constant.trader-real-min">TRADER_REAL_MIN</link> до
<link xmlns="http://docbook.org/ns/docbook"
linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn
'Коефіцієнт відхилення для нижньої межі. Допустимі значення від <link
xmlns="http://docbook.org/ns/docbook"
linkend="constant.trader-real-min">TRADER_REAL_MIN</link> до
<link xmlns="http://docbook.org/ns/docbook"
linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Верхня межа адаптивного алгоритму. Допустимі значення від 0.01 до 0.99.'>
<!ENTITY trader.arg.slow.limit 'Нижня межа адаптивного алгоритму. Допустимі значення від 0.01 до 0.99.'>
<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
<row xmlns="http://docbook.org/ns/docbook">
<entry>PECL mongodb 1.15.0</entry>
<entry>
Типи значень, що повертаються методами, оголошеними, як попередні в PHP
8.0 та новіших версіях, викликають повідомлення про застарілий
функціонал в коді, що реалізує цей інтерфейс без оголошення відповідних
типів значень, що повертаються. Щоб приховати повідомлення про
застарілий функціонал, необхідно додати в код атрибут
<code>#[ReturnTypeWillChange]</code>.
</entry>
</row>
'>
<!ENTITY mongodb.option.collation '
<row xmlns="http://docbook.org/ns/docbook">
<entry>collation</entry>
<entry><type class="union"><type>array</type><type>object</type></type></entry>
<entry>
<para>
<link xlink:href="&url.mongodb.docs.collation;"
xmlns:xlink="http://www.w3.org/1999/xlink">Зіставлення</link>
дозволяє вказувати специфічні для мови правила порівняння рядків,
як от правила регістру та знаків наголосу. Під час визначення
зіставлень поле <literal>"locale"</literal> є обов&apos;язковим, а
всі інші поля — ні. Опис полів є на сторінці <link
xlink:href="&url.mongodb.docs.collation;#collation-document"
xmlns:xlink="http://www.w3.org/1999/xlink">Документ
зіставлення</link>.
</para>
<para>
Якщо зіставлення не вказано, то використовується стандартне
зіставлення для колекції, якщо воно вказано. Якщо ж ні, MongoDB
використовує просте двійкове порівняння, яке використовувалося в
попередніх версіях для порівняння рядків.
</para>
<para>
Цей параметр доступний у MongoDB 3.4+, тож його застосування у
старіших версіях викине виключення під час виконання.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.let '
<row xmlns="http://docbook.org/ns/docbook">
<entry>let</entry>
<entry><type class="union"><type>array</type><type>object</type></type></entry>
<entry>
<para>
Карта назв і значень параметрів. Значення мають бути константами
або закритими виразами, які не посилаються на поля документа. Тоді
параметри можуть бути доступні як змінні в контексті агрегатного
виразу (напр. <literal>$$var</literal>).
</para>
<para>
Цей параметр доступний у MongoDB 5.0+, тож його застосування у
старіших версіях викине виключення під час виконання.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
<row xmlns="http://docbook.org/ns/docbook">
<entry>keyVaultClient</entry>
<entry><classname>MongoDB\Driver\Manager</classname></entry>
<entry>Менеджер, який використовується для маршрутизації запитів
ключів даних до окремого кластера MongoDB. Початково використовується
поточний менеджер і кластер.</entry>
</row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
<row xmlns="http://docbook.org/ns/docbook">
<entry>keyVaultNamespace</entry>
<entry><type>string</type></entry>
<entry>Повна назва простору імен (напр.
<literal>"databaseName.collectionName"</literal>), що позначає
колекцію, яка містить усі ключі даних, що використовуються для
шифрування та дешифрування. Цей параметр є обов&apos;язковим.</entry>
</row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
<row xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<entry>kmsProviders</entry>
<entry><type>array</type></entry>
<entry>
<para>
Документ, що містить налаштування для одного або кількох
KMS-провайдерів, які використовуються для шифрування ключів даних.
Підтримувані провайдери: <literal>"aws"</literal>,
<literal>"azure"</literal>, <literal>"gcp"</literal>,
<literal>"kmip"</literal> і <literal>"local"</literal>. Цей параметр
є обов&apos;язковим.
</para>
<para>
Якщо вказано порожній документ для <literal>"aws"</literal>,
<literal>"azure"</literal> або <literal>"gcp"</literal>, драйвер
спробує налаштувати провайдера, використовуючи <link
xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Автоматичні
облікові дані</link>.
</para>
<para>
Формат для <literal>"aws"</literal> наступний:
</para>
<programlisting role="javascript">
<![CDATA[
aws: {
accessKeyId: <string>,
secretAccessKey: <string>,
sessionToken: <string (необов&apos;язковий)>
}
]]>
</programlisting>
<para>
Формат для <literal>"azure"</literal> наступний:
</para>
<programlisting role="javascript">
<![CDATA[
azure: {
tenantId: <string>,
clientId: <string>,
clientSecret: <string>,
identityPlatformEndpoint: <string (необов&apos;язковий)> // Початково: "login.microsoftonline.com"
}
]]>
</programlisting>
<para>
Формат для <literal>"gcp"</literal> наступний:
</para>
<programlisting role="javascript">
<![CDATA[
gcp: {
email: <string>,
privateKey: <base64 string>|<MongoDB\BSON\Binary>,
endpoint: <string (необов&apos;язковий)> // Початково: "oauth2.googleapis.com"
}
]]>
</programlisting>
<para>
Формат для <literal>"kmip"</literal> наступний:
</para>
<programlisting role="javascript">
<![CDATA[
kmip: {
endpoint: <string>
}
]]>
</programlisting>
<para>
Формат для <literal>"local"</literal> наступний:
</para>
<programlisting role="javascript">
<![CDATA[
local: {
// 96-байтний головний ключ, що застосовується для шифрування/дешифрування ключів даних
key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
</programlisting>
</entry>
</row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
<para xmlns="http://docbook.org/ns/docbook">
<table>
<title>Налаштування провейдера <literal>"aws"</literal></title>
<tgroup cols="3">
<thead>
<row>
<entry>Назва</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>region</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>key</entry>
<entry>string</entry>
<entry>Обов&apos;язковий. Amazon Resource Name (ARN) для AWS customer
master key (CMK).</entry>
</row>
<row>
<entry>endpoint</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Додатковий ідентифікатор хоста для надсилання
запитів KMS. Може містити номер порту.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para xmlns="http://docbook.org/ns/docbook">
<table>
<title>Налаштування провейдера <literal>"azure"</literal></title>
<tgroup cols="3">
<thead>
<row>
<entry>Назва</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>keyVaultEndpoint</entry>
<entry>string</entry>
<entry>Обов&apos;язковий. Хост (може бути з портом) (напр.
"example.vault.azure.net").</entry>
</row>
<row>
<entry>keyName</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>keyVersion</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Певна версія названого ключа. Стандартно
вказується версія головного ключа.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para xmlns="http://docbook.org/ns/docbook">
<table>
<title>Налаштування провейдера <literal>"gcp"</literal></title>
<tgroup cols="3">
<thead>
<row>
<entry>Назва</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>projectId</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>location</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>keyRing</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>keyName</entry>
<entry>string</entry>
<entry>Обов&apos;язковий.</entry>
</row>
<row>
<entry>keyVersion</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Певна версія названого ключа. Стандартно
вказується версія головного ключа.</entry>
</row>
<row>
<entry>endpoint</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Хост (може бути з портом) (напр.
"cloudkms.googleapis.com").</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para xmlns="http://docbook.org/ns/docbook">
<table>
<title>Налаштування провейдера <literal>"kmip"</literal></title>
<tgroup cols="3">
<thead>
<row>
<entry>Назва</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>keyId</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Унікальний ідентифікатор для 96-байтного
об&apos;єкта керування секретними даними KMIP. Якщо не вказано,
об&apos;єкт генерується випадковим чином.</entry>
</row>
<row>
<entry>endpoint</entry>
<entry>string</entry>
<entry>Необов&apos;язковий. Хост (може бути з портом).</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
<row xmlns="http://docbook.org/ns/docbook">
<entry>tlsOptions</entry>
<entry><type>array</type></entry>
<entry>
<para>
Документ, який містить налаштування TLS для одного або кількох
KMS-провайдерів. Підтримуються такі провайдери:
<literal>"aws"</literal>, <literal>"azure"</literal>,
<literal>"gcp"</literal> та <literal>"kmip"</literal>. Для кожного
провайдера можна задавати такі параметри:
</para>
<programlisting role="javascript">
<![CDATA[
<provider>: {
tlsCaFile: <string> (необов&apos;язковий),
tlsCertificateKeyFile: <string> (необов&apos;язковий),
tlsCertificateKeyFilePassword: <string> (необов&apos;язковий),
tlsDisableOCSPEndpointCheck: <bool> (необов&apos;язковий)
}
]]>
</programlisting>
</entry>
</row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
<row xmlns="http://docbook.org/ns/docbook">
<entry>maxCommitTimeMS</entry>
<entry>int</entry>
<entry>
<para>
Час (у мілісекундах), що відводиться на виконання однієї команди
<literal>commitTransaction</literal>.
</para>
<para>
Параметр <literal>maxCommitTimeMS</literal> повинен бути знаковим
32-бітним цілим числом, що рівне або більше за нуль.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.readConcern '
<row xmlns="http://docbook.org/ns/docbook">
<entry>readConcern</entry>
<entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
<entry>
<para>
Вимога щодо зчитування.
</para>
<para>
Цей параметр доступний в MongoDB 3.2+, тож його застосування у
старіших версіях викине виключення під час виконання.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.readPreference '
<row xmlns="http://docbook.org/ns/docbook">
<entry>readPreference</entry>
<entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
<entry>
<para>
Параметр читання для вибору сервера для операції.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.session '
<row xmlns="http://docbook.org/ns/docbook">
<entry>session</entry>
<entry><classname>MongoDB\Driver\Session</classname></entry>
<entry>
<para>
Сеанс, по&apos;язаний з операцією.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
<warning xmlns="http://docbook.org/ns/docbook">
<para>
Для сеансу (<literal>"session"</literal>) транзакції, яка триває, не
можна задати параметр <literal>"readConcern"</literal> або
<literal>"writeConcern"</literal>. Це призведе до викидання виключення
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.
Ці два параметри потрібно задавати під час створення транзакції методом
<methodname>MongoDB\Driver\Session::startTransaction</methodname>.
</para>
</warning>
'>
<!ENTITY mongodb.option.writeConcern '
<row xmlns="http://docbook.org/ns/docbook">
<entry>writeConcern</entry>
<entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
<entry>
<para>
Вимога щодо запису.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>namespace</parameter> (<type>string</type>)</term>
<listitem>
<para>
Повна назва простору імен (напр.
<literal>"databaseName.collectionName"</literal>).
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.db '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>db</parameter> (<type>string</type>)</term>
<listitem>
<para>
Назва бази даних, в якій буде виконано команду.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
<listitem>
<para>
Записи, які потрібно зробити.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.command '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
<listitem>
<para>
Команда, яку потрібно виконати.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.encryptOpts '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>options</parameter></term>
<listitem>
<para>
<table>
<title>Параметри шифрування</title>
<tgroup cols="3">
<thead>
<row>
<entry>Параметр</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>algorithm</entry>
<entry><type>string</type></entry>
<entry>
<para>
Алгоритм, що потрібно використати. Цей параметр обов&apos;язковий.
Дозволено вказувати одну з
<link linkend="mongodb-driver-clientencryption.constants">констант
ClientEncryption</link>:
</para>
<simplelist>
<member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
<member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
<member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
<member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
<member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant></member>
</simplelist>
</entry>
</row>
<row>
<entry>contentionFactor</entry>
<entry><type>int</type></entry>
<entry>
<para>
Фактор конкуренції виконання запитів із індексованим зашифрованим
корисним навантаженням.
</para>
<para>
Цей параметр застосовується тільки, якщо параметр
<literal>algorithm</literal> має значення
<constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
або
<constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
</para>
</entry>
</row>
<row>
<entry>keyAltName</entry>
<entry><type>string</type></entry>
<entry>
<para>
Визначає назву документа колекції з сховищем ключів за
<literal>keyAltName</literal>. Цей параметр є взаємовиключним з
<literal>keyId</literal>, тож потрібен саме один з них.
</para>
</entry>
</row>
<row>
<entry>keyId</entry>
<entry><classname>MongoDB\BSON\Binary</classname></entry>
<entry>
<para>
Визначає ключ даних за <literal>_id</literal>. Значенням має бути
UUID (двійковий підтип 4). Цей параметр є взаємовиключним з
<literal>keyAltName</literal>, тож потрібен саме один з них.
</para>
</entry>
</row>
<row>
<entry>queryType</entry>
<entry><type>string</type></entry>
<entry>
<para>
Тип запиту з індексованим зашифорваним корисним навантаженням.
Дозволено вказувати одну з
<link linkend="mongodb-driver-clientencryption.constants">констант
ClientEncryption</link>:
</para>
<simplelist>
<member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
<member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE</constant></member>
</simplelist>
<para>
Цей параметр застововується тільки, якщо параметр
<literal>algorithm</literal> має значення
<constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
або <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
</para>
</entry>
</row>
<row>
<entry>rangeOpts</entry>
<entry><type>array</type></entry>
<entry>
<para>
Параметри індексу для запиту зашифрованого поля, яке підтримує
"range"-запити. Параметри, що нижче, мають відповідати набору
значень в <literal>encryptedFields</literal> обраної колекції. Для
полів з BSON-типами "double", "decimal128", параметри
<literal>min</literal>, <literal>max</literal> та
<literal>precision</literal> потрібно задавати всі або жодного.
</para>
<para>
<table>
<title>Параметри індексу діапазону</title>
<tgroup cols="3">
<thead>
<row>
<entry>Параметр</entry>
<entry>Тип</entry>
<entry>Опис</entry>
</row>
</thead>
<tbody>
<row>
<entry>min</entry>
<entry><type>mixed</type></entry>
<entry>
Нижня межа діапазону, яка має BSON-значення. Параметр
обов&apos;язковий, якщо задано <literal>precision</literal>.
</entry>
</row>
<row>
<entry>max</entry>
<entry><type>mixed</type></entry>
<entry>
Верхня межа діапазону, яка має BSON-значення. Параметр
обов&apos;язковий, якщо задано <literal>precision</literal>.
</entry>
</row>
<row>
<entry>sparsity</entry>
<entry><type>int</type></entry>
<entry>Обов&apos;язковий. Додатнє ціле 64-бітне число.</entry>
</row>
<row>
<entry>precision</entry>
<entry><type>int</type></entry>
<entry>
Необов&apos;язковий. Додатнє ціле 32-бітне число, що вказує
точність явного шифрування. Можна задавати тільки для полів з
BSON-типами "double" або "decimal128".
</entry>
</row>
<row>
<entry>trimFactor</entry>
<entry><type>int</type></entry>
<entry>Необов&apos;язковий. Додатнє ціле 32-бітне число.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.query '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
<listitem>
<para>
Запит для виконання.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>typeMap</parameter> (<type>array</type>)</term>
<listitem>
<para>
<link linkend="mongodb.persistence.typemaps">Налаштування мапи типів</link>.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter>
(<type class="union"><type>array</type><type>object</type></type>)</term>
<listitem>
<para>
<link xlink:href="&url.mongodb.docs;tutorial/query-documents/"
xmlns:xlink="http://www.w3.org/1999/xlink">Предикат запиту</link>.
Порожній предикат відповідає всім документам у колекції.
</para>
<note>
<simpara>
Під час виконання критеріїв запиту MongoDB порівнює типи та значення за
власними <link
xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/"
xmlns:xlink="http://www.w3.org/1999/xlink">правилами порівняння
BSON-типів</link>, що відрізняється від правил
<link linkend="types.comparisons">порівняння</link> і
<link linkend="language.types.type-juggling">перетворення типів</link> в
PHP. Для вибірки даних спеціальних BSON-типів, критерії запиту повинні
використовувати відповідний <link linkend="mongodb.bson">клас BSON</link>
(напр. <classname>MongoDB\BSON\ObjectId</classname> для вибірки
<link xlink:href="&url.mongodb.docs.objectid;"
xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
</simpara>
</note>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.returns.cursor
'<para xmlns="http://docbook.org/ns/docbook">У разі успіху повертає примірника
<classname>MongoDB\Driver\Cursor</classname>.</para>'>
<!ENTITY mongodb.returns.writeresult
'<para xmlns="http://docbook.org/ns/docbook">У разі успіху повертає примірника
<classname>MongoDB\Driver\WriteResult</classname>.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern
'<member xmlns="http://docbook.org/ns/docbook">Якщо в транзакції параметр
<literal>"session"</literal> використано разом з параметром
<literal>"readConcern"</literal> або <literal>"writeConcern"</literal>,
викидається
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged
'<member xmlns="http://docbook.org/ns/docbook">Якщо використано параметр
<literal>"session"</literal>, а вимога щодо запису не задоволена, викидається
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception
'<member xmlns="http://docbook.org/ns/docbook">У разі невдалого запису
(наприклад, помилка запису, неможливість задовільнити вимогу щодо запису)
викидається <classname>MongoDB\Driver\Exception\BulkWriteException</classname>.</member>'>
<!ENTITY mongodb.throws.argumentparsing
'<member xmlns="http://docbook.org/ns/docbook">У разі помилки обробки параметрів
викидається
<classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.</member>'>
<!ENTITY mongodb.throws.authentication
'<member xmlns="http://docbook.org/ns/docbook">Якщо обов&apos;язкова
автентифікація провалена, то викидається
<classname>MongoDB\Driver\Exception\AuthenticationException</classname>.</member>'>
<!ENTITY mongodb.throws.connection
'<member xmlns="http://docbook.org/ns/docbook">Якщо не вдається з’єднатися з
сервером (з інших причин, ніж автентифікація), то викидається
<classname>MongoDB\Driver\Exception\ConnectionException</classname>.</member>'>
<!ENTITY mongodb.throws.bson.unexpected
'<member xmlns="http://docbook.org/ns/docbook">Якщо вхідні дані не містять точно
одного документа BSON, викидається
<classname>MongoDB\Driver\Exception\UnexpectedValueException</classname>.
Можливі причини: хибний BSON, надлишкові дані (після одного документу BSON) або
неочікувана помилка бібліотеки <link xlink:href="&url.mongodb.libbson;"
xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>
<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>
<!ENTITY mongodb.note.decimal128 '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Клас <classname>MongoDB\BSON\Decimal128</classname> доступний в MongoDB
3.4+. Спроба використати цей BSON-тип в старіших версіях MongoDB викличе
помилку.
</simpara>
</note>
'>
<!ENTITY mongodb.note.extended-json '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<simpara>
Вивід узгоджений з функцією <function>MongoDB\BSON\toJSON</function>, яка
використовує специфічний для драйвера застарілий розширений формат JSON. Це
не обов&apos;язково збігається з інтерпретаціями розширеного JSON, як от
<link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
або <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>,
що використовують функції
<function>MongoDB\BSON\toRelaxedExtendedJSON</function> і
<function>MongoDB\BSON\toCanonicalExtendedJSON</function>, відповідно.
</simpara>
</note>
'>
<!ENTITY mongodb.note.forking '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
На платформах Unix розширення чутливе до скриптів, які використовують
системний виклик fork() без виклику exec(). Користувачам пропонується не
використовувати повторно примірники
<classname>MongoDB\Driver\Manager</classname> у відгалужених підпроцесах.
</simpara>
</note>
'>
<!ENTITY mongodb.note.uint32 '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Через те, що у PHP цілочисельний тип є знаковим, деякі значення, що повертає
цей метод, можуть стати від&apos;ємними на 32-бітних платформах. Для подання
беззнакового десяткового значення як рядка, використовується функція
<function>sprintf</function> зі специфікатором <literal>"&#37;u"</literal>.
</simpara>
</note>
'>
<!ENTITY mongodb.note.server.readpreference '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Параметр <literal>"readPreference"</literal> впливає не на сервер, котрому
драйвер дає команду, а тільки на об&apos;єкт сервера. Натомість, під час
надсилання драйвером команди, цей параметр може забезпечувати відповідний
мережевий протокол для другорядного вузла з набору реплік, а також
встановлювати вимоги щодо читання для mongo-вузла.
</simpara>
</note>
'>
<!ENTITY mongodb.note.server.write '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
На програміста покладено роль визначити спроможність сервера
виконувати операції запису. До прикладу, операція запису на другорядному
вузлі (за винятком "локальної" БД) буде невдалою.
</simpara>
</note>
'>
<!ENTITY mongodb.warning.duplicate-keys '
<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
Технічно, BSON-документи можуть містити повторювані ключі, оскільки
зберігаються, як списки пар ключ-значення. Однак програми не повинні
створювати документи із дублікатами ключів, бо поведінка сервера та
драйвера може бути невизначеною. Також дані можуть бути пошкоджені під час
декодування BSON-документа, бо в PHP об&apos;єкти не можуть містити
повторювані назви властивостей, а масиви — дубльовані ключі.
</simpara>
</warning>
'>
<!-- Radius -->
<!ENTITY radius.request.required
'<note xmlns="http://docbook.org/ns/docbook"><para>Перед викликом цієї функції
потрібно створити запит за допомогою функції
<function>radius_create_request</function>.</para></note>'>
<!ENTITY radius.parameter.attribute-type
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>type</parameter></term><listitem><para>Тип
атрибута.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>radius_handle</parameter></term>
<listitem><para>RADIUS-ресурс.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>options</parameter></term><listitem><para>Бітова маска параметрів
атрибута. Доступні такі параметри:
<link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link>
і <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para>
</listitem></varlistentry>'>
<!ENTITY radius.parameter.tag
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>tag</parameter></term><listitem><para>Тег атрибуту. Якщо встановлено
параметр <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link>,
то цей параметр ігнорується.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>vendor</parameter></term><listitem><para>ID
постачальника.</para></listitem></varlistentry>'>
<!-- posix snippets -->
<!ENTITY posix.parameter.fd
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>file_descriptor</parameter></term>
<listitem>
<para>
Файловий дескриптор типу <type>resource</type> або <type>int</type>.
<type>int</type>-дескриптор вважається файловим дескриптором, який можна
передати безпосередньо основному системному виклику.
</para>
</listitem>
</varlistentry>'>
<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
З кожним процесом пов&apos;язані м&apos;які та жорсткі межі його ресурсів.
М&apos;яка межа — ефективний розмір ресурсу. Жорстка межа — це значення, до
якого процес може збільшити ефективний розмір ресурсу. Непривілейований процес
може змінювати свої м&apos;які межі, але жорсткі межі — лише зменшувати.
</para>
'>
<!-- strings snippets -->
<!ENTITY strings.stripped.characters '
<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
<simpara>
<literal>" "</literal>: символ <acronym>ASCII</acronym>
<acronym>SP</acronym> <literal>0x20</literal>, звичайний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\t"</literal>: символ <acronym>ASCII</acronym>
<acronym>HT</acronym> <literal>0x09</literal>, табуляція.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\n"</literal>: символ <acronym>ASCII</acronym>
<acronym>LF</acronym> <literal>0x0A</literal>, новий рядок.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\r"</literal>: символ <acronym>ASCII</acronym>
<acronym>CR</acronym> <literal>0x0D</literal>, повернення каретки.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\0"</literal>: символ <acronym>ASCII</acronym>
<acronym>NUL</acronym> <literal>0x00</literal>, NUL-байт.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\v"</literal>: символ <acronym>ASCII</acronym>
<acronym>VT</acronym> <literal>0x0B</literal>, вертикальна табуляція.
</simpara>
</listitem>
</itemizedlist>
'>
<!ENTITY strings.stripped.unicode '
<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
<simpara>
<literal>" "</literal> (<acronym>Unicode</acronym> U+0020), звичайний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009), табуляція.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\n"</literal> (<acronym>Unicode</acronym> U+000A), новий рядок.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\r"</literal> (<acronym>Unicode</acronym> U+000D), повернення каретки.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\0"</literal> (<acronym>Unicode</acronym> U+0000), NUL-байт.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\v"</literal> (<acronym>Unicode</acronym> U+000B), вертикальна табуляція.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\f"</literal> (<acronym>Unicode</acronym> U+000C), нова сторінка (form feed).
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u00A0"</literal> (<acronym>Unicode</acronym> U+00A0), нерозривний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u1680"</literal> (<acronym>Unicode</acronym> U+1680), огамський пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2000"</literal> (<acronym>Unicode</acronym> U+2000), EN QUAD (пропуск).
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2001"</literal> (<acronym>Unicode</acronym> U+2001), EM QUAD (пропуск).
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2002"</literal> (<acronym>Unicode</acronym> U+2002), пропуск розміром 1 en.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2003"</literal> (<acronym>Unicode</acronym> U+2003), пропуск розміром 1 em.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2004"</literal> (<acronym>Unicode</acronym> U+2004), пропуск розміром 1/3 em.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2005"</literal> (<acronym>Unicode</acronym> U+2005), пропуск розміром 1/4 em.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2006"</literal> (<acronym>Unicode</acronym> U+2006), пропуск розміром 1/6 em.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2007"</literal> (<acronym>Unicode</acronym> U+2007), фігурний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2008"</literal> (<acronym>Unicode</acronym> U+2008), пунктуаційний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2009"</literal> (<acronym>Unicode</acronym> U+2009), вузький пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u200A"</literal> (<acronym>Unicode</acronym> U+200A), дуже вузький пропуск .
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2028"</literal> (<acronym>Unicode</acronym> U+2028), роздільник-лінія.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u2029"</literal> (<acronym>Unicode</acronym> U+2029), роздільник-параграф.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u202F"</literal> (<acronym>Unicode</acronym> U+202F), вузький безперезвний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u205F"</literal> (<acronym>Unicode</acronym> U+205F), середній математичний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u3000"</literal> (<acronym>Unicode</acronym> U+3000), ідеографічний пропуск.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u0085"</literal> (<acronym>Unicode</acronym> U+0085), наступна лінія (NEL).
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"\u180E"</literal> (<acronym>Unicode</acronym> U+180E), монгольський роздільник голосних.
</simpara>
</listitem>
</itemizedlist>
'>
<!ENTITY strings.parameter.characters.optional '
<simpara xmlns="http://docbook.org/ns/docbook">
Символи, що треба вилучити, можна вказати за допомогою необов&apos;язкового
параметра <parameter>characters</parameter>. Необхідно просто записати туди
усі непотрібні символи. За допомогою <literal>..</literal> можна задати
діапазон символів за зростанням.
</simpara>
'>
<!ENTITY strings.parameter.unicode.optional '
<simpara xmlns="http://docbook.org/ns/docbook">
Символи, що треба вилучити, можна вказати за допомогою необов&apos;язкового
параметра <parameter>characters</parameter> Необхідно просто записати туди усі
непотрібні символи.
</simpara>
'>
<!ENTITY strings.parameter.encoding '
<para xmlns="http://docbook.org/ns/docbook">
Необов&apos;язковий параметр. Ним вказується кодування, що застосовуватиметься
під час перетворення символів.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Якщо пропущено, то параметр <parameter>encoding</parameter> отримає значення
директиви <link linkend="ini.default-charset">default_charset</link>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хоча технічно цей аргумент є необов&apos;язковим, але рекомендується вказати
в коді потрібне значення, оскільки директива <link
linkend="ini.default-charset">default_charset</link> може бути неправильною
для заданих вхідних даних.
</para>
'>
<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>format</parameter></term>
<listitem>
<para>
Рядок формату складається з нуля або більше директив: звичайних символів
(крім <literal>&#37;</literal>), які відображаються в результаті без змін, та
<emphasis>специфікаторів перетворення</emphasis>, для кожного з яких
задається свій параметр.
</para>
<para>
Специфікатор перетворення відповідає прототипу:
<literal>&#37;[argnum$][flags][width][.precision]specifier</literal>.
</para>
<formalpara>
<title>Номер параметра</title>
<para>
Ціле число, слідом за ним — знак долара <literal>$</literal>. Вказує
порядковий номер параметра для перетворення.
</para>
</formalpara>
<para>
<table>
<title>Прапорці</title>
<tgroup cols="2">
<thead>
<row>
<entry>Позначення</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>-</literal></entry>
<entry>
Вирівнює по лівому краю в межах заданої ширини. Праве вирівнювання
виконується автоматично.
</entry>
</row>
<row>
<entry><literal>+</literal></entry>
<entry>
Дописує до додатнього числа знак <literal>+</literal>. Знак мінуса до
від&apos;ємного числа дописується автоматично.
</entry>
</row>
<row>
<entry><literal> </literal> (пропуск)</entry>
<entry>
Доповнює результат пропусками. Також виконується автоматично.
</entry>
</row>
<row>
<entry><literal>0</literal></entry>
<entry>
Доповнює число нулями ліворуч. Разом зі специфікатором
<literal>s</literal> доповнює число нулями також праворуч.
</entry>
</row>
<row>
<entry><literal>&apos;</literal> (символ)</entry>
<entry>
Доповнює рядок символом (символ).
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<formalpara>
<title>Ширина</title>
<para>
Може бути цілим числом, що вказує найменшу кількість символів в значенні
після перетворення, або знак <literal>*</literal>. Якщо використано
знак <literal>*</literal>, то ширина вказується як додаткове ціле число,
що передує значенню, відформатованому специфікатором.
</para>
</formalpara>
<formalpara>
<title>Точність</title>
<para>
Крапка <literal>.</literal>, за якою (необов&apos;язково) слідує ціле число
чи знак <literal>*</literal>, значення якого залежить від специфікатора:
<itemizedlist>
<listitem>
<simpara>
Для специфікаторів <literal>e</literal>, <literal>E</literal>,
<literal>f</literal> і <literal>F</literal> — це кількість знаків, що
будуть надруковані після десяткового розділювача (початково: 6).
</simpara>
</listitem>
<listitem>
<simpara>
Для специфікаторів <literal>g</literal>, <literal>G</literal>,
<literal>h</literal> і <literal>H</literal> — найбільша допустима
кількість значущих цифр, що будуть надруковані.
</simpara>
</listitem>
<listitem>
<simpara>
Для специфікатора <literal>s</literal> — діє як точка відсікання,
встановлюючи максимальну кількість символів у рядку.
</simpara>
</listitem>
</itemizedlist>
<note>
<simpara>
Якщо крапку вказано без зазначення точності, тоді точністю вважатиметься
0. Якщо використано знак <literal>*</literal>, то точність вказується як
додаткове ціле число, що передує значенню, відформатованому специфікатором.
</simpara>
</note>
</para>
</formalpara>
<para>
<table>
<title>Специфікатори</title>
<tgroup cols="2">
<thead>
<row>
<entry>Назва</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>&#37;</literal></entry>
<entry>
Буквальний знак відсотка. Ніяких параметрів не потрібно.
</entry>
</row>
<row>
<entry><literal>b</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як двійкове число.
</entry>
</row>
<row>
<entry><literal>c</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як символ з таким
кодом ASCII.
</entry>
</row>
<row>
<entry><literal>d</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як знакове
десяткове число.
</entry>
</row>
<row>
<entry><literal>e</literal></entry>
<entry>
Параметр розглядається як експоненційний запис (напр. 1.2e+2).
</entry>
</row>
<row>
<entry><literal>E</literal></entry>
<entry>
Схожий до специфікатора <literal>e</literal>, але використовує знак
експоненти з великої букви (напр. 1.2E+2).
</entry>
</row>
<row>
<entry><literal>f</literal></entry>
<entry>
Параметр розглядається і відображається як десятковий дріб (з
урахуванням локалі).
</entry>
</row>
<row>
<entry><literal>F</literal></entry>
<entry>
Параметр розглядається і відображається як десятковий дріб (БЕЗ
урахування локалі).
</entry>
</row>
<row>
<entry><literal>g</literal></entry>
<entry>
<para>
Загальний формат.
</para>
<para>
Нехай <literal>P</literal> дорівнює точності, якщо вона не дорівнює
нулю, 6, якщо точність не вказано, або 1, якщо точність дорівнює нулю.
Тоді, якщо перетворення в стилі "E" матиме показник степеня
<literal>X</literal>:
</para>
<para>
Якщо P > X ≥ 4, перетворення буде в стилі "f" та з точністю P (X +
1). Інакше, перетворення буде в стилі "e" та з точністю P 1.
</para>
</entry>
</row>
<row>
<entry><literal>G</literal></entry>
<entry>
Схожий до специфікатора <literal>g</literal>, але використовує
<literal>E</literal> та <literal>f</literal>.
</entry>
</row>
<row>
<entry><literal>h</literal></entry>
<entry>
Схожий до специфікатора <literal>g</literal>, але використовує
<literal>F</literal>. Доступний, починаючи з PHP 8.0.0.
</entry>
</row>
<row>
<entry><literal>H</literal></entry>
<entry>
Схожий до специфікатора <literal>g</literal>, але використовує
<literal>E</literal> та <literal>F</literal>. Доступний, починаючи з
PHP 8.0.0.
</entry>
</row>
<row>
<entry><literal>o</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як вісімкове число.
</entry>
</row>
<row>
<entry><literal>s</literal></entry>
<entry>
Параметр розглядається і відображається як рядок.
</entry>
</row>
<row>
<entry><literal>u</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як беззнакове
десяткове число.
</entry>
</row>
<row>
<entry><literal>x</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як шіснадцяткове
число (з малими буквами).
</entry>
</row>
<row>
<entry><literal>X</literal></entry>
<entry>
Параметр розглядається як ціле число і відображається як шіснадцяткове
число (з великими буквами).
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<warning>
<para>
Специфікатор <literal>"c"</literal> ігнорує заповнення та ширину.
</para>
</warning>
<warning>
<para>
Спроба використати разом рядковий специфікатор та специфікатор ширини з
символами, що займають більше одного байта, може призвести до неочікуваного
результату.
</para>
</warning>
<para>
Змінні будуть приведені до відповідного типу для специфікатора:
<table>
<title>Обробка типів</title>
<tgroup cols="2">
<thead>
<row>
<entry>Тип</entry>
<entry>Специфікатор</entry>
</row>
</thead>
<tbody>
<row>
<entry><type>string</type></entry>
<entry><literal>s</literal></entry>
</row>
<row>
<entry><type>int</type></entry>
<entry>
<literal>d</literal>,
<literal>u</literal>,
<literal>c</literal>,
<literal>o</literal>,
<literal>x</literal>,
<literal>X</literal>,
<literal>b</literal>
</entry>
</row>
<row>
<entry><type>float</type></entry>
<entry>
<literal>e</literal>,
<literal>E</literal>,
<literal>f</literal>,
<literal>F</literal>,
<literal>g</literal>,
<literal>G</literal>,
<literal>h</literal>,
<literal>H</literal>
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
'>
<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>format</parameter></term>
<listitem>
<para>
Це формат інтерпретації рядка <parameter>string</parameter>, який
описаний в документації про функцію <function>sprintf</function>, але з
деякими відмінностями:
<simplelist>
<member>
Функція не враховує локаль.
</member>
<member>
Специфікатори <literal>F</literal>, <literal>g</literal>,
<literal>G</literal> і <literal>b</literal> не підтримуються.
</member>
<member>
Специфікатор <literal>D</literal> означає десяткове число.
</member>
<member>
Специфікатор <literal>i</literal> означає ціле число з визначенням основи.
</member>
<member>
Специфікатор <literal>n</literal> означає кількість оброблених символів.
</member>
<member>
Специфікатор <literal>s</literal> зупиняє зчитування після будь-якого
символу пропуску.
</member>
<member>
Знак <literal>*</literal> на відміну від <literal>argnum$</literal>
забороняє призначення цього специфікатора перетворення.
</member>
</simplelist>
</para>
</listitem>
</varlistentry>
'>
<!ENTITY strings.parameter.needle.non-string '
<para xmlns="http://docbook.org/ns/docbook">
До версії PHP 8.0.0, якщо параметр <parameter>needle</parameter> не є рядком,
він перетворюється на ціле число і розглядається як код символу. Ця поведінка
є застарілою, починаючи з PHP 7.3.0. Вкрай не рекомендується на неї
покладатися. Залежно від потрібної поведінки, параметр
<parameter>needle</parameter> необхідно привести до рядкового типу або
обробити функцією <function>chr</function>.
</para>
'>
<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер параметр <parameter>needle</parameter> може бути порожнім рядком.
</entry>
</row>'>
<!ENTITY strings.changelog.encoding '
<row xmlns="http://docbook.org/ns/docbook">
<entry>5.6.0</entry>
<entry>
Тепер початковим значенням параметра <parameter>encoding</parameter> є
значення директиви <link
linkend="ini.default-charset">default_charset</link>.
</entry>
</row>
'>
<!ENTITY strings.changelog.ascii-case-conversion '
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.2.0</entry>
<entry>
Перетворення регістру більше не залежить від локалі, що встановлена функцією
<function>setlocale</function>. Перетворюються тільки ASCII-символи.
</entry>
</row>
'>
<!ENTITY strings.changelog.ascii-case-folding '
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.2.0</entry>
<entry>
Приведення до одного регістру не залежить від локалі, що встановлена функцією
<function>setlocale</function>. Перетворюються тільки ASCII-символи. Байти,
які не належать до ASCII, порівнюються за своїми значеннями.
</entry>
</row>
'>
<!ENTITY strings.changelog.sprintf '
<informaltable xmlns="http://docbook.org/ns/docbook">
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ця функція більше не повертає &false; у разі помилки.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо не задано жодного
параметра. Раніше ця функція виводила <constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо значення
<literal>[width]</literal> менше за нуль або більше за
<constant>PHP_INT_MAX</constant>. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо значення
<literal>[precision]</literal> менше за нуль або більше за
<constant>PHP_INT_MAX</constant>. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ArgumentCountError</classname>, якщо не задано
обов&apos;язкові параметри. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
'>
<!ENTITY strings.changelog.vsprintf '
<informaltable xmlns="http://docbook.org/ns/docbook">
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ця функція більше не повертає &false; у разі помилки.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо не задано жодного
параметра. Раніше ця функція виводила <constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо значення
<literal>[width]</literal> менше за нуль або більше за
<constant>PHP_INT_MAX</constant>. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо значення
<literal>[precision]</literal> менше за нуль або більше за
<constant>PHP_INT_MAX</constant>. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Викидає <classname>ValueError</classname>, якщо не задано
обов&apos;язкові параметри. Раніше ця функція виводила
<constant>E_WARNING</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
'>
<!ENTITY strings.errors.sprintf '
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо не задано жодного параметра, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо значення <literal>[width]</literal> менше за нуль
або більше за <constant>PHP_INT_MAX</constant>, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо значення <literal>[precision]</literal> менше за
нуль або більше за <constant>PHP_INT_MAX</constant>, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо якщо не задано обов&apos;язкові параметри, то
викидається <classname>ArgumentCountError</classname>. Раніше функція
повертала &false;, а також виводилося повідомлення
<constant>E_WARNING</constant>.
</para>
'>
<!ENTITY strings.errors.vsprintf '
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо не задано жодного параметра, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо значення <literal>[width]</literal> менше за нуль
або більше за <constant>PHP_INT_MAX</constant>, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо значення <literal>[precision]</literal> менше за
нуль або більше за <constant>PHP_INT_MAX</constant>, то викидається
<classname>ValueError</classname>. Раніше виводилось повідомлення
<constant>E_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Починаючи з PHP 8.0.0, якщо якщо не задано обов&apos;язкові параметри, то
викидається <classname>ValueError</classname>. Раніше функція повертала
&false;, а також виводилося повідомлення <constant>E_WARNING</constant>.
</para>
'>
<!-- filter snippets -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
<para>
ID фільтра, який потрібно застосувати. Список доступних фільтрів наведено на
сторінці посібника <xref linkend="filter.filters" />.
</para>
<para>
Якщо не задано, то буде використана константа
<constant>FILTER_DEFAULT</constant>, яка однакова з
<link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
Це призведе до того, що фільтрація не виконається.
</para>
</listitem>
</varlistentry>
'>
<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
Генератори випадковостей, впорядковані за пріоритетом:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<listitem>
<para>
Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
</para>
<para>
Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
</para>
</listitem>
<listitem>
<para>
macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22, якщо CCRandomGenerateBytes доступний під час компіляції): CCRandomGenerateBytes()
</para>
<para>
macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<para>
Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
</para>
</listitem>
<listitem>
<simpara>
Для будь-якої іншої комбінації операційної системи та версії PHP: <filename>/dev/urandom</filename>
</simpara>
</listitem>
<listitem>
<simpara>
Якщо жоден генератор випадковостей не доступний або не працює, то буде
викинуто <classname>Random\RandomException</classname>.
</simpara>
</listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Якщо жоден генератор випадковостей не доступний, то буде викинуто
<classname>Random\RandomException</classname>.
</simpara>
</listitem>
'>
<!ENTITY csprng.function.backport '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Хоча цю функцію додано в PHP 7.0, для версій від 5.2 до 5.6 включно доступна
<link xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="&url.csprng.compat;">користувацька реалізація</link>.
</simpara>
</note>
'>
<!-- Random snippets -->
<!ENTITY random.engineErrors '
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Будь-який нащадок класу <classname>Throwable</classname>, що викидається
методом <methodname>Random\Engine::generate</methodname> основного рушія
<link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link>.
</simpara>
</listitem>
'>
<!-- UOPZ snippets -->
<!ENTITY uopz.warn.removed.function-5-0-0
'<warning xmlns="http://docbook.org/ns/docbook"><simpara>Ця функція
<emphasis>ВИДАЛЕНА</emphasis> в PECL uopz 5.0.0.</simpara></warning>'>
<!-- XML snippets -->
<!ENTITY xml.parser.param
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>parser</parameter></term>
<listitem>
<para>
XML-парсер.
</para>
</listitem>
</varlistentry>'>
<!ENTITY xml.handler.description
'<para xmlns="http://docbook.org/ns/docbook">
Якщо задано &null;, обробник буде скинуто до його початкового стану.
<warning>
<simpara>
Якщо задано порожній рядок, обробник також буде скинуто, проте така дія
застаріла, починаючи з PHP 8.4.0.
</simpara>
</warning>
</para>
<para xmlns="http://docbook.org/ns/docbook">
Якщо параметр <parameter>handler</parameter> має тип <type>callable</type>, то
обробником стане функція/метод, що має таку назву виклику.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Параметр <parameter>handler</parameter> може мати тип <type>string</type>, якщо
це назва метода об&apos;єкта, встановленого функцією
<function>xml_set_object</function>.
<warning>
<simpara>
Це є застарілим, починаючи з PHP 8.4.0.
</simpara>
</warning>
</para>
<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
Починаючи з PHP 8.4.0, назва виклику перевіряється на правильність під час
встановлення обробника, а не під час його виклику. Це означає, що функцію
<function>xml_set_object</function> потрібно викликати перед встановленням
назви метода, як зворотнього виклику. Однак, оскільки ця поведінка також є
застарілою, починаючи з PHP 8.4.0, рекомендується використовувати правильну
назву виклику (<type>callable</type>) методу.
</simpara>
</warning>
'>
<!ENTITY xml.handler.parser.param
'<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
XML-парсер, що викликає обробника.
</simpara>
</listitem>
</varlistentry>'>
<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
Використання не-<type>callable</type> рядків (<type>string</type>) як
параметра <parameter>handler</parameter> тепер є застарілим. Необхідно
задавати правильну назву виклику методів або &null; для скидання обробника.
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
Правильність параметра <parameter>handler</parameter>, як назви виклику
(<type>callable</type>) тепер перевіряється на правильність під час
встановлення обробника, а не під час його виклику.
</entry>
</row>'>
<!ENTITY xml.changelog.parser-param
'<row xmlns="http://docbook.org/ns/docbook">
<entry>8.0.0</entry>
<entry>
Тепер параметр <parameter>parser</parameter> має бути примірником
<classname>XMLParser</classname>. Раніше очікувався
<literal>xml</literal>-<type>resource</type>.
</entry>
</row>'>
<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
<para xmlns="http://docbook.org/ns/docbook">
Усі шифровані клієнтські потоки тепер вмикають однорангову перевірку.
Використовується стандартний пакет CA від OpenSSL для перевірки
однорангового сертифіката. Здебільшого не потрібно вносити жодних змін для
зв&apos;язку із серверами, що мають дійсні сертифікати SSL, оскільки
дистриб&apos;ютори зазвичай налаштовують OpenSSL на використання добре
відомих пакетів CA.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Стандартний пакет CA може бути змінений для всього сервера за допомогою
директив openssl.cafile або openssl.capath, а також для окремого запиту за
допомогою опцій контексту
<link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> або
<link linkend="context.ssl.capath"><parameter>capath</parameter></link>
context options.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хоча це не рекомендується, але можна вимкнути перевірку однорангового
сертифіката в запиті, встановивши опцію контексту
<link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
як &false;, або вимкнути перевірку імені однорангового пристрою,
встановивши опцію контексту
<link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
як &false;.
</para>
'>
<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->