From aacdb8b0bbd2356b175adcaa3106a6f092c65c6a Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 11 May 2026 08:25:57 +0200 Subject: [PATCH 1/5] Translate new openssl_password_hash and openssl_password_verify functions --- .../functions/openssl-password-hash.xml | 183 ++++++++++++++++++ .../functions/openssl-password-verify.xml | 149 ++++++++++++++ 2 files changed, 332 insertions(+) create mode 100644 reference/openssl/functions/openssl-password-hash.xml create mode 100644 reference/openssl/functions/openssl-password-verify.xml diff --git a/reference/openssl/functions/openssl-password-hash.xml b/reference/openssl/functions/openssl-password-hash.xml new file mode 100644 index 000000000..e2da8a4ee --- /dev/null +++ b/reference/openssl/functions/openssl-password-hash.xml @@ -0,0 +1,183 @@ + + + + + + openssl_password_hash + Создаёт хеш пароля при помощи Argon2 из OpenSSL + + + + &reftitle.description; + + stringopenssl_password_hash + stringalgo + stringpassword + arrayoptions[] + + + Создаёт хеш пароля при помощи реализации Argon2 из OpenSSL. Это альтернатива + функции password_hash, в которой движком выступает OpenSSL, + что в некоторых системах позволяет использовать аппаратное ускорение. + + + Функция доступна только тогда, когда PHP скомпилирован с поддержкой OpenSSL, + которая включает Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + Алгоритм хеширования пароля. Поддерживаемые значения: + "argon2id" и "argon2i". + + + + + password + + + Пароль пользователя. + + + + + options + + + Ассоциативный массив (&array;) опций. Поддерживаемые ключи: + + + memory_cost — максимальный объём памяти (в КиБ), + который разрешается использовать для вычисления хеша + + + time_cost — максимальное время, которое разрешается + потратить на вычисление хеша + + + threads — количество потоков, которые задействуются + при вычислении хеша + + + + + + + + + + + &reftitle.returnvalues; + + Возвращает хеш пароля в виде строки (&string;). + + + + + &reftitle.errors; + + Выбрасывает исключение ValueError, если значение + параметра algo не входит в список поддерживаемых + ("argon2i" или "argon2id"). + + + Выбрасывает исключение Error, если операция + хеширования завершается ошибкой по неизвестной причине. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Функция добавлена. + + + + + + + + + &reftitle.examples; + + Пример использования функции <function>openssl_password_hash</function> + + +]]> + + &example.outputs.similar; + + + + + + Использование функции <function>openssl_password_hash</function> с пользовательскими опциями + + 65536, + 'time_cost' => 4, + 'threads' => 1, +]); +?> +]]> + + + + + + &reftitle.seealso; + + + openssl_password_verify + password_hash + + + + + + diff --git a/reference/openssl/functions/openssl-password-verify.xml b/reference/openssl/functions/openssl-password-verify.xml new file mode 100644 index 000000000..c863c4079 --- /dev/null +++ b/reference/openssl/functions/openssl-password-verify.xml @@ -0,0 +1,149 @@ + + + + + + openssl_password_verify + Проверяет соответствие пароля хешу при помощи Argon2 из OpenSSL + + + + &reftitle.description; + + boolopenssl_password_verify + stringalgo + stringpassword + stringhash + + + Проверяет, соответствует ли пароль хешу, который был создан функцией + openssl_password_hash. + + + Функция доступна только тогда, когда PHP скомпилирован с поддержкой OpenSSL, + которая включает Argon2 (HAVE_OPENSSL_ARGON2). + + + + + &reftitle.parameters; + + + + algo + + + Алгоритм хеширования пароля. Поддерживаемые значения: + "argon2id" и "argon2i". + + + + + password + + + Пароль пользователя. + + + + + hash + + + Хеш, который создан функцией openssl_password_hash. + + + + + + + + + &reftitle.returnvalues; + + Возвращает &true;, если пароль и хеш совпадают, или &false; в противном случае. + + + + + &reftitle.errors; + + Выбрасывает исключение ValueError, если значение + параметра algo не входит в список поддерживаемых + ("argon2i" или "argon2id"). + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Функция добавлена. + + + + + + + + + &reftitle.examples; + + Пример использования функции <function>openssl_password_verify</function> + + +]]> + + + + + + &reftitle.seealso; + + + openssl_password_hash + password_verify + + + + + + From 6cc1fdbb960b6ce0f7b234339ec41a7419e0c6c2 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 11 May 2026 09:33:01 +0200 Subject: [PATCH 2/5] Sync EN: ext/zip change para to simpara --- reference/zip/book.xml | 6 +- reference/zip/configure.xml | 22 ++--- reference/zip/constants.xml | 6 +- reference/zip/examples.xml | 6 +- reference/zip/functions/zip-close.xml | 14 +-- reference/zip/functions/zip-entry-close.xml | 14 +-- .../functions/zip-entry-compressedsize.xml | 14 +-- .../functions/zip-entry-compressionmethod.xml | 14 +-- .../zip/functions/zip-entry-filesize.xml | 14 +-- reference/zip/functions/zip-entry-name.xml | 14 +-- reference/zip/functions/zip-entry-open.xml | 30 +++---- reference/zip/functions/zip-entry-read.xml | 22 ++--- reference/zip/functions/zip-open.xml | 14 +-- reference/zip/functions/zip-read.xml | 14 +-- reference/zip/setup.xml | 14 +-- reference/zip/ziparchive.xml | 24 +++--- reference/zip/ziparchive/addemptydir.xml | 18 ++-- reference/zip/ziparchive/addfile.xml | 38 ++++---- reference/zip/ziparchive/addfromstring.xml | 22 ++--- reference/zip/ziparchive/addglob.xml | 86 +++++++++---------- reference/zip/ziparchive/addpattern.xml | 26 +++--- reference/zip/ziparchive/clearerror.xml | 10 +-- reference/zip/ziparchive/close.xml | 14 +-- reference/zip/ziparchive/count.xml | 6 +- reference/zip/ziparchive/deleteindex.xml | 14 +-- reference/zip/ziparchive/deletename.xml | 14 +-- reference/zip/ziparchive/extractto.xml | 26 +++--- .../zip/ziparchive/getarchivecomment.xml | 14 +-- reference/zip/ziparchive/getarchiveflag.xml | 30 +++---- reference/zip/ziparchive/getcommentindex.xml | 18 ++-- reference/zip/ziparchive/getcommentname.xml | 18 ++-- .../ziparchive/getexternalattributesindex.xml | 30 +++---- .../ziparchive/getexternalattributesname.xml | 26 +++--- reference/zip/ziparchive/getfromindex.xml | 26 +++--- reference/zip/ziparchive/getfromname.xml | 30 +++---- reference/zip/ziparchive/getnameindex.xml | 18 ++-- reference/zip/ziparchive/getstatusstring.xml | 10 +-- reference/zip/ziparchive/getstream.xml | 14 +-- reference/zip/ziparchive/getstreamindex.xml | 18 ++-- reference/zip/ziparchive/getstreamname.xml | 18 ++-- .../iscompressionmethoddupported.xml | 22 ++--- .../isencryptionmethoddupported.xml | 22 ++--- reference/zip/ziparchive/locatename.xml | 22 ++--- reference/zip/ziparchive/open.xml | 34 ++++---- .../zip/ziparchive/registercancelcallback.xml | 22 ++--- .../ziparchive/registerprogresscallback.xml | 26 +++--- reference/zip/ziparchive/renameindex.xml | 18 ++-- reference/zip/ziparchive/renamename.xml | 18 ++-- reference/zip/ziparchive/replacefile.xml | 34 ++++---- .../zip/ziparchive/setarchivecomment.xml | 14 +-- reference/zip/ziparchive/setarchiveflag.xml | 22 ++--- reference/zip/ziparchive/setcommentindex.xml | 18 ++-- reference/zip/ziparchive/setcommentname.xml | 18 ++-- .../zip/ziparchive/setcompressionindex.xml | 22 ++--- .../zip/ziparchive/setcompressionname.xml | 22 ++--- .../zip/ziparchive/setencryptionindex.xml | 26 +++--- .../zip/ziparchive/setencryptionname.xml | 30 +++---- .../ziparchive/setexternalattributesindex.xml | 26 +++--- .../ziparchive/setexternalattributesname.xml | 30 +++---- reference/zip/ziparchive/setmtimeindex.xml | 30 +++---- reference/zip/ziparchive/setmtimename.xml | 26 +++--- reference/zip/ziparchive/setpassword.xml | 18 ++-- reference/zip/ziparchive/statindex.xml | 18 ++-- reference/zip/ziparchive/statname.xml | 26 +++--- reference/zip/ziparchive/unchangeall.xml | 10 +-- reference/zip/ziparchive/unchangearchive.xml | 10 +-- reference/zip/ziparchive/unchangeindex.xml | 14 +-- reference/zip/ziparchive/unchangename.xml | 14 +-- 68 files changed, 699 insertions(+), 699 deletions(-) diff --git a/reference/zip/book.xml b/reference/zip/book.xml index df4788f8a..7cb87f5fd 100644 --- a/reference/zip/book.xml +++ b/reference/zip/book.xml @@ -1,5 +1,5 @@ - + @@ -9,10 +9,10 @@ &reftitle.intro; - + Модуль позволяет легко читать и записывать как в сами сжатые ZIP-архивы, так и в файлы внутри них. - + diff --git a/reference/zip/configure.xml b/reference/zip/configure.xml index 64c94952a..30b67dedd 100644 --- a/reference/zip/configure.xml +++ b/reference/zip/configure.xml @@ -1,45 +1,45 @@ - +
&reftitle.install;
Системы Linux - + Доступ к этим функциям открывается только в PHP, который скомпилировали через параметр конфигурации для поддержки модуля ZIP. - - + + До PHP 7.4.0 модуль libzip входил в состав PHP, и для компиляции модуля требовался параметр конфигурации . Начиная с PHP 7.3.0 сборка со встроенным модулем libzip не рекомендуется, но всё ещё доступна при добавлении параметра . - - + + Разработчики добавили параметр конфигурации , для системной установки модуля libzip. Требование к минимальной версии модуля — libzip 0.11, а рекомендуется версия 0.11.2 или новее. - +
Windows - + Начиная с PHP 8.2.0 модуль будет работать, только если DLL-библиотеку php_zip.dll включили в файле &php.ini;. Раньше этот модуль встраивался в PHP. - +
Установка через репозиторий PECL - + &pecl.info; &url.pecl.package;zip. - +
diff --git a/reference/zip/constants.xml b/reference/zip/constants.xml index 99902f2af..3dcc3ac6c 100644 --- a/reference/zip/constants.xml +++ b/reference/zip/constants.xml @@ -1,18 +1,18 @@ - + &reftitle.constants; &extension.constants; - + Класс ZipArchive использует константы класса. В классе предусмотрели константы разных типов, основные из которых: Глобальные флаги (префикс AFL_), флаги (префикс FL_), ошибки (префикс ER_) и константы режима работы (без префикса). - + Режимы открытия архива diff --git a/reference/zip/examples.xml b/reference/zip/examples.xml index 5f8934c19..d7a7133f8 100644 --- a/reference/zip/examples.xml +++ b/reference/zip/examples.xml @@ -1,5 +1,5 @@ - + &reftitle.examples; @@ -78,12 +78,12 @@ print_r($odt_meta); ]]> - + Этот пример использует старую версию API (PHP 4), он открывает ZIP-архив, читает каждый файл в архиве и выводит его содержимое. Архив test2.zip, использованный в этом примере, является одним из тестовых архивов исходного дистрибутива ZZIPlib. - + Пример использования Zip diff --git a/reference/zip/functions/zip-close.xml b/reference/zip/functions/zip-close.xml index 2d9517493..b04ee5019 100644 --- a/reference/zip/functions/zip-close.xml +++ b/reference/zip/functions/zip-close.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ voidzip_close resourcezip - + Функция закрывает дескриптор ZIP-архива. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip - + ZIP-файл, который прежде открыли функцией zip_open. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/zip/functions/zip-entry-close.xml b/reference/zip/functions/zip-entry-close.xml index ba473696e..90b31442e 100644 --- a/reference/zip/functions/zip-entry-close.xml +++ b/reference/zip/functions/zip-entry-close.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ boolzip_entry_close resourcezip_entry - + Функция закрывает заданный дескриптор директории. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip_entry - + Дескриптор директории, который прежде открыли функцией zip_entry_open. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/zip/functions/zip-entry-compressedsize.xml b/reference/zip/functions/zip-entry-compressedsize.xml index 5f3200532..44668d060 100644 --- a/reference/zip/functions/zip-entry-compressedsize.xml +++ b/reference/zip/functions/zip-entry-compressedsize.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ intfalsezip_entry_compressedsize resourcezip_entry - + Функция возвращает сжатый размер заданного дескриптора директории. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Функция возвращает сжатый размер дескриптора директории&return.falseforfailure;. - + diff --git a/reference/zip/functions/zip-entry-compressionmethod.xml b/reference/zip/functions/zip-entry-compressionmethod.xml index 4773b14c8..1bb35bbec 100644 --- a/reference/zip/functions/zip-entry-compressionmethod.xml +++ b/reference/zip/functions/zip-entry-compressionmethod.xml @@ -1,5 +1,5 @@ - + @@ -18,10 +18,10 @@ stringfalsezip_entry_compressionmethod resourcezip_entry - + Функция возвращает метод сжатия дескриптора директории, который указали в аргументе zip_entry. - + &reftitle.parameters; @@ -30,9 +30,9 @@ zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + @@ -40,9 +40,9 @@ &reftitle.returnvalues; - + Метод сжатия&return.falseforfailure;. - + diff --git a/reference/zip/functions/zip-entry-filesize.xml b/reference/zip/functions/zip-entry-filesize.xml index f8b20e4e3..7ded96f94 100644 --- a/reference/zip/functions/zip-entry-filesize.xml +++ b/reference/zip/functions/zip-entry-filesize.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ intfalsezip_entry_filesize resourcezip_entry - + Функция возвращает реальный размер заданного дескриптора директории. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Функция возвращает реальный размер дескриптора директории&return.falseforfailure;. - + diff --git a/reference/zip/functions/zip-entry-name.xml b/reference/zip/functions/zip-entry-name.xml index a4d9c1718..9cbe4d4e3 100644 --- a/reference/zip/functions/zip-entry-name.xml +++ b/reference/zip/functions/zip-entry-name.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ stringfalsezip_entry_name resourcezip_entry - + Функция возвращает имя заданного дескриптора директории. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Функция возвращает имя дескриптора директории&return.falseforfailure;. - + diff --git a/reference/zip/functions/zip-entry-open.xml b/reference/zip/functions/zip-entry-open.xml index c1291c1a3..6941f2f4a 100644 --- a/reference/zip/functions/zip-entry-open.xml +++ b/reference/zip/functions/zip-entry-open.xml @@ -1,5 +1,5 @@ - + @@ -20,9 +20,9 @@ resourcezip_entry stringmode"rb" - + Функция открывает директорию в ZIP-архиве для чтения. - + &reftitle.parameters; @@ -31,31 +31,31 @@ zip_dp - + Дескриптор, который возвращает функция zip_open. - + zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + mode - + Доступные режимы приводит документация к функции fopen. - + - + Функция пока игнорирует параметр mode, а значение параметра всегда равно "rb". Это связано с тем, что ZIP в PHP поддерживается только в режиме чтения. - + @@ -64,16 +64,16 @@ &reftitle.returnvalues; - + &return.success; - + - + В отличие от функции fopen и других подобных функций, значение, которое возвращает функция zip_entry_open, указывает только результат операции и не требуется для чтения или закрытия дескриптора каталога. - + diff --git a/reference/zip/functions/zip-entry-read.xml b/reference/zip/functions/zip-entry-read.xml index 319fc5231..68115fd8a 100644 --- a/reference/zip/functions/zip-entry-read.xml +++ b/reference/zip/functions/zip-entry-read.xml @@ -1,5 +1,5 @@ - + @@ -19,9 +19,9 @@ resourcezip_entry intlen1024 - + Функция считывает данные из открытого прежде дескриптора каталога. - + &reftitle.parameters; @@ -30,22 +30,22 @@ zip_entry - + Дескриптор директории, который возвращает функция zip_read. - + len - + Число байтов, которое требуется считать. - + - + В параметре указывают объём данных, который требуется считать, без учёта сжатия. - + @@ -54,10 +54,10 @@ &reftitle.returnvalues; - + Функция возвращает данные, которые считала, пустую строку, если достигла конца файла, или &false;, если возникла ошибка. - + diff --git a/reference/zip/functions/zip-open.xml b/reference/zip/functions/zip-open.xml index 30c66dfb5..b21c33ff2 100644 --- a/reference/zip/functions/zip-open.xml +++ b/reference/zip/functions/zip-open.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ resourceintfalsezip_open stringfilename - + Функция открывает ZIP-архив для чтения. - + &reftitle.parameters; @@ -29,9 +29,9 @@ filename - + Название файла ZIP-архива, который требуется открыть. - + @@ -39,12 +39,12 @@ &reftitle.returnvalues; - + Функция возвращает ссылку на ресурс для передачи в функции zip_read и zip_close или возвращает номер ошибки, если файл filename не существует или возникла ошибка. - + diff --git a/reference/zip/functions/zip-read.xml b/reference/zip/functions/zip-read.xml index 2ec4c08cc..b64b91113 100644 --- a/reference/zip/functions/zip-read.xml +++ b/reference/zip/functions/zip-read.xml @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ resourcefalsezip_read resourcezip - + Функция считывает следующую запись в ZIP-архиве. - + &reftitle.parameters; @@ -29,9 +29,9 @@ zip - + ZIP-файл, который прежде открыли функцией zip_open. - + @@ -39,11 +39,11 @@ &reftitle.returnvalues; - + Функция возвращает запись каталога для передачи в функции семейства zip_entry_* или &false;, если записей для чтения не осталось, или код ошибки, если она возникла. - + diff --git a/reference/zip/setup.xml b/reference/zip/setup.xml index 7372693e7..1f824ca80 100644 --- a/reference/zip/setup.xml +++ b/reference/zip/setup.xml @@ -1,5 +1,5 @@ - + &reftitle.setup; @@ -7,13 +7,13 @@
&reftitle.required; - + Для работы модуля требуется библиотека libzip. Версию библиотеки 1.1.2 включали в PHP до версии 7.3. - - + + Минимальная поддерживаемая версия — 0.11, но настоятельно рекомендуется использовать более новую версию. - + @@ -37,10 +37,10 @@
&reftitle.resources; - + В Zip-модуле используются два типа ресурсов. Первый — директория Zip для Zip-архива, второй — Zip Entry для записей архива. - +
diff --git a/reference/zip/ziparchive.xml b/reference/zip/ziparchive.xml index 75f330419..f800d65b2 100644 --- a/reference/zip/ziparchive.xml +++ b/reference/zip/ziparchive.xml @@ -1,5 +1,5 @@ - + Класс <classname>ZipArchive</classname> @@ -10,9 +10,9 @@
&reftitle.intro; - + Файловый архив, сжатый Zip. - +
@@ -746,40 +746,40 @@ lastId - Значение индекса последней добавленной записи (файл или каталог). - Доступно с PHP 8.0.0 и PECL zip 1.18.0. + Значение индекса последней добавленной записи (файл или каталог). + Доступно с PHP 8.0.0 и PECL zip 1.18.0. status - Статус Zip-архива. - Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0. + Статус Zip-архива. + Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0. statusSys - Системный статус Zip-архива. - Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0. + Системный статус Zip-архива. + Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0. numFiles - Количество файлов в архиве + Количество файлов в архиве filename - Имя файла в файловой системе + Имя файла в файловой системе comment - Комментарий к архиву + Комментарий к архиву diff --git a/reference/zip/ziparchive/addemptydir.xml b/reference/zip/ziparchive/addemptydir.xml index bf7559005..ad6530b73 100644 --- a/reference/zip/ziparchive/addemptydir.xml +++ b/reference/zip/ziparchive/addemptydir.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringdirname intflags0 - + Метод добавляет пустую директорию в архив. - + @@ -25,21 +25,21 @@ dirname - + Директория, которую требуется добавить. - + flags - + Битовая маска, которая состоит из следующих констант: ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437. Поведение констант описыват страница «ZIP-константы». - + @@ -48,9 +48,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/zip/ziparchive/addfile.xml b/reference/zip/ziparchive/addfile.xml index 74573435f..c770561b2 100644 --- a/reference/zip/ziparchive/addfile.xml +++ b/reference/zip/ziparchive/addfile.xml @@ -1,5 +1,5 @@ - + @@ -16,9 +16,9 @@ intlengthZipArchive::LENGTH_TO_END intflagsZipArchive::FL_OVERWRITE - + Добавляет в ZIP-архив файл по заданному пути. - + &zip.filename.separator; @@ -28,43 +28,43 @@ filepath - + Путь к файлу, который требуется добавить. - + entryname - + Имя файла внутри ZIP-архива. Параметр переопределит параметр filepath. - + start - + Начальная позиция для частичного копирования. - + length - + Длина, которую требуется скопировать при частичном копировании. Метод использует размер файла, если указали значение ZipArchive::LENGTH_TO_END (0). Метод использует весь файл начиная со значения параметра start, если указали значение ZipArchive::LENGTH_UNCHECKED. - + flags - + Битовая маска из следующих значений: ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, @@ -72,7 +72,7 @@ ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Поведение констант описывает страница «ZIP-константы». - + @@ -81,9 +81,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -126,12 +126,12 @@ &reftitle.examples; - + В примере открывается файл ZIP-архива test.zip и в архив добавляется файл /path/to/index.txt с именем newname.txt. - + Открыть и добавить @@ -157,14 +157,14 @@ if ($zip->open('test.zip') === TRUE) { &reftitle.notes; - + При добавлении файла в архив PHP заблокирует файл. Разблокировка произойдёт только после закрытия объекта ZipArchive, путём вызова ZipArchive::close или уничтожения объекта ZipArchive. Это предотвращает удаление файла, который только что добавили в архив, до того, как PHP разблокирует файл. - + diff --git a/reference/zip/ziparchive/addfromstring.xml b/reference/zip/ziparchive/addfromstring.xml index e88204992..b536be448 100644 --- a/reference/zip/ziparchive/addfromstring.xml +++ b/reference/zip/ziparchive/addfromstring.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ stringcontent intflagsZipArchive::FL_OVERWRITE - + Метод добавляет содержимое в ZIP-архив как файл. - + &zip.filename.separator; @@ -26,31 +26,31 @@ name - + Название записи, которую требуется создать. - + content - + Содержимое в двоично безопасном режиме, из которого метод создаст файл в архиве. - + flags - + Битовая маска из следующих констант: ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437. Поведение констант описывает страница «ZIP-константы». - + @@ -59,9 +59,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/zip/ziparchive/addglob.xml b/reference/zip/ziparchive/addglob.xml index be9d0ea95..3761070b3 100644 --- a/reference/zip/ziparchive/addglob.xml +++ b/reference/zip/ziparchive/addglob.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,9 @@ intflags0 arrayoptions[] - + Метод добавляет файлы из каталога, имена которых совпадают с glob-шаблоном pattern. - + &zip.filename.separator; @@ -27,18 +27,18 @@ pattern - + Шаблон, с которым работает функция glob, с которым метод сопоставит файлы. - + flags - + Битовая маска флагов, с которыми работает функция glob(). - + @@ -48,36 +48,36 @@ Ассоциативный массив опций. Параметр принимает следующие значения: - + "add_path" - - + + Префикс, который добавляется в начало при переводе в локальный путь файла в архиве. Метод применяет префикс после операций удаления, которые определили опциями "remove_path" или "remove_all_path". - + - + "remove_path" - - + + Префикс, который требуется удалить из путей файлов перед добавлением в архив. - + - + "remove_all_path" - - + + Со значением &true; метод возьмёт только имя файла и добавит его в корень архива. - + - + "flags" - - + + Битовая маска из следующих констант: ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, @@ -85,39 +85,39 @@ ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Поведение констант описывает страница «ZIP-константы». - + - + "comp_method" - - + + Метод сжатия. Опция принимает одну из констант ZipArchive::CM_*. - + - + "comp_flags" - - + + Уровень сжатия. - + - + "enc_method" - - + + Метод шифрования. Опция принимает одну из констант ZipArchive::EM_*. - + - + "enc_password" - - + + Пароль для шифрования. - + @@ -128,11 +128,11 @@ &reftitle.returnvalues; - + В случае успешного выполнения метод возвращает массив (array) файлов, которые добавил в архив,&return.falseforfailure; &return.success; - + @@ -177,9 +177,9 @@ &reftitle.examples; Пример добавления файлав архив по glob-шаблону методом <methodname>ZipArchive::addGlob</methodname> - + Добавить в архив PHP-скрипты и текстовые файлы из текущей директории. - + - + @@ -15,11 +15,11 @@ stringpath"." arrayoptions[] - + Добавляет файлы из директории в соответствии с шаблоном регулярного выражения pattern. Операция не рекурсивна. Шаблон применяется только к именам файлов. - + @@ -28,25 +28,25 @@ pattern - + Шаблон PCRE. - + path - + Директория для сканирования. По умолчанию выбирается текущая директория. - + options - + Ассоциативный массив параметров, принимаемых ZipArchive::addGlob. - + @@ -54,18 +54,18 @@ &reftitle.returnvalues; - + Массив (array) добавленных файлов в случае успешного выполнения&return.falseforfailure; - + &reftitle.examples; Пример использования <methodname>ZipArchive::addPattern</methodname> - + Добавить к архиву все текстовые файлы и файлы скриптов PHP из текущей директории - + - + @@ -12,9 +12,9 @@ public voidZipArchive::clearError - + Удаляет сообщение об ошибке статуса, системные и/или сообщения модуля zip. - + @@ -24,9 +24,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/zip/ziparchive/close.xml b/reference/zip/ziparchive/close.xml index 685af95b2..8b0ecb81a 100644 --- a/reference/zip/ziparchive/close.xml +++ b/reference/zip/ziparchive/close.xml @@ -1,5 +1,5 @@ - + @@ -12,15 +12,15 @@ public boolZipArchive::close - + Метод закрывает открытый или созданный архив и сохраняет изменения. Метод автоматически вызывается в конце выполнения скрипта. - - + + Если архив не содержит файлов, файл по умолчанию полностью удаляется (пустой архив не записывается) в соответствии со значением глобального флага ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE. - + @@ -30,9 +30,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/zip/ziparchive/count.xml b/reference/zip/ziparchive/count.xml index 414a1e629..50346a180 100644 --- a/reference/zip/ziparchive/count.xml +++ b/reference/zip/ziparchive/count.xml @@ -1,5 +1,5 @@ - + @@ -22,9 +22,9 @@ &reftitle.returnvalues; - + Возвращает количество файлов в архиве. - + diff --git a/reference/zip/ziparchive/deleteindex.xml b/reference/zip/ziparchive/deleteindex.xml index bb1f35cfe..8caa0399b 100644 --- a/reference/zip/ziparchive/deleteindex.xml +++ b/reference/zip/ziparchive/deleteindex.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public boolZipArchive::deleteIndex intindex - + Удаляет элемент (файл или каталог) в архиве, используя его индекс. - + &reftitle.parameters; @@ -23,9 +23,9 @@ index - + Индекс элемента для удаления. - + @@ -33,9 +33,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/deletename.xml b/reference/zip/ziparchive/deletename.xml index 1cd82e656..53d6de15f 100644 --- a/reference/zip/ziparchive/deletename.xml +++ b/reference/zip/ziparchive/deletename.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public boolZipArchive::deleteName stringname - + Удаляет элемент (файл или каталог) в архиве, используя его имя. - + &reftitle.parameters; @@ -23,9 +23,9 @@ name - + Имя элемента для удаления. - + @@ -33,9 +33,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/extractto.xml b/reference/zip/ziparchive/extractto.xml index 8cc1a23db..f5cfd8568 100644 --- a/reference/zip/ziparchive/extractto.xml +++ b/reference/zip/ziparchive/extractto.xml @@ -1,5 +1,5 @@ - + @@ -13,22 +13,22 @@ stringpathto arraystringnullfiles&null; - + Извлечение всего архива или его части в указанное место назначения. - + - + Разрешения по умолчанию для извлечённых файлов и каталогов дают максимально широкий доступ. Это можно ограничить, установив текущую маску разрешений umask функцией umask. - - + + По соображениям безопасности исходные разрешения не восстанавливаются. Примеры того, как их восстановить, показаны на странице с описанием метода ZipArchive::getExternalAttributesIndex. - + @@ -38,17 +38,17 @@ pathto - + Директория, в которую нужно извлекать файлы. - + files - + Элементы для извлечения. Может принимать как одно значение, так и массив записей. - + @@ -56,9 +56,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getarchivecomment.xml b/reference/zip/ziparchive/getarchivecomment.xml index 8e4948ca6..48f52cd3e 100644 --- a/reference/zip/ziparchive/getarchivecomment.xml +++ b/reference/zip/ziparchive/getarchivecomment.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public stringfalseZipArchive::getArchiveComment intflags0 - + Возвращает комментарий ZIP-архива. - + @@ -24,10 +24,10 @@ flags - + Если флаг установлен в ZipArchive::FL_UNCHANGED, возвращается оригинальный неизмененный комментарий. - + @@ -36,9 +36,9 @@ &reftitle.returnvalues; - + Возвращает комментарий ZIP-архива&return.falseforfailure;. - + diff --git a/reference/zip/ziparchive/getarchiveflag.xml b/reference/zip/ziparchive/getarchiveflag.xml index 4b19c4357..13ea2d633 100644 --- a/reference/zip/ziparchive/getarchiveflag.xml +++ b/reference/zip/ziparchive/getarchiveflag.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intflag intflags0 - + Метод возвращает значение глобального флага ZIP-архива. - + @@ -30,24 +30,24 @@ из следующих AFL_*-констант: - + ZipArchive::AFL_RDONLY - + - + ZipArchive::AFL_IS_TORRENTZIP - + - + ZipArchive::AFL_WANT_TORRENTZIP - + - + ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE - + @@ -56,11 +56,11 @@ flags - + Метод вернёт исходный неизменённый флаг, если значение флагов в параметре flags примет значение константы ZipArchive::FL_UNCHANGED. - + @@ -69,10 +69,10 @@ &reftitle.returnvalues; - + Метод возвращает 1, если флаг для архива установлен, 0, если нет, и -1 при ошибке. - + diff --git a/reference/zip/ziparchive/getcommentindex.xml b/reference/zip/ziparchive/getcommentindex.xml index 2928208f6..7b82fc24f 100644 --- a/reference/zip/ziparchive/getcommentindex.xml +++ b/reference/zip/ziparchive/getcommentindex.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intindex intflags0 - + Возвращает комментарий элемента, используя его индекс. - + &reftitle.parameters; @@ -24,18 +24,18 @@ index - + Индекс записи. - + flags - + Если флаг установлен в ZipArchive::FL_UNCHANGED, возвращается оригинальный неизмененный комментарий. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Возвращает комментарий при успехе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getcommentname.xml b/reference/zip/ziparchive/getcommentname.xml index 9a6f1d797..27b2b4014 100644 --- a/reference/zip/ziparchive/getcommentname.xml +++ b/reference/zip/ziparchive/getcommentname.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringname intflags0 - + Возвращает комментарий элемента, используя его имя. - + &reftitle.parameters; @@ -24,18 +24,18 @@ name - + Имя элемента. - + flags - + Если флаг установлен в ZipArchive::FL_UNCHANGED, возвращается оригинальный неизмененный комментарий. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Возвращает комментарий при успехе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getexternalattributesindex.xml b/reference/zip/ziparchive/getexternalattributesindex.xml index b42c40b79..b465bb1e3 100644 --- a/reference/zip/ziparchive/getexternalattributesindex.xml +++ b/reference/zip/ziparchive/getexternalattributesindex.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,9 @@ intattr intflags0 - + Извлекает внешние атрибуты записи по её индексу. - + &reftitle.parameters; @@ -26,36 +26,36 @@ index - + Индекс записи. - + opsys - + В случае успешного выполнения сюда записывается код операционной системы, заданный одной из констант ZipArchive::OPSYS_. - + attr - + В случае успешного выполнения сюда записываются внешние атрибуты. Значения зависят от операционной системы. - + flags - + Если задано как ZipArchive::FL_UNCHANGED, будут возвращены оригинальные неизмененные атрибуты. - + @@ -63,17 +63,17 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + В этом примере метод извлекает все файлы из ZIP-архива test.zip и устанавливает им права Unix, полученные из внешних атрибутов. - + Извлекаем все записи с их правами Unix diff --git a/reference/zip/ziparchive/getexternalattributesname.xml b/reference/zip/ziparchive/getexternalattributesname.xml index b92781c52..a45c6426d 100644 --- a/reference/zip/ziparchive/getexternalattributesname.xml +++ b/reference/zip/ziparchive/getexternalattributesname.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,9 @@ intattr intflags0 - + Извлекает внешние атрибуты записи по её имени. - + &reftitle.parameters; @@ -26,36 +26,36 @@ name - + Имя записи. - + opsys - + В случае успешного выполнения сюда записывается код операционной системы, заданный одной из констант ZipArchive::OPSYS_. - + attr - + В случае успешного выполнения сюда записываются внешние атрибуты. Значения зависят от операционной системы. - + flags - + Если задано как ZipArchive::FL_UNCHANGED, будут возвращены оригинальные неизмененные атрибуты. - + @@ -63,9 +63,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -14,9 +14,9 @@ intlen0 intflags0 - + Возвращает содержимое элемента по его индексу. - + &reftitle.parameters; @@ -25,17 +25,17 @@ index - + Индекс элемента. - + len - + Размер читаемых данных из элемента. Если 0, содержимое читается полностью. - + @@ -46,14 +46,14 @@ Может быть установлено только одно нижеприведённое значение. - + ZipArchive::FL_UNCHANGED - + - + ZipArchive::FL_COMPRESSED - + @@ -64,9 +64,9 @@ &reftitle.returnvalues; - + Возвращает содержимое элемента при успехе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getfromname.xml b/reference/zip/ziparchive/getfromname.xml index 808f0d56c..276d8220f 100644 --- a/reference/zip/ziparchive/getfromname.xml +++ b/reference/zip/ziparchive/getfromname.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intlen0 intflags0 - + Возвращает содержимое элемента по его имени. - + &reftitle.parameters; @@ -25,17 +25,17 @@ name - + Имя элемента. - + len - + Размер читаемых данных из элемента. Если 0, содержимое читается полностью. - + @@ -46,19 +46,19 @@ Следующие значения могут быть присоединены (побитовое ИЛИ). - + ZipArchive::FL_UNCHANGED - + - + ZipArchive::FL_COMPRESSED - + - + ZipArchive::FL_NOCASE - + @@ -69,9 +69,9 @@ &reftitle.returnvalues; - + Возвращает содержимое элемента при успехе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getnameindex.xml b/reference/zip/ziparchive/getnameindex.xml index 5b14469ae..96390bf65 100644 --- a/reference/zip/ziparchive/getnameindex.xml +++ b/reference/zip/ziparchive/getnameindex.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intindex intflags0 - + Возвращает имя элемента по его индексу. - + &reftitle.parameters; @@ -24,18 +24,18 @@ index - + Индекс элемента. - + flags - + Если флаг установлен в ZipArchive::FL_UNCHANGED, возвращается оригинальное неизмененное имя. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Возвращает имя при успехе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getstatusstring.xml b/reference/zip/ziparchive/getstatusstring.xml index cca3108ec..fa8586d58 100644 --- a/reference/zip/ziparchive/getstatusstring.xml +++ b/reference/zip/ziparchive/getstatusstring.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public stringZipArchive::getStatusString - + Метод возвращает сообщение об ошибке состояния, сообщения системы и (или) ZIP-архива - + @@ -24,9 +24,9 @@ &reftitle.returnvalues; - + Метод возвращает строку (string) с сообщением о состоянии. - + diff --git a/reference/zip/ziparchive/getstream.xml b/reference/zip/ziparchive/getstream.xml index 29a72ecca..504d50db2 100644 --- a/reference/zip/ziparchive/getstream.xml +++ b/reference/zip/ziparchive/getstream.xml @@ -1,5 +1,5 @@ - + @@ -12,10 +12,10 @@ public resourcefalseZipArchive::getStream stringname - + Получить дескриптор файла, определённый по имени элемента. На данный момент поддерживаются только операции чтения. - + &reftitle.parameters; @@ -24,9 +24,9 @@ name - + Используемое имя элемента. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + Возвращает файловый указатель (ресурс) в случае успешного выполнения&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getstreamindex.xml b/reference/zip/ziparchive/getstreamindex.xml index b6a963c6a..332a956c7 100644 --- a/reference/zip/ziparchive/getstreamindex.xml +++ b/reference/zip/ziparchive/getstreamindex.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ intindex intflags0 - + Получает обработчик файла для записи, определённой её индексом. На данный момент метод поддерживает только операции чтения. - + &reftitle.parameters; @@ -25,18 +25,18 @@ index - + Индекс записи. - + flags - + Если в flags установлена константа ZipArchive::FL_UNCHANGED, возвращается исходный неизмененный поток. - + @@ -44,9 +44,9 @@ &reftitle.returnvalues; - + В случае успешного выполнения возвращает указатель на файл (ресурс)&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/getstreamname.xml b/reference/zip/ziparchive/getstreamname.xml index 8e0cd33f5..12185e97e 100644 --- a/reference/zip/ziparchive/getstreamname.xml +++ b/reference/zip/ziparchive/getstreamname.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ stringname intflags0 - + Получает обработчик файла для записи, определённой её именем. На данный момент метод поддерживает только операции чтения. - + &reftitle.parameters; @@ -25,18 +25,18 @@ name - + Имя записи для использования. - + flags - + Если в flags установлена константа ZipArchive::FL_UNCHANGED, возвращается исходный неизмененный поток. - + @@ -44,9 +44,9 @@ &reftitle.returnvalues; - + В случае успешного выполнения возвращает указатель на файл (ресурс)&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/iscompressionmethoddupported.xml b/reference/zip/ziparchive/iscompressionmethoddupported.xml index b5712cf45..15f90955e 100644 --- a/reference/zip/ziparchive/iscompressionmethoddupported.xml +++ b/reference/zip/ziparchive/iscompressionmethoddupported.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intmethod boolenc&true; - + Проверяет, поддерживается ли метод сжатия libzip. - + @@ -26,18 +26,18 @@ method - + Метод сжатия, одна из констант ZipArchive::CM_*. - + enc - + Если &true; проверка на сжатие, иначе проверка на декомпрессию. - + @@ -46,17 +46,17 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.notes; - + Функция доступна только в том случае, если PHP собран с libzip ≥ 1.7.0. - + diff --git a/reference/zip/ziparchive/isencryptionmethoddupported.xml b/reference/zip/ziparchive/isencryptionmethoddupported.xml index ce263c93b..ff1fe0c35 100644 --- a/reference/zip/ziparchive/isencryptionmethoddupported.xml +++ b/reference/zip/ziparchive/isencryptionmethoddupported.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intmethod boolenc&true; - + Проверяет, поддерживается ли метод шифрования libzip. - + @@ -26,18 +26,18 @@ method - + Метод шифрования, одна из констант ZipArchive::EM_*. - + enc - + Если &true; проверка шифрования, иначе проверка расшифровки. - + @@ -46,17 +46,17 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.notes; - + Функция доступна только в том случае, если PHP собран с libzip ≥ 1.7.0. - + diff --git a/reference/zip/ziparchive/locatename.xml b/reference/zip/ziparchive/locatename.xml index ebddb8b7e..d2489520a 100644 --- a/reference/zip/ziparchive/locatename.xml +++ b/reference/zip/ziparchive/locatename.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringname intflags0 - + Находит элемент по имени. - + &reftitle.parameters; @@ -24,9 +24,9 @@ name - + Имя элемента для поиска. - + @@ -37,14 +37,14 @@ или 0 ни для одного из них. - + ZipArchive::FL_NOCASE - + - + ZipArchive::FL_NODIR - + @@ -55,9 +55,9 @@ &reftitle.returnvalues; - + Метод возвращает индекс элемента в случае успешного выполнения&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/open.xml b/reference/zip/ziparchive/open.xml index 923f87bcd..0341e7378 100644 --- a/reference/zip/ziparchive/open.xml +++ b/reference/zip/ziparchive/open.xml @@ -1,5 +1,5 @@ - + @@ -13,12 +13,12 @@ stringfilename intflags0 - + Метод открывает новый или существующий ZIP-архив для чтения, записи или изменения. - - + + Начиная с libzip 1.6.0 метод оценивает пустой файл как недопустимый архив. - + &reftitle.parameters; @@ -27,9 +27,9 @@ filename - + Имя ZIP-архива для открытия. - + @@ -39,29 +39,29 @@ Используемый режим открытия файлов. - + ZipArchive::OVERWRITE - + - + ZipArchive::CREATE - + - + ZipArchive::RDONLY - + - + ZipArchive::EXCL - + - + ZipArchive::CHECKCONS - + diff --git a/reference/zip/ziparchive/registercancelcallback.xml b/reference/zip/ziparchive/registercancelcallback.xml index 39a7c4394..f3ecd27d1 100644 --- a/reference/zip/ziparchive/registercancelcallback.xml +++ b/reference/zip/ziparchive/registercancelcallback.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolZipArchive::registerCancelCallback callablecallback - + Регистрирует callback-функцию для разрешения отмены во время закрытия архива. - + @@ -25,9 +25,9 @@ callback - + Если функция вернёт 0, операция продолжится, при другом значении она будет отменена. - + @@ -36,18 +36,18 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + В этом примере создаётся ZIP-архив php.zip и отменяется операция при некоторых условиях запуска. - + Архивация файла @@ -69,9 +69,9 @@ if ($zip->open('php.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE)) { &reftitle.notes; - + Функция доступна, если PHP скомпилирован с libzip ≥ 1.6.0. - + diff --git a/reference/zip/ziparchive/registerprogresscallback.xml b/reference/zip/ziparchive/registerprogresscallback.xml index a8cc41e93..af72bae1f 100644 --- a/reference/zip/ziparchive/registerprogresscallback.xml +++ b/reference/zip/ziparchive/registerprogresscallback.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ floatrate callablecallback - + Регистрирует callback-функцию для предоставления обновлений при закрытии архива. - + @@ -26,17 +26,17 @@ rate - + Изменение между каждым вызовом callback-функции (от 0,0 до 1,0). - + callback - + Функция будет получать текущее состояние (state) в виде числа с плавающей точкой (float) (от 0,0 до 1,0). - + @@ -45,18 +45,18 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + В этом примере создаётся ZIP-архив php.zip и отображается прогрессия. - + Архивация файла @@ -77,9 +77,9 @@ if ($zip->open('php.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE)) { &reftitle.notes; - + Функция доступна, если PHP скомпилирован с libzip ≥ 1.6.0. - + diff --git a/reference/zip/ziparchive/renameindex.xml b/reference/zip/ziparchive/renameindex.xml index b57287aae..3ca2aa4e7 100644 --- a/reference/zip/ziparchive/renameindex.xml +++ b/reference/zip/ziparchive/renameindex.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intindex stringnew_name - + Переименовывает элемент по его индексу. - + &reftitle.parameters; @@ -24,17 +24,17 @@ index - + Индекс элемента для переименования. - + new_name - + Новое имя. - + @@ -42,9 +42,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/renamename.xml b/reference/zip/ziparchive/renamename.xml index b4ced27f5..4261d59a9 100644 --- a/reference/zip/ziparchive/renamename.xml +++ b/reference/zip/ziparchive/renamename.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringname stringnew_name - + Переименовывает элемент, заданный по имени. - + &reftitle.parameters; @@ -24,17 +24,17 @@ name - + Имя элемента для переименования. - + new_name - + Новое имя. - + @@ -42,9 +42,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/replacefile.xml b/reference/zip/ziparchive/replacefile.xml index f666965b8..92c33dd2b 100644 --- a/reference/zip/ziparchive/replacefile.xml +++ b/reference/zip/ziparchive/replacefile.xml @@ -1,5 +1,5 @@ - + @@ -16,9 +16,9 @@ intlengthZipArchive::LENGTH_TO_END intflags0 - + Метод заменяет файл в ZIP-архиве файлом по заданному пути. - + &zip.filename.separator; @@ -28,50 +28,50 @@ filepath - + Путь к файлу, который требуется добавить. - + index - + Индекс файла, который заменит метод; метод не изменит название файла. - + start - + Начальная позиция для частичного копирования. - + length - + Длина, которую требуется скопировать при частичном копировании, если указали значение ZipArchive::LENGTH_TO_END (0), метод использует размер файла, если указали значение ZipArchive::LENGTH_UNCHECKED, метод использует весь файл начиная со значения параметра start. - + flags - + Битовая маска из следующих значений: ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Поведение констант описывает страница «ZIP-константы». - + @@ -80,9 +80,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -119,11 +119,11 @@ &reftitle.examples; - + В примере открывается файл ZIP-архива test.zip и запись с индексом 1 заменяется на файл по пути /path/to/index.txt. - + Пример открытия и замены файла diff --git a/reference/zip/ziparchive/setarchivecomment.xml b/reference/zip/ziparchive/setarchivecomment.xml index 594eeb6c6..a380d903b 100644 --- a/reference/zip/ziparchive/setarchivecomment.xml +++ b/reference/zip/ziparchive/setarchivecomment.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public boolZipArchive::setArchiveComment stringcomment - + Устанавливает комментарий к ZIP-архиву. - + &reftitle.parameters; @@ -23,9 +23,9 @@ comment - + Содержание комментария. - + @@ -33,9 +33,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/setarchiveflag.xml b/reference/zip/ziparchive/setarchiveflag.xml index df42b82ee..bda0f5d77 100644 --- a/reference/zip/ziparchive/setarchiveflag.xml +++ b/reference/zip/ziparchive/setarchiveflag.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intflag intvalue - + Метод устанавливает глобальный флаг ZIP-архива. - + &reftitle.parameters; @@ -29,14 +29,14 @@ из следующих AFL_*-констант: - + ZipArchive::AFL_WANT_TORRENTZIP - + - + ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE - + @@ -45,9 +45,9 @@ value - + Новое значение флага. - + @@ -56,9 +56,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/zip/ziparchive/setcommentindex.xml b/reference/zip/ziparchive/setcommentindex.xml index c7f7a474d..a918ea277 100644 --- a/reference/zip/ziparchive/setcommentindex.xml +++ b/reference/zip/ziparchive/setcommentindex.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intindex stringcomment - + Устанавливает комментарий к элементу по его индексу. - + &reftitle.parameters; @@ -24,17 +24,17 @@ index - + Индекс элемента. - + comment - + Содержание комментария. - + @@ -42,9 +42,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/setcommentname.xml b/reference/zip/ziparchive/setcommentname.xml index 90e90a01c..1f2b9e53d 100644 --- a/reference/zip/ziparchive/setcommentname.xml +++ b/reference/zip/ziparchive/setcommentname.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringname stringcomment - + Устанавливает комментарий к элементу, заданному по имени. - + &reftitle.parameters; @@ -24,17 +24,17 @@ name - + Имя элемента. - + comment - + Содержание комментария. - + @@ -42,9 +42,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/setcompressionindex.xml b/reference/zip/ziparchive/setcompressionindex.xml index 67f757202..f987c9ec9 100644 --- a/reference/zip/ziparchive/setcompressionindex.xml +++ b/reference/zip/ziparchive/setcompressionindex.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intmethod intcompflags0 - + Метод устанавливает метод сжатия записи по индексу. - + &reftitle.parameters; @@ -25,25 +25,25 @@ index - + Индекс записи. - + method - + Метод сжатия, константа семейства ZipArchive::CM_*. - + compflags - + Уровень сжатия. - + @@ -51,9 +51,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/setcompressionname.xml b/reference/zip/ziparchive/setcompressionname.xml index 8ae240e0f..00b2b397d 100644 --- a/reference/zip/ziparchive/setcompressionname.xml +++ b/reference/zip/ziparchive/setcompressionname.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intmethod intcompflags0 - + Устанавливает метод сжатия записи заданной по имени. - + &reftitle.parameters; @@ -25,25 +25,25 @@ name - + Имя записи. - + method - + Метод сжатия, одна из констант ZipArchive::CM_*. - + compflags - + Уровень сжатия. - + @@ -51,9 +51,9 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; diff --git a/reference/zip/ziparchive/setencryptionindex.xml b/reference/zip/ziparchive/setencryptionindex.xml index 48376ee5e..cb90ab4e9 100644 --- a/reference/zip/ziparchive/setencryptionindex.xml +++ b/reference/zip/ziparchive/setencryptionindex.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,9 @@ intmethod #[\SensitiveParameter]stringnullpassword&null; - + Метод устанавливает метод шифрования записи по индексу. - + @@ -27,25 +27,25 @@ index - + Индекс записи. - + method - + Метод шифрования, заданный одной из констант ZipArchive::EM_. - + password - + Пароль. Если не указывать, то будет использован пароль по умолчанию. - + @@ -54,9 +54,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -84,9 +84,9 @@ &reftitle.notes; - + Функция доступна только если скомпилировали с модулем libzip ≥ 1.2.0. - + diff --git a/reference/zip/ziparchive/setencryptionname.xml b/reference/zip/ziparchive/setencryptionname.xml index 51989b585..f08f3a407 100644 --- a/reference/zip/ziparchive/setencryptionname.xml +++ b/reference/zip/ziparchive/setencryptionname.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intmethod #[\SensitiveParameter]stringnullpassword&null; - + Метод устанавливает метод шифрования записи по имени. - + &reftitle.parameters; @@ -25,25 +25,25 @@ name - + Имя записи. - + method - + Метод шифрования, который задали одной из констант ZipArchive::EM_. - + password - + Пароль. Если не указывать, то будет использован пароль по умолчанию. - + @@ -51,9 +51,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -80,12 +80,12 @@ &reftitle.examples; - + В этом примере создаётся ZIP-архив test.zip, содержащий файл test.txt, зашифрованный с помощью AES 256. - + Архивируем и шифруем файл @@ -113,9 +113,9 @@ if ($zip->open('test.zip', ZipArchive::CREATE) === TRUE) { &reftitle.notes; - + Функция доступна только если скомпилировано с модулем libzip ≥ 1.2.0. - + diff --git a/reference/zip/ziparchive/setexternalattributesindex.xml b/reference/zip/ziparchive/setexternalattributesindex.xml index 156dfc81b..a48d40a85 100644 --- a/reference/zip/ziparchive/setexternalattributesindex.xml +++ b/reference/zip/ziparchive/setexternalattributesindex.xml @@ -1,5 +1,5 @@ - + @@ -15,9 +15,9 @@ intattr intflags0 - + Устанавливает внешние атрибуты записи, заданной её индексом. - + &reftitle.parameters; @@ -26,33 +26,33 @@ index - + Индекс записи. - + opsys - + Код операционной системы заданный одной из констант ZipArchive::OPSYS_. - + attr - + Внешние атрибуты. Значения зависят от операционной системы. - + flags - + Опциональные флаги. Не используется. - + @@ -60,9 +60,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -15,9 +15,9 @@ intattr intflags0 - + Установка внешних атрибутов записи, заданной по имени. - + &reftitle.parameters; @@ -26,33 +26,33 @@ name - + Имя записи. - + opsys - + Код операционной системы, определяется одной из констант ZipArchive::OPSYS_. - + attr - + Внешние атрибуты. Значение зависит от операционной системы. - + flags - + Необязательные флаги. В настоящее время не используется. - + @@ -60,18 +60,18 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + В этом примере открывается файл архива ZIP test.zip и к нему добавляется файл test.txt с правами Unix в виде внешних атрибутов. - + Сжатие файла с его правами Unix diff --git a/reference/zip/ziparchive/setmtimeindex.xml b/reference/zip/ziparchive/setmtimeindex.xml index fd4265af9..ce6b0438a 100644 --- a/reference/zip/ziparchive/setmtimeindex.xml +++ b/reference/zip/ziparchive/setmtimeindex.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ inttimestamp intflags0 - + Установить время модификации файла по его индексу. - + &reftitle.parameters; @@ -25,25 +25,25 @@ index - + Индекс. - + timestamp - + Время модификации (временная метка unix) файла. - + flags - + Необязательные флаги. В текущий момент не используются. - + @@ -51,18 +51,18 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + Пример создания ZIP-архива test.zip, добавления в него файла test.txt и установка времени модификации для него. - + Архивирование файла @@ -86,9 +86,9 @@ if ($zip->open('test.zip', ZipArchive::CREATE) === TRUE) { &reftitle.notes; - + Функция доступна только если сборка производилась с libzip ≥ 1.0.0. - + diff --git a/reference/zip/ziparchive/setmtimename.xml b/reference/zip/ziparchive/setmtimename.xml index f632d956b..a6c9e23c9 100644 --- a/reference/zip/ziparchive/setmtimename.xml +++ b/reference/zip/ziparchive/setmtimename.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ inttimestamp intflags0 - + Установить время модификации файла по его имени. - + &reftitle.parameters; @@ -25,25 +25,25 @@ name - + Имя файла. - + timestamp - + Время модификации (временная метка unix) файла. - + flags - + Необязательные флаги. В текущий момент не используются. - + @@ -51,18 +51,18 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; - + Пример создания ZIP-архива test.zip, добавления в него файла test.txt и установка времени модификации для него. - + Архивирование файла diff --git a/reference/zip/ziparchive/setpassword.xml b/reference/zip/ziparchive/setpassword.xml index 5b84973e9..c78c5cf5e 100644 --- a/reference/zip/ziparchive/setpassword.xml +++ b/reference/zip/ziparchive/setpassword.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolZipArchive::setPassword #[\SensitiveParameter]stringpassword - + Задаёт пароль для активного архива. - + @@ -24,9 +24,9 @@ password - + Пароль для архива. - + @@ -34,15 +34,15 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.notes; - + Начиная с PHP 7.2.0 и libzip 1.2.0 пароль используется для распаковки архива, а также как пароль по умолчанию для методов ZipArchive::setEncryptionName @@ -50,7 +50,7 @@ Раньше метод устанавливал пароль только для распаковки. Метод не превращала незащищённый паролем экземпляр ZipArchive в защищённый объект ZipArchive. - + diff --git a/reference/zip/ziparchive/statindex.xml b/reference/zip/ziparchive/statindex.xml index 8215ca871..47b11ddce 100644 --- a/reference/zip/ziparchive/statindex.xml +++ b/reference/zip/ziparchive/statindex.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ intindex intflags0 - + Получение детальной информации об элементе по его индексу. - + &reftitle.parameters; @@ -24,18 +24,18 @@ index - + Индекс элемента. - + flags - + ZipArchive::FL_UNCHANGED указывается, чтобы запросить информацию об исходном файле в архиве, игнорируя любые внесённые изменения. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Возвращает массив, содержащий детальную информацию о элементе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/statname.xml b/reference/zip/ziparchive/statname.xml index fc90cc497..0e8696613 100644 --- a/reference/zip/ziparchive/statname.xml +++ b/reference/zip/ziparchive/statname.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ stringname intflags0 - + Получение детальной информации об элементе по его имени. - + &reftitle.parameters; @@ -24,9 +24,9 @@ name - + Имя элемента. - + @@ -38,19 +38,19 @@ об исходном файле в архиве, игнорируя любые внесённые изменения. - + ZipArchive::FL_NOCASE - + - + ZipArchive::FL_NODIR - + - + ZipArchive::FL_UNCHANGED - + @@ -61,9 +61,9 @@ &reftitle.returnvalues; - + Возвращает массив, содержащий детальную информацию о элементе&return.falseforfailure;. - + &reftitle.examples; diff --git a/reference/zip/ziparchive/unchangeall.xml b/reference/zip/ziparchive/unchangeall.xml index 080ee18ea..fed923a3c 100644 --- a/reference/zip/ziparchive/unchangeall.xml +++ b/reference/zip/ziparchive/unchangeall.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ public boolZipArchive::unchangeAll - + Отменяет все изменения, сделанные в архиве. - + @@ -24,9 +24,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -12,10 +12,10 @@ public boolZipArchive::unchangeArchive - + Возвращает все глобальные изменения, сделанные в архиве. В данный момент только отменяет изменения в комментариях к архиву. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -12,9 +12,9 @@ public boolZipArchive::unchangeIndex intindex - + Отменяет все изменения у позиции с заданным индексом. - + &reftitle.parameters; @@ -23,9 +23,9 @@ index - + Индекс позиции. - + @@ -33,9 +33,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -12,9 +12,9 @@ public boolZipArchive::unchangeName stringname - + Отменяет все изменения у позиции с заданным именем. - + &reftitle.parameters; @@ -23,9 +23,9 @@ name - + Имя позиции. - + @@ -33,9 +33,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -14,7 +14,7 @@ stringpg_escape_bytea PgSql\Connectionconnection - stringdata + stringstring pg_escape_bytea экранирует спецсимволы в строке @@ -51,7 +51,7 @@ - data + string Строка, содержащая двоичные данные в виде текста, которые требуется diff --git a/reference/pgsql/functions/pg-escape-identifier.xml b/reference/pgsql/functions/pg-escape-identifier.xml index 3ff9ea327..18db33d64 100644 --- a/reference/pgsql/functions/pg-escape-identifier.xml +++ b/reference/pgsql/functions/pg-escape-identifier.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ &reftitle.description; - stringpg_escape_identifier + stringfalsepg_escape_identifier PgSql\Connectionconnection - stringdata + stringstring Функция pg_escape_identifier экранирует названия таблиц, полей и других идентификаторов в SQL-инструкциях @@ -38,7 +38,7 @@ - data + string Текстовая строка (string), которую требуется заэкранировать. @@ -52,7 +52,7 @@ &reftitle.returnvalues; - Функция возвращает строку (string) с заэкранированными данными. + Функция возвращает строку (string) с заэкранированными данными или &false; в случае ошибки. diff --git a/reference/pgsql/functions/pg-escape-literal.xml b/reference/pgsql/functions/pg-escape-literal.xml index 8b7484245..d1e99ad34 100644 --- a/reference/pgsql/functions/pg-escape-literal.xml +++ b/reference/pgsql/functions/pg-escape-literal.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ &reftitle.description; - stringpg_escape_literal + stringfalsepg_escape_literal PgSql\Connectionconnection - stringdata + stringstring Функция pg_escape_literal экранирует литерал для запроса базы данных PostgreSQL. @@ -45,7 +45,7 @@ - data + string Строка (string), содержащая текст для экранирования. @@ -59,7 +59,7 @@ &reftitle.returnvalues; - Строка (string), содержащая экранированный текст. + Строка (string), содержащая экранированный текст, или &false; в случае ошибки. diff --git a/reference/pgsql/functions/pg-escape-string.xml b/reference/pgsql/functions/pg-escape-string.xml index 86ac9aff9..ce4636108 100644 --- a/reference/pgsql/functions/pg-escape-string.xml +++ b/reference/pgsql/functions/pg-escape-string.xml @@ -1,5 +1,5 @@ - + @@ -14,7 +14,7 @@ stringpg_escape_string PgSql\Connectionconnection - stringdata + stringstring Функция pg_escape_string экранирует спецсимволы в строке запроса для @@ -45,7 +45,7 @@ - data + string Исходная экранируемая строка. diff --git a/reference/pgsql/functions/pg-execute.xml b/reference/pgsql/functions/pg-execute.xml index 7682166e9..8ac4fac52 100644 --- a/reference/pgsql/functions/pg-execute.xml +++ b/reference/pgsql/functions/pg-execute.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ PgSql\Resultfalsepg_execute PgSql\Connectionconnection - stringstmtname + stringstatement_name arrayparams @@ -44,7 +44,7 @@ - stmtname + statement_name Имя подготовленного к исполнению запроса. Если передана пустая строка "", diff --git a/reference/pgsql/functions/pg-lo-export.xml b/reference/pgsql/functions/pg-lo-export.xml index 6e7623b3f..1f5e1182d 100644 --- a/reference/pgsql/functions/pg-lo-export.xml +++ b/reference/pgsql/functions/pg-lo-export.xml @@ -1,5 +1,5 @@ - + @@ -13,7 +13,7 @@ boolpg_lo_export PgSql\Connectionconnection intoid - stringpathname + stringfilename pg_lo_export выбирает большой объект из базы @@ -49,7 +49,7 @@ - pathname + filename Полный путь и имя файла в клиентской файловой системе для записи diff --git a/reference/pgsql/functions/pg-lo-import.xml b/reference/pgsql/functions/pg-lo-import.xml index 19bdebf8e..98b091e11 100644 --- a/reference/pgsql/functions/pg-lo-import.xml +++ b/reference/pgsql/functions/pg-lo-import.xml @@ -1,5 +1,5 @@ - + @@ -10,10 +10,10 @@ &reftitle.description; - int|string|falsepg_lo_import + intstringfalsepg_lo_import PgSql\Connectionconnection - stringpathname - mixedobject_id + stringfilename + intstringoid Функция pg_lo_import создаёт большой объект в базе данных @@ -41,7 +41,7 @@ - pathname + filename Полный путь и название файла в клиентской файловой системе, @@ -50,10 +50,10 @@ - object_id + oid - При установке параметра object_id функция + При установке параметра oid функция попытается создать объект с этим идентификатором, иначе сервер назначит объекту свободный идентификатор. Параметр работает на основе механизма, diff --git a/reference/pgsql/functions/pg-parameter-status.xml b/reference/pgsql/functions/pg-parameter-status.xml index 7b3e793b4..79344b75a 100644 --- a/reference/pgsql/functions/pg-parameter-status.xml +++ b/reference/pgsql/functions/pg-parameter-status.xml @@ -1,5 +1,5 @@ - + @@ -10,9 +10,9 @@ &reftitle.description; - stringpg_parameter_status + stringfalsepg_parameter_status PgSql\Connectionconnection - stringparam_name + stringname Получает текущее значение заданного параметра сервера. @@ -63,7 +63,7 @@ - param_name + name Допустимые значения аргумента: server_version, diff --git a/reference/pgsql/functions/pg-prepare.xml b/reference/pgsql/functions/pg-prepare.xml index 5ed4b433b..5850f0906 100644 --- a/reference/pgsql/functions/pg-prepare.xml +++ b/reference/pgsql/functions/pg-prepare.xml @@ -1,5 +1,5 @@ - + @@ -15,7 +15,7 @@ PgSql\Resultfalsepg_prepare PgSql\Connectionconnection - stringstmtname + stringstatement_name stringquery @@ -28,9 +28,9 @@ или новее; функция не будет работать c серверами предыдущих версий. - Функция создает подготовленный запрос с названием stmtname + Функция создает подготовленный запрос с названием statement_name из строки query, которая содержит одну команду. - Значение параметра stmtname указывают как пустую строку "", + Значение параметра statement_name указывают как пустую строку "", чтобы создать безымянный запрос, который автоматически заменяет предыдущий безымянный запрос; в остальных случаях попытка назвать запрос именем, которое уже определили в текущей сессии, вызовет ошибку. Параметры, которые передали при выполнении запроса, @@ -56,7 +56,7 @@ - stmtname + statement_name Уникальное в пределах сессии имя, которым функция назовёт подготовленный запрос. diff --git a/reference/pgsql/functions/pg-put-line.xml b/reference/pgsql/functions/pg-put-line.xml index 2dc42cae3..6a06946c8 100644 --- a/reference/pgsql/functions/pg-put-line.xml +++ b/reference/pgsql/functions/pg-put-line.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ boolpg_put_line PgSql\Connectionconnection - stringdata + stringquery pg_put_line передаёт на PostgreSQL сервер @@ -59,7 +59,7 @@ - data + query Текстовая строка для прямой пересылки на сервер. Завершающий diff --git a/reference/pgsql/functions/pg-set-error-verbosity.xml b/reference/pgsql/functions/pg-set-error-verbosity.xml index 80a52bb34..4d545585c 100644 --- a/reference/pgsql/functions/pg-set-error-verbosity.xml +++ b/reference/pgsql/functions/pg-set-error-verbosity.xml @@ -1,5 +1,5 @@ - + @@ -13,7 +13,7 @@ &reftitle.description; - intpg_set_error_verbosity + intfalsepg_set_error_verbosity PgSql\Connectionconnection intverbosity @@ -67,7 +67,7 @@ Предыдущий режим действовавший до запуска функции: PGSQL_ERRORS_TERSE, PGSQL_ERRORS_DEFAULT - или PGSQL_ERRORS_VERBOSE. + или PGSQL_ERRORS_VERBOSE, или &false; в случае ошибки. From 6affecbc3db8dd5df1719ed33d0594c216cd3048 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 11 May 2026 09:58:22 +0200 Subject: [PATCH 4/5] Sync EN: format predefined constant pages (skip-revcheck) --- appendices/reserved.constants.core.xml | 6 +- appendices/tokens.xml | 755 ++++++++++++++++++++----- reference/dir/constants.xml | 12 +- reference/iconv/constants.xml | 22 +- reference/mysqli/constants.xml | 8 +- reference/openssl/constants.xml | 2 +- 6 files changed, 635 insertions(+), 170 deletions(-) diff --git a/appendices/reserved.constants.core.xml b/appendices/reserved.constants.core.xml index a51d1ce04..3ac4dfe8e 100644 --- a/appendices/reserved.constants.core.xml +++ b/appendices/reserved.constants.core.xml @@ -1,5 +1,5 @@ - + Предопределённые константы ядра @@ -651,7 +651,7 @@ Событие ОС Windows, которое вызывается сочетанием клавиш - + CTRL C . @@ -667,7 +667,7 @@ Событие ОС Windows, которое вызывается сочетанием клавиш - + CTRL BREAK . diff --git a/appendices/tokens.xml b/appendices/tokens.xml index 6e4ffdc66..e35c17c7f 100644 --- a/appendices/tokens.xml +++ b/appendices/tokens.xml @@ -56,49 +56,76 @@ defined('T_FN') || define('T_FN', 10001); - T_ABSTRACT + + T_ABSTRACT + (int) + abstract - T_AMPERSAND_FOLLOWED_BY_VAR_OR_VARARG + + T_AMPERSAND_FOLLOWED_BY_VAR_OR_VARARG + (int) + & , токен доступен с PHP 8.1.0 - T_AMPERSAND_NOT_FOLLOWED_BY_VAR_OR_VARARG + + T_AMPERSAND_NOT_FOLLOWED_BY_VAR_OR_VARARG + (int) + & , токен доступен с PHP 8.1.0 - T_AND_EQUAL + + T_AND_EQUAL + (int) + &= Операторы присваивания - T_ARRAY + + T_ARRAY + (int) + array() Конструкция array, синтаксис массива - T_ARRAY_CAST + + T_ARRAY_CAST + (int) + (array) Приведение типов - T_AS + + T_AS + (int) + as Конструкция &foreach; - T_ATTRIBUTE + + T_ATTRIBUTE + (int) + #[ Атрибуты, доступны с PHP 8.0.0 - T_BAD_CHARACTER + + T_BAD_CHARACTER + (int) + ASCII-символы с кодовыми точками ниже 32, за исключением символов \t (0x09), \n (0x0a) и \r (0x0d); @@ -106,73 +133,112 @@ defined('T_FN') || define('T_FN', 10001); - T_BOOLEAN_AND + + T_BOOLEAN_AND + (int) + && Логические операторы - T_BOOLEAN_OR + + T_BOOLEAN_OR + (int) + || Логические операторы - T_BOOL_CAST + + T_BOOL_CAST + (int) + (bool) или (boolean) Приведение типов - T_BREAK + + T_BREAK + (int) + break Инструкция break - T_CALLABLE + + T_CALLABLE + (int) + callable Значение с типом callable - T_CASE + + T_CASE + (int) + case Выражение switch - T_CATCH + + T_CATCH + (int) + catch - T_CLASS + + T_CLASS + (int) + class Классы и объекты - T_CLASS_C + + T_CLASS_C + (int) + __CLASS__ Магические константы - T_CLONE + + T_CLONE + (int) + clone Классы и объекты - T_CLOSE_TAG + + T_CLOSE_TAG + (int) + ?> или %> PHP-код внутри HTML-разметки - T_COALESCE + + T_COALESCE + (int) + ?? Операторы сравнения - T_COALESCE_EQUAL + + T_COALESCE_EQUAL + (int) + ??= Операторы присваивания, @@ -180,32 +246,50 @@ defined('T_FN') || define('T_FN', 10001); - T_COMMENT + + T_COMMENT + (int) + // или #, и /* */ Комментарии - T_CONCAT_EQUAL + + T_CONCAT_EQUAL + (int) + .= Операторы присваивания - T_CONST + + T_CONST + (int) + const Константы класса - T_CONSTANT_ENCAPSED_STRING + + T_CONSTANT_ENCAPSED_STRING + (int) + "foo" или 'bar' Строковый синтаксис - T_CONTINUE + + T_CONTINUE + (int) + continue Инструкция continue - T_CURLY_OPEN + + T_CURLY_OPEN + (int) + {$ Расширенная @@ -213,51 +297,78 @@ defined('T_FN') || define('T_FN', 10001); - T_DEC + + T_DEC + (int) + -- Операторы инкремента и декремента - T_DECLARE + + T_DECLARE + (int) + declare Конструкция declare - T_DEFAULT + + T_DEFAULT + (int) + default Выражение switch - T_DIR + + T_DIR + (int) + __DIR__ Магические константы - T_DIV_EQUAL + + T_DIV_EQUAL + (int) + /= Операторы присваивания - T_DNUMBER + + T_DNUMBER + (int) + 0.12 и т. д. Числа с плавающей точкой - T_DO + + T_DO + (int) + do Цикл do..while - T_DOC_COMMENT + + T_DOC_COMMENT + (int) + /** */ PHPDoc-комментарии - T_DOLLAR_OPEN_CURLY_BRACES + + T_DOLLAR_OPEN_CURLY_BRACES + (int) + ${ Базовая @@ -265,54 +376,84 @@ defined('T_FN') || define('T_FN', 10001); - T_DOUBLE_ARROW + + T_DOUBLE_ARROW + (int) + => Синтаксис массивов - T_DOUBLE_CAST + + T_DOUBLE_CAST + (int) + (real), (double) или (float) Приведение типов - T_DOUBLE_COLON + + T_DOUBLE_COLON + (int) + :: Смотрите описание токена T_PAAMAYIM_NEKUDOTAYIM ниже - T_ECHO + + T_ECHO + (int) + echo Конструкция echo - T_ELLIPSIS + + T_ELLIPSIS + (int) + ... Аргументы функции - T_ELSE + + T_ELSE + (int) + else Инструкция else - T_ELSEIF + + T_ELSEIF + (int) + elseif Инструкция elseif - T_EMPTY + + T_EMPTY + (int) + empty Конструкция empty - T_ENCAPSED_AND_WHITESPACE + + T_ENCAPSED_AND_WHITESPACE + (int) + " $a" Константная часть строки с переменными - T_ENDDECLARE + + T_ENDDECLARE + (int) + enddeclare Конструкция declare, @@ -320,7 +461,10 @@ defined('T_FN') || define('T_FN', 10001); - T_ENDFOR + + T_ENDFOR + (int) + endfor Цикл for, @@ -328,14 +472,20 @@ defined('T_FN') || define('T_FN', 10001); - T_ENDFOREACH + + T_ENDFOREACH + (int) + endforeach Конструкция &foreach;, альтернативный синтаксис - T_ENDIF + + T_ENDIF + (int) + endif Инструкция if, @@ -343,7 +493,10 @@ defined('T_FN') || define('T_FN', 10001); - T_ENDSWITCH + + T_ENDSWITCH + (int) + endswitch Инструкция switch, @@ -351,7 +504,10 @@ defined('T_FN') || define('T_FN', 10001); - T_ENDWHILE + + T_ENDWHILE + (int) + endwhile Цикл while, @@ -359,27 +515,42 @@ defined('T_FN') || define('T_FN', 10001); - T_ENUM + + T_ENUM + (int) + enum Перечисления, доступны с PHP 8.1.0 - T_END_HEREDOC + + T_END_HEREDOC + (int) + Синтаксис heredoc - T_EVAL + + T_EVAL + (int) + eval() Конструкция eval - T_EXIT + + T_EXIT + (int) + exit или die Функции exit и die - T_EXTENDS + + T_EXTENDS + (int) + extends Ключевое слово extends, @@ -387,22 +558,34 @@ defined('T_FN') || define('T_FN', 10001); - T_FILE + + T_FILE + (int) + __FILE__ Магические константы - T_FINAL + + T_FINAL + (int) + final - T_FINALLY + + T_FINALLY + (int) + finally - T_FN + + T_FN + (int) + fn Стрелочные функции, @@ -410,274 +593,424 @@ defined('T_FN') || define('T_FN', 10001); - T_FOR + + T_FOR + (int) + for Цикл for - T_FOREACH + + T_FOREACH + (int) + foreach Конструкция &foreach; - T_FUNCTION + + T_FUNCTION + (int) + function Функции - T_FUNC_C + + T_FUNC_C + (int) + __FUNCTION__ Магические константы - T_GLOBAL + + T_GLOBAL + (int) + global Область видимости переменной - T_GOTO + + T_GOTO + (int) + goto Оператор goto - T_HALT_COMPILER + + T_HALT_COMPILER + (int) + __halt_compiler() Функция - T_IF + + T_IF + (int) + if Конструкция if - T_IMPLEMENTS + + T_IMPLEMENTS + (int) + implements - T_INC + + T_INC + (int) + ++ Операторы инкремента и декремента - T_INCLUDE + + T_INCLUDE + (int) + include Выражение include - T_INCLUDE_ONCE + + T_INCLUDE_ONCE + (int) + include_once Выражение include_once - T_INLINE_HTML + + T_INLINE_HTML + (int) + Текст вне PHP-кода - T_INSTANCEOF + + T_INSTANCEOF + (int) + instanceof Оператор проверки типа - T_INSTEADOF + + T_INSTEADOF + (int) + insteadof - T_INTERFACE + + T_INTERFACE + (int) + interface - T_INT_CAST + + T_INT_CAST + (int) + (int) или (integer) Приведение типов - T_ISSET + + T_ISSET + (int) + isset() Конструкция isset - T_IS_EQUAL + + T_IS_EQUAL + (int) + == Операторы сравнения - T_IS_GREATER_OR_EQUAL + + T_IS_GREATER_OR_EQUAL + (int) + >= Операторы сравнения - T_IS_IDENTICAL + + T_IS_IDENTICAL + (int) + === Операторы сравнения - T_IS_NOT_EQUAL + + T_IS_NOT_EQUAL + (int) + != или <> Операторы сравнения - T_IS_NOT_IDENTICAL + + T_IS_NOT_IDENTICAL + (int) + !== Операторы сравнения - T_IS_SMALLER_OR_EQUAL + + T_IS_SMALLER_OR_EQUAL + (int) + <= Операторы сравнения - T_LINE + + T_LINE + (int) + __LINE__ Магические константы - T_LIST + + T_LIST + (int) + list() Конструкция list - T_LNUMBER + + T_LNUMBER + (int) + 123, 012, 0x1ac и т.д. Целые числа - T_LOGICAL_AND + + T_LOGICAL_AND + (int) + and Логические операторы - T_LOGICAL_OR + + T_LOGICAL_OR + (int) + or Логические операторы - T_LOGICAL_XOR + + T_LOGICAL_XOR + (int) + xor Логические операторы - T_MATCH + + T_MATCH + (int) + match Выражение &match;, доступно с PHP 8.0.0 - T_METHOD_C + + T_METHOD_C + (int) + __METHOD__ Магические константы - T_MINUS_EQUAL + + T_MINUS_EQUAL + (int) + -= Операторы присваивания - T_MOD_EQUAL + + T_MOD_EQUAL + (int) + %= Операторы присваивания - T_MUL_EQUAL + + T_MUL_EQUAL + (int) + *= Операторы присваивания - T_NAMESPACE + + T_NAMESPACE + (int) + namespace Пространства имён - T_NAME_FULLY_QUALIFIED + + T_NAME_FULLY_QUALIFIED + (int) + \App\Namespace Пространства имён, токен доступен с PHP 8.0.0 - T_NAME_QUALIFIED + + T_NAME_QUALIFIED + (int) + App\Namespace Пространства имён, токен доступен с PHP 8.0.0 - T_NAME_RELATIVE + + T_NAME_RELATIVE + (int) + namespace\Namespace Пространства имён, токен доступен с PHP 8.0.0 - T_NEW + + T_NEW + (int) + new Классы и объекты - T_NS_C + + T_NS_C + (int) + __NAMESPACE__ Пространства имён - T_NS_SEPARATOR + + T_NS_SEPARATOR + (int) + \ Пространства имён - T_NUM_STRING + + T_NUM_STRING + (int) + "$a[0]" Цифровой индекс массива внутри строки - T_OBJECT_CAST + + T_OBJECT_CAST + (int) + (object) Приведение типов - T_OBJECT_OPERATOR + + T_OBJECT_OPERATOR + (int) + -> Классы и объекты - T_NULLSAFE_OBJECT_OPERATOR + + T_NULLSAFE_OBJECT_OPERATOR + (int) + ?-> Классы и объекты - T_OPEN_TAG + + T_OPEN_TAG + (int) + <?php, <? или <% PHP-код внутри HTML-разметки - T_OPEN_TAG_WITH_ECHO + + T_OPEN_TAG_WITH_ECHO + (int) + <?= или <%= PHP-код внутри HTML-разметки - T_OR_EQUAL + + T_OR_EQUAL + (int) + |= Операторы присваивания - T_PAAMAYIM_NEKUDOTAYIM + + T_PAAMAYIM_NEKUDOTAYIM + (int) + :: Оператор разрешения области видимости. @@ -685,139 +1018,208 @@ defined('T_FN') || define('T_FN', 10001); - T_PLUS_EQUAL + + T_PLUS_EQUAL + (int) + += Операторы присваивания - T_POW + + T_POW + (int) + ** Арифметические операторы - T_POW_EQUAL + + T_POW_EQUAL + (int) + **= Операторы присваивания - T_PRINT + + T_PRINT + (int) + print Конструкция print - T_PRIVATE + + T_PRIVATE + (int) + private Классы и объекты - T_PRIVATE_SET + + T_PRIVATE_SET + (int) + private(set) Хуки свойств, доступны с PHP 8.4.0 - T_PROPERTY_C + + T_PROPERTY_C + (int) + __PROPERTY__ Магические константы - T_PROTECTED + + T_PROTECTED + (int) + protected Классы и объекты - T_PROTECTED_SET + + T_PROTECTED_SET + (int) + protected(set) Хуки свойств, доступны с PHP 8.4.0 - T_PUBLIC + + T_PUBLIC + (int) + public Классы и объекты - T_PUBLIC_SET + + T_PUBLIC_SET + (int) + public(set) Хуки свойств, доступны с PHP 8.4.0 - T_READONLY + + T_READONLY + (int) + readonly Классы и объекты (доступно с PHP 8.1.0) - T_REQUIRE + + T_REQUIRE + (int) + require Выражение require - T_REQUIRE_ONCE + + T_REQUIRE_ONCE + (int) + require_once Выражение require_once - T_RETURN + + T_RETURN + (int) + return Возвращаемые значения - T_SL + + T_SL + (int) + << Побитовые операторы - T_SL_EQUAL + + T_SL_EQUAL + (int) + <<= Операторы присваивания - T_SPACESHIP + + T_SPACESHIP + (int) + <=> Операторы сравнения - T_SR + + T_SR + (int) + >> Побитовые операторы - T_SR_EQUAL + + T_SR_EQUAL + (int) + >>= Операторы присваивания - T_START_HEREDOC + + T_START_HEREDOC + (int) + <<< Синтаксис heredoc - T_STATIC + + T_STATIC + (int) + static Область видимости переменной - T_STRING + + T_STRING + (int) + parent, self и т. п. Идентификаторы наподобие ключевых слов parent и self, @@ -826,90 +1228,141 @@ defined('T_FN') || define('T_FN', 10001); - T_STRING_CAST + + T_STRING_CAST + (int) + (string) Приведение типов - T_STRING_VARNAME + + T_STRING_VARNAME + (int) + "${a Интерполяция переменной переменной в строке - T_SWITCH + + T_SWITCH + (int) + switch Инструкция switch - T_THROW + + T_THROW + (int) + throw - T_TRAIT + + T_TRAIT + (int) + trait - T_TRAIT_C + + T_TRAIT_C + (int) + __TRAIT__ Константа __TRAIT__ - T_TRY + + T_TRY + (int) + try - T_UNSET + + T_UNSET + (int) + unset() Конструкция unset - T_UNSET_CAST + + T_UNSET_CAST + (int) + (unset) Приведение типов - T_USE + + T_USE + (int) + use Пространства имён - T_VAR + + T_VAR + (int) + var Классы и объекты - T_VARIABLE + + T_VARIABLE + (int) + $foo переменные - T_WHILE + + T_WHILE + (int) + while Циклы while, do..while - T_WHITESPACE + + T_WHITESPACE + (int) + \t \r\n - T_XOR_EQUAL + + T_XOR_EQUAL + (int) + ^= Операторы присваивания - T_YIELD + + T_YIELD + (int) + yield Генераторы - T_YIELD_FROM + + T_YIELD_FROM + (int) + yield from Генераторы diff --git a/reference/dir/constants.xml b/reference/dir/constants.xml index eeb6c3d04..8ae8ae609 100644 --- a/reference/dir/constants.xml +++ b/reference/dir/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; @@ -7,7 +7,7 @@ DIRECTORY_SEPARATOR - (string) + (string) @@ -18,7 +18,7 @@ PATH_SEPARATOR - (string) + (string) @@ -29,7 +29,7 @@ SCANDIR_SORT_ASCENDING - (int) + (int) @@ -40,7 +40,7 @@ SCANDIR_SORT_DESCENDING - (int) + (int) @@ -51,7 +51,7 @@ SCANDIR_SORT_NONE - (int) + (int) diff --git a/reference/iconv/constants.xml b/reference/iconv/constants.xml index 669e85a3c..401a11ee2 100644 --- a/reference/iconv/constants.xml +++ b/reference/iconv/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; @@ -18,12 +18,18 @@ - ICONV_IMPL + + ICONV_IMPL + (string) + string Реализация - ICONV_VERSION + + ICONV_VERSION + (string) + string Версия реализации @@ -50,12 +56,18 @@ - ICONV_MIME_DECODE_STRICT + + ICONV_MIME_DECODE_STRICT + (int) + int Битовая маска, используемая в iconv_mime_decode - ICONV_MIME_DECODE_CONTINUE_ON_ERROR + + ICONV_MIME_DECODE_CONTINUE_ON_ERROR + (int) + int Битовая маска, используемая в iconv_mime_decode diff --git a/reference/mysqli/constants.xml b/reference/mysqli/constants.xml index 2e332921d..72575e5d7 100644 --- a/reference/mysqli/constants.xml +++ b/reference/mysqli/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; @@ -150,7 +150,7 @@ MYSQLI_CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS - (int) + (int) @@ -163,7 +163,7 @@ MYSQLI_CLIENT_FOUND_ROWS - (int) + (int) @@ -174,7 +174,7 @@ MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT - (int) + (int) diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index 1330dbb7b..f23955f0c 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; From 951a14e26366fd3a61b6ce0b53befc506a40b512 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 11 May 2026 10:11:51 +0200 Subject: [PATCH 5/5] Sync EN: rewrite persistent-connections impersonal style --- features/persistent-connections.xml | 48 ++++++++++++++--------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/features/persistent-connections.xml b/features/persistent-connections.xml index bea3690ab..d28d8f31d 100644 --- a/features/persistent-connections.xml +++ b/features/persistent-connections.xml @@ -1,5 +1,5 @@ - + Постоянные соединения с базами данных @@ -18,12 +18,12 @@ Нет способа запросить конкретное соединение или гарантировать, - что вы получите существующее соединение или совершенно новое + что вернётся существующее соединение или совершенно новое (если все существующие соединения заняты или запрос обслуживается другим процессом, у которого есть отдельный пул соединений). - Это значит, что вы не можете использовать постоянные соединения PHP, например, для: + Поэтому постоянные соединения PHP нельзя использовать, например, для: назначения определённой сессии базы данных конкретному веб-пользователю @@ -31,8 +31,8 @@ инициализации запроса для одного запроса и собирания результатов по другому - Постоянные соединения не предоставляют вам никаких функций, - которые были бы недоступны при использовании непостоянных соединений. + Постоянные соединения не предоставляют никакой функциональности, + которая была бы недоступна при использовании непостоянных соединений. @@ -48,8 +48,8 @@ обращении к странице (PHP-скрипту). Поскольку интерпретатор уничтожается после каждого запроса к серверу, все используемые им ресурсы (в том числе и соединение с базой данных) закрываются. Следовательно, - в этом случае вы не получите ничего от использования постоянных соединений - - их просто нет. + в этом случае от использования постоянных соединений ничего не выигрывается: + они просто не сохраняются. Второй и наиболее популярный метод заключается в запуске PHP-FPM или PHP @@ -68,8 +68,8 @@ - Вы можете проверить, какой метод используют ваши веб-запросы, - проверив значение «Server API» в выводе функции phpinfo + Чтобы проверить, какой метод используют веб-запросы, посмотрите значение + «Server API» в выводе функции phpinfo или значение константы PHP_SAPI, полученное из веб-запроса. @@ -89,7 +89,7 @@ Поскольку PHP в командной строке использует новый процесс для каждого скрипта, постоянные соединения не используются совместно между скриптами командной строки, поэтому нет смысла использовать их во временных скриптах, таких как задания Cron или команды. - Однако они могут быть полезны, если, например, вы пишете долго работающий сервер приложений, + Однако они могут быть полезны, например, в долго работающем сервере приложений, который обслуживает много запросов или задач, и каждому из них может потребоваться собственное соединение с базой данных. @@ -101,17 +101,17 @@ Постоянные соединения полезны в том случае, если при открытии большого количества SQL-соединений возникает ощутимая нагрузка на сервер. То, насколько велика эта нагрузка, зависит от многих факторов. Например, от того, какая именно база данных - используется, находится ли она на том же компьютере что и ваш веб-сервер, + используется, находится ли она на том же компьютере, что и веб-сервер, насколько загружена машина, на которой установлен SQL-сервер, и так далее. В случае, если затраты на установку соединения велики, постоянные соединения - могут вам существенно помочь. Они позволяют дочернему процессу на + способны существенно помочь. Они позволяют дочернему процессу на протяжении всего жизненного цикла использовать одно и то же соединение вместо того, чтобы создавать его при обработке каждой страницы, которая взаимодействует с SQL-сервером. Это означает, что каждый дочерний процесс, открывший постоянное соединение, будет иметь своё собственное - соединение с сервером. Например, если у вас запущено 20 дочерних процессов, + соединение с сервером. Например, если запущено 20 дочерних процессов, которые выполнили скрипт, использовавший постоянное соединение с SQL-сервером, - вы получите 20 различных соединений с SQL-сервером, по одному на каждый дочерний + получится 20 различных соединений с SQL-сервером, по одному на каждый дочерний процесс. @@ -119,13 +119,13 @@ Возможные недостатки: ограничения подключения - Следует заметить, что этот подход имеет некоторые недостатки: если - вы используете базу данных с ограниченным количеством возможных - подключений, оно может быть превышено количеством запрашиваемых - дочерними процессами постоянных соединений. Например, если ваша база + Следует заметить, что этот подход имеет некоторые недостатки: при + использовании базы данных с ограниченным количеством возможных + подключений оно может быть превышено количеством запрашиваемых + дочерними процессами постоянных соединений. Например, если база данных позволяет 16 одновременных соединений, и во время нагрузки на сервер 17 дочерних процессов попробуют открыть соединение, одна из - попыток потерпит неудачу. Если в вашем коде содержатся ошибки, не позволяющие + попыток потерпит неудачу. Если в коде содержатся ошибки, не позволяющие закрывать соединение (например, бесконечные циклы), база данных с 16 одновременными подключениями вскоре может оказаться заблокированной. @@ -181,10 +181,10 @@ Если временные таблицы не очищаются, последующие запросы не смогут воссоздать ту же таблицу. - Вы можете реализовать очистку с помощью деструкторов классов или + Очистку можно реализовать с помощью деструкторов классов или функции register_shutdown_function. - Вы также можете рассмотреть возможность использования специальных прокси-серверов для пула подключений, - которые включают функцию в свой набор возможностей. + Также можно рассмотреть возможность использования специальных прокси-серверов + для пула подключений, которые включают функцию в свой набор возможностей. @@ -193,8 +193,8 @@ Учитывая их поведение и потенциальные недостатки, описанные выше, не следует использовать постоянные соединения без тщательного обдумывания. - Их не следует использовать без внедрения дополнительных изменений в ваше приложение - и тщательной настройки вашего сервера базы данных и веб-сервера и/или PHP-FPM. + Их не следует использовать без внесения дополнительных изменений в приложение + и тщательной настройки сервера базы данных и веб-сервера и/или PHP-FPM. Рассмотрите альтернативные решения, такие как исследование и устранение причин накладных расходов