mirror of
https://github.com/php/doc-uk.git
synced 2026-03-23 22:52:14 +01:00
5585 lines
273 KiB
XML
5585 lines
273 KiB
XML
<?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% менше ніж
|
||
через 80ʼ000 випадково згенерованих сідів, відповідно до парадоксу днів
|
||
народжень. Імовірність у 10% настає після 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><|>*?":</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">обов'язково</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>
|
||
Необов'язковий другий параметр <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 'Об'єктно-орієнтований стиль'>
|
||
<!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>
|
||
Виклик цієї функції для об'єктів є застарілим. Краще перетворити &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> тепер розглядаються як порожні об'єкти, які
|
||
не мають властивостей, замість виклику метода інтерфейсу
|
||
<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>, а не
|
||
від'ємне або додатнє число, як раніше.
|
||
</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>Об'єкт
|
||
<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, "розділювачем
|
||
шляхів" для декількох файлів шрифтів буде символ
|
||
<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 'Повертає об'єкт зображення в разі успіху або &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>%</literal>". "<literal>*</literal>" —
|
||
повернути всі поштові скриньки. Якщо значення <parameter>pattern</parameter>
|
||
дорівнюватиме "<literal>*</literal>", то повернеться список усієї
|
||
ієрархії поштових скриньок. "<literal>%</literal>" — повернути тільки
|
||
поточний рівень. Якщо значення <parameter>pattern</parameter>
|
||
дорівнюватиме "<literal>%</literal>", то повернеться тільки верхній рівень
|
||
поштових скриньок; "<literal>~/mail/%</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. Це дозволяє об'єднувати пов'язані елементи
|
||
на єдиному сервері для пришвидшення одночасних операцій.'>
|
||
|
||
<!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 'Об'єкт 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>
|
||
Необов'язковий параметр <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>Тільки процедурний стиль: об'єкт
|
||
<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>Тільки процедурний стиль: об'єкт
|
||
<classname>DateTime</classname> повертається функцією
|
||
<function>date_create</function>. Вона змінює цей
|
||
об'єкт.</para></listitem></varlistentry>'>
|
||
|
||
<!ENTITY date.datetimezone.description
|
||
'<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
|
||
<parameter>object</parameter></term><listitem><para>Тільки процедурний стиль:
|
||
об'єкт <classname>DateTimeZone</classname> повертається функцією
|
||
<function>timezone_open</function></para></listitem></varlistentry>'>
|
||
|
||
<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Повертає змінений об'єкт <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для ланцюжків методів &return.falseforfailure;.'>
|
||
<!ENTITY date.datetime.return.modifiedobject 'Повертає змінений об'єкт <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для ланцюжків методів.'>
|
||
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Повертає новий об'єкт <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> зі зміненими даними &return.falseforfailure;.'>
|
||
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Повертає новий об'єкт <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> до об'єкта
|
||
<classname>DOMDocument</classname> буде кодування порожнього
|
||
об'єкта.</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>
|
||
Визначає, чи необхідно автоматично реєструвати префікси простору імен в
|
||
області видимості контекстного вузла для об'єкта
|
||
<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>
|
||
Обов'язковий елемент з ключем <literal>query</literal> та значенням виразу
|
||
XPath у вигляді рядка.
|
||
</simpara>
|
||
</listitem>
|
||
<listitem>
|
||
<simpara>
|
||
Необов'язковий елемент з ключем <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">Ідентифікатор з'єднання ODBC.
|
||
Докладніше: <function>odbc_connect</function>.</para>'>
|
||
|
||
<!ENTITY odbc.parameter.catalog 'Каталог ('qualifier' мовою ODBC 2).'>
|
||
|
||
<!ENTITY odbc.parameter.schema 'Схема ('owner' мовою ODBC 2).'>
|
||
|
||
<!ENTITY odbc.parameter.search
|
||
'Цей параметр може містити наступні шаблони пошуку: <literal
|
||
xmlns="http://docbook.org/ns/docbook">%</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>, то ця функція намагатиметься встановити
|
||
привілейоване підключення за допомогою зовнішніх облікових даних. Привілейовані
|
||
з'єднання початково вимкнені. Для увімкнення необхідно директиві <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> дозволено
|
||
використовувати тільки з іменем користувача "/" та порожнім паролем.
|
||
<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">Ідентифікатор з'єднання 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> не визначено, то виконується стандартне
|
||
з'єднання, тобто останнє, виконане функцією <function>pg_connect</function>
|
||
або <function>pg_pconnect</function>. <warning><simpara>Починаючи з PHP 8.1.0,
|
||
використання стандартного з'єднання є
|
||
застарілим.</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;, то виконується стандартне
|
||
з'єднання, тобто останнє, виконане функцією <function>pg_connect</function>
|
||
або <function>pg_pconnect</function>. <warning><simpara>Починаючи з PHP 8.1.0,
|
||
використання стандартного з'єднання є
|
||
застарілим.</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">Необов'язковий параметр, яким
|
||
вказується спосіб індексування масиву (<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>Необов'язковий параметр,
|
||
яким вказується кількість знаків після крапки в результаті. Якщо опущено,
|
||
застосовується межа, що встановлена глобально функцією
|
||
<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 (від'ємні значення збільшуються на 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 і старіших версіях, або об'єкт <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 та старіших версіях, об'єкт
|
||
<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>Тільки процедурний стиль:
|
||
об'єкт <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>Тільки процедурний стиль:
|
||
об'єкт <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>Тільки процедурний стиль:
|
||
об'єкт <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 завжди використовує
|
||
стандартне кодування символів на сервері. Це кодування надсилається на етапі
|
||
з'єднання/автентифікації, які використовує
|
||
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-ін'єкція</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> або іншими способами дослідження
|
||
об'єктів.</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">Необов'язковий параметр
|
||
<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>З'єднання
|
||
MySQL. Якщо не задано, буде обрано останнє з'єднання, встановлене функцією
|
||
<function>mysql_connect</function>. Якщо з'єднатися не вдалось, функція
|
||
спробує встановити нове, ніби викликавши функцію
|
||
<function>mysql_connect</function> без параметрів. Якщо з'єднання не
|
||
вдалося знайти або встановити, буде виведено повідомлення рівня
|
||
<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>З'єднання
|
||
MySQL. Якщо не задано, буде обрано останнє з'єднання, встановлене функцією
|
||
<function>mysql_connect</function>. Якщо з'єднання не вдалося знайти або
|
||
встановити, буде виведено повідомлення рівня
|
||
<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">
|
||
Відкриває непостійні з'єднання MySQL, а набори результатів автоматично
|
||
знищує, коли PHP-скрипт завершується. Та незважаючи на те, що явне закриття
|
||
з'єднань і очищення наборів результатів необов'язкове, робити це
|
||
рекомендується. Це негайно вивільнить ресурси 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 'Об'єкт <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>. Слеш в кінці також є
|
||
обов'язковим, коли шлях веде до теки.</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>, що буде оброблятися. Цей
|
||
об'єкт повертається функцією <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>Асоціативний масив, що
|
||
містить додаткові заголовки (наприклад:
|
||
"receipt").</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 за своєю суттю є
|
||
асинхронним. Синхронні з'єднання можна встановлювати, додавши заголовок
|
||
"receipt". Це призведе до того, що методи нічого не повертатимуть,
|
||
доки сервер не підтвердить отримання повідомлення або доки не мине час
|
||
очікування читання.</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 >= 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">
|
||
Необов'язковий параметр <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"/>. В об'єктів COM і DOTNET значеннями
|
||
"варіантів" будуть початкові значення властивостей цих об'єктів.
|
||
</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>Для роботи з об'єктами
|
||
<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
|
||
'Об'єкт <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 містить набір ітераторів для
|
||
проходження об'єктів.</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 об'єкта. Тип можна
|
||
вказувати одним з символів:
|
||
</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 об'єктів,
|
||
оскільки тип можна автоматично зчитувати з 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>Необов'язковий ресурс запиту, який використовують з такими
|
||
функціями, як <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> є обов'язковим, а
|
||
всі інші поля — ні. Опис полів є на сторінці <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>), що позначає
|
||
колекцію, яка містить усі ключі даних, що використовуються для
|
||
шифрування та дешифрування. Цей параметр є обов'язковим.</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>. Цей параметр
|
||
є обов'язковим.
|
||
</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 (необов'язковий)>
|
||
}
|
||
]]>
|
||
</programlisting>
|
||
<para>
|
||
Формат для <literal>"azure"</literal> наступний:
|
||
</para>
|
||
<programlisting role="javascript">
|
||
<![CDATA[
|
||
azure: {
|
||
tenantId: <string>,
|
||
clientId: <string>,
|
||
clientSecret: <string>,
|
||
identityPlatformEndpoint: <string (необов'язковий)> // Початково: "login.microsoftonline.com"
|
||
}
|
||
]]>
|
||
</programlisting>
|
||
<para>
|
||
Формат для <literal>"gcp"</literal> наступний:
|
||
</para>
|
||
<programlisting role="javascript">
|
||
<![CDATA[
|
||
gcp: {
|
||
email: <string>,
|
||
privateKey: <base64 string>|<MongoDB\BSON\Binary>,
|
||
endpoint: <string (необов'язковий)> // Початково: "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>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>key</entry>
|
||
<entry>string</entry>
|
||
<entry>Обов'язковий. Amazon Resource Name (ARN) для AWS customer
|
||
master key (CMK).</entry>
|
||
</row>
|
||
<row>
|
||
<entry>endpoint</entry>
|
||
<entry>string</entry>
|
||
<entry>Необов'язковий. Додатковий ідентифікатор хоста для надсилання
|
||
запитів 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>Обов'язковий. Хост (може бути з портом) (напр.
|
||
"example.vault.azure.net").</entry>
|
||
</row>
|
||
<row>
|
||
<entry>keyName</entry>
|
||
<entry>string</entry>
|
||
<entry>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>keyVersion</entry>
|
||
<entry>string</entry>
|
||
<entry>Необов'язковий. Певна версія названого ключа. Стандартно
|
||
вказується версія головного ключа.</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>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>location</entry>
|
||
<entry>string</entry>
|
||
<entry>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>keyRing</entry>
|
||
<entry>string</entry>
|
||
<entry>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>keyName</entry>
|
||
<entry>string</entry>
|
||
<entry>Обов'язковий.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>keyVersion</entry>
|
||
<entry>string</entry>
|
||
<entry>Необов'язковий. Певна версія названого ключа. Стандартно
|
||
вказується версія головного ключа.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>endpoint</entry>
|
||
<entry>string</entry>
|
||
<entry>Необов'язковий. Хост (може бути з портом) (напр.
|
||
"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>Необов'язковий. Унікальний ідентифікатор для 96-байтного
|
||
об'єкта керування секретними даними KMIP. Якщо не вказано,
|
||
об'єкт генерується випадковим чином.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>endpoint</entry>
|
||
<entry>string</entry>
|
||
<entry>Необов'язковий. Хост (може бути з портом).</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> (необов'язковий),
|
||
tlsCertificateKeyFile: <string> (необов'язковий),
|
||
tlsCertificateKeyFilePassword: <string> (необов'язковий),
|
||
tlsDisableOCSPEndpointCheck: <bool> (необов'язковий)
|
||
}
|
||
]]>
|
||
</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>
|
||
Сеанс, по'язаний з операцією.
|
||
</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>
|
||
Алгоритм, що потрібно використати. Цей параметр обов'язковий.
|
||
Дозволено вказувати одну з
|
||
<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-значення. Параметр
|
||
обов'язковий, якщо задано <literal>precision</literal>.
|
||
</entry>
|
||
</row>
|
||
<row>
|
||
<entry>max</entry>
|
||
<entry><type>mixed</type></entry>
|
||
<entry>
|
||
Верхня межа діапазону, яка має BSON-значення. Параметр
|
||
обов'язковий, якщо задано <literal>precision</literal>.
|
||
</entry>
|
||
</row>
|
||
<row>
|
||
<entry>sparsity</entry>
|
||
<entry><type>int</type></entry>
|
||
<entry>Обов'язковий. Додатнє ціле 64-бітне число.</entry>
|
||
</row>
|
||
<row>
|
||
<entry>precision</entry>
|
||
<entry><type>int</type></entry>
|
||
<entry>
|
||
Необов'язковий. Додатнє ціле 32-бітне число, що вказує
|
||
точність явного шифрування. Можна задавати тільки для полів з
|
||
BSON-типами "double" або "decimal128".
|
||
</entry>
|
||
</row>
|
||
<row>
|
||
<entry>trimFactor</entry>
|
||
<entry><type>int</type></entry>
|
||
<entry>Необов'язковий. Додатнє ціле 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">Якщо обов'язкова
|
||
автентифікація провалена, то викидається
|
||
<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. Це
|
||
не обов'язково збігається з інтерпретаціями розширеного 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 цілочисельний тип є знаковим, деякі значення, що повертає
|
||
цей метод, можуть стати від'ємними на 32-бітних платформах. Для подання
|
||
беззнакового десяткового значення як рядка, використовується функція
|
||
<function>sprintf</function> зі специфікатором <literal>"%u"</literal>.
|
||
</simpara>
|
||
</note>
|
||
'>
|
||
|
||
<!ENTITY mongodb.note.server.readpreference '
|
||
<note xmlns="http://docbook.org/ns/docbook">
|
||
<simpara>
|
||
Параметр <literal>"readPreference"</literal> впливає не на сервер, котрому
|
||
драйвер дає команду, а тільки на об'єкт сервера. Натомість, під час
|
||
надсилання драйвером команди, цей параметр може забезпечувати відповідний
|
||
мережевий протокол для другорядного вузла з набору реплік, а також
|
||
встановлювати вимоги щодо читання для 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 об'єкти не можуть містити
|
||
повторювані назви властивостей, а масиви — дубльовані ключі.
|
||
</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">
|
||
З кожним процесом пов'язані м'які та жорсткі межі його ресурсів.
|
||
М'яка межа — ефективний розмір ресурсу. Жорстка межа — це значення, до
|
||
якого процес може збільшити ефективний розмір ресурсу. Непривілейований процес
|
||
може змінювати свої м'які межі, але жорсткі межі — лише зменшувати.
|
||
</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">
|
||
Символи, що треба вилучити, можна вказати за допомогою необов'язкового
|
||
параметра <parameter>characters</parameter>. Необхідно просто записати туди
|
||
усі непотрібні символи. За допомогою <literal>..</literal> можна задати
|
||
діапазон символів за зростанням.
|
||
</simpara>
|
||
'>
|
||
|
||
<!ENTITY strings.parameter.unicode.optional '
|
||
<simpara xmlns="http://docbook.org/ns/docbook">
|
||
Символи, що треба вилучити, можна вказати за допомогою необов'язкового
|
||
параметра <parameter>characters</parameter> Необхідно просто записати туди усі
|
||
непотрібні символи.
|
||
</simpara>
|
||
'>
|
||
|
||
<!ENTITY strings.parameter.encoding '
|
||
<para xmlns="http://docbook.org/ns/docbook">
|
||
Необов'язковий параметр. Ним вказується кодування, що застосовуватиметься
|
||
під час перетворення символів.
|
||
</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">
|
||
Хоча технічно цей аргумент є необов'язковим, але рекомендується вказати
|
||
в коді потрібне значення, оскільки директива <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>%</literal>), які відображаються в результаті без змін, та
|
||
<emphasis>специфікаторів перетворення</emphasis>, для кожного з яких
|
||
задається свій параметр.
|
||
</para>
|
||
|
||
<para>
|
||
Специфікатор перетворення відповідає прототипу:
|
||
<literal>%[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>. Знак мінуса до
|
||
від'ємного числа дописується автоматично.
|
||
</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>'</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>, за якою (необов'язково) слідує ціле число
|
||
чи знак <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>%</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>, якщо не задано
|
||
обов'язкові параметри. Раніше ця функція виводила
|
||
<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>, якщо не задано
|
||
обов'язкові параметри. Раніше ця функція виводила
|
||
<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, якщо якщо не задано обов'язкові параметри, то
|
||
викидається <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, якщо якщо не задано обов'язкові параметри, то
|
||
викидається <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 >= 12 (PHP >= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
Windows (PHP >= 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 >= 8.2; >= 8.1.9; >= 8.0.22, якщо CCRandomGenerateBytes доступний під час компіляції): CCRandomGenerateBytes()
|
||
</para>
|
||
<para>
|
||
macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
DragonflyBSD (PHP >= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
|
||
</para>
|
||
</listitem>
|
||
<listitem>
|
||
<para>
|
||
Solaris (PHP >= 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>, якщо
|
||
це назва метода об'єкта, встановленого функцією
|
||
<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 для перевірки
|
||
однорангового сертифіката. Здебільшого не потрібно вносити жодних змін для
|
||
зв'язку із серверами, що мають дійсні сертифікати SSL, оскільки
|
||
дистриб'ютори зазвичай налаштовують 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
|
||
-->
|