From 30adf968f80b6dde922fb3f4ebf56af0b51f9ae3 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 31 Aug 2026 12:15:36 +0200 Subject: [PATCH 1/9] flock.xml: document the potential Windows deadlock --- reference/filesystem/functions/flock.xml | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 20d6e147dd..0830651a85 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -1,5 +1,5 @@ - + @@ -199,12 +199,33 @@ fclose($fp); наподобие FAT и её производные, поэтому функцию будет возвращать &false; в этих окружениях. + + В Windows попытка выполнить файл с PHP-исходным кодом, который заблокировали + флагом LOCK_EX, приводит к зависанию до тех пор, пока + файл не разблокируют. Следующий пример приводит к взаимоблокировке: + + + +]]> + + + Если в Windows процесс блокировки открывает файл во второй раз, он не может получить доступ к файлу через второй дескриптор, пока не разблокирует файл. + + В Windows попытка подключить файл, который заблокировали флагом LOCK_EX, + завершится ошибкой ErrorException: require(): Read of X bytes failed with errno=13 Permission denied + From 5597c55b9bd91010a35d7758a4b7dee3029ab1b7 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Sun, 8 Nov 2026 17:30:39 +0100 Subject: [PATCH 2/9] Sync flock() with the PHP 8.5 gzopen() lock support note --- reference/filesystem/functions/flock.xml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 0830651a85..d276242d9c 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -1,5 +1,5 @@ - + @@ -173,12 +173,14 @@ fclose($fp); - + Функцию разрешено вызывать только на дескрипторах локальных файлов, которые возвращает функция fopen, или файловых дескрипторах пользовательских потоков, которые реализуют метод streamWrapper::stream_lock. - + Начиная с PHP 8.5.0 функцию также разрешено вызывать на файловых + дескрипторах, которые возвращает функция gzopen. + From 5a6cb5e855886f59da9155b341700cf2ddc44932 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Sun, 8 Nov 2026 17:37:18 +0100 Subject: [PATCH 3/9] Sync the zlib pages with the PHP 8.5 default stream context and flock changes --- reference/zlib/functions/gzfile.xml | 9 ++++++++- reference/zlib/functions/gzopen.xml | 16 +++++++++++++++- reference/zlib/functions/readgzfile.xml | 9 ++++++++- 3 files changed, 31 insertions(+), 3 deletions(-) diff --git a/reference/zlib/functions/gzfile.xml b/reference/zlib/functions/gzfile.xml index f8049601d7..059089682b 100644 --- a/reference/zlib/functions/gzfile.xml +++ b/reference/zlib/functions/gzfile.xml @@ -1,5 +1,5 @@ - + @@ -68,6 +68,13 @@ Ранее он был целым числом (int). + + 8.5.0 + + Теперь при открытии файла применяется контекст потока по умолчанию + (см. stream_context_set_default). Раньше он игнорировался. + + diff --git a/reference/zlib/functions/gzopen.xml b/reference/zlib/functions/gzopen.xml index 59b9e7ca8f..b0755aebe7 100644 --- a/reference/zlib/functions/gzopen.xml +++ b/reference/zlib/functions/gzopen.xml @@ -1,5 +1,5 @@ - + @@ -92,6 +92,20 @@ Ранее он был целым числом (int). + + 8.5.0 + + Теперь при открытии файла применяется контекст потока по умолчанию + (см. stream_context_set_default). Раньше он игнорировался. + + + + 8.5.0 + + Теперь с возвращённым файловым дескриптором разрешено работать функцией flock. + Раньше функция всегда возвращала &false;. + + diff --git a/reference/zlib/functions/readgzfile.xml b/reference/zlib/functions/readgzfile.xml index 2139e8d198..68f1397a31 100644 --- a/reference/zlib/functions/readgzfile.xml +++ b/reference/zlib/functions/readgzfile.xml @@ -1,5 +1,5 @@ - + @@ -77,6 +77,13 @@ Ранее он был целым числом (int). + + 8.5.0 + + Теперь при открытии файла применяется контекст потока по умолчанию + (см. stream_context_set_default). Раньше он игнорировался. + + From f71fa86d81cc5e276112323d6cd13a4a28c38150 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 9 Nov 2026 16:32:17 +0100 Subject: [PATCH 4/9] flock, zlib: fix the flock subject, a typo and the example endings --- reference/filesystem/functions/flock.xml | 5 +---- reference/zlib/functions/gzfile.xml | 2 +- reference/zlib/functions/gzopen.xml | 6 +++--- reference/zlib/functions/readgzfile.xml | 2 +- 4 files changed, 6 insertions(+), 9 deletions(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index d276242d9c..1fdd8fd584 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -118,8 +118,6 @@ if (flock($fp, LOCK_EX)) { // Выполняем эксклюзивную бло } fclose($fp); - -?> ]]> @@ -142,7 +140,6 @@ if (!flock($fp, LOCK_EX | LOCK_NB)) { /* ... */ fclose($fp); -?> ]]> @@ -209,11 +206,11 @@ fclose($fp); ]]> diff --git a/reference/zlib/functions/gzfile.xml b/reference/zlib/functions/gzfile.xml index 059089682b..d0e0399311 100644 --- a/reference/zlib/functions/gzfile.xml +++ b/reference/zlib/functions/gzfile.xml @@ -88,11 +88,11 @@ ]]> diff --git a/reference/zlib/functions/gzopen.xml b/reference/zlib/functions/gzopen.xml index b0755aebe7..3a71e29912 100644 --- a/reference/zlib/functions/gzopen.xml +++ b/reference/zlib/functions/gzopen.xml @@ -70,7 +70,7 @@ записываете - упаковываться. - В случае возникновения ошибки функция возвращает &false;. + Если возникла ошибка, функция возвращает &false;. @@ -103,7 +103,7 @@ 8.5.0 Теперь с возвращённым файловым дескриптором разрешено работать функцией flock. - Раньше функция всегда возвращала &false;. + Раньше функция flock всегда возвращала &false;. @@ -119,8 +119,8 @@ ]]> diff --git a/reference/zlib/functions/readgzfile.xml b/reference/zlib/functions/readgzfile.xml index 68f1397a31..4dfdb70518 100644 --- a/reference/zlib/functions/readgzfile.xml +++ b/reference/zlib/functions/readgzfile.xml @@ -38,7 +38,7 @@ use_include_path - Со значением &true; функция определят путь к файлу, который требуется открыть, + Со значением &true; функция определяет путь к файлу, который требуется открыть, с учётом значения директивы include_path. From 419719864d7b2f8e31b8a716d06dcb6caaf56243 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 11 Nov 2026 10:30:07 +0100 Subject: [PATCH 5/9] Apply the wording conventions of CONTRIBUTING.md --- reference/filesystem/functions/flock.xml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 1fdd8fd584..945793c19c 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -207,7 +207,9 @@ fclose($fp); Date: Mon, 16 Nov 2026 20:58:13 +0300 Subject: [PATCH 6/9] Update flock.xml --- reference/filesystem/functions/flock.xml | 130 ++++++++++++----------- 1 file changed, 67 insertions(+), 63 deletions(-) diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 945793c19c..72b1959389 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -4,7 +4,7 @@ flock - Блокирует файл методом переносимой рекомендательной блокировки + Устанавливает переносимую рекомендательную блокировку файла @@ -16,21 +16,23 @@ intwould_block&null; - Функция flock разрешает выполнять простую модель - чтения-записи, которая будет работать на большей части Unix-платформ - и даже на платформах семейства Windows. + Функция flock устанавливает блокировку файла на чтение или запись. + Функция помогает организовать модель «читатель-писатель», + которая поддерживается на большей части платформ на основе Unix и даже в Windows. - Блокировку также снимает функция fclose - или сборщик мусора, когда уничтожает поток stream. + Вызов функции с флагом LOCK_UN снимает блокировку. + Блокировка также снимается при вызове функции fclose + или когда сборщик мусора уничтожает поток stream. - PHP поддерживает способ полной переносимой рекомендательной блокировки - файлов. То есть каждая программа, которая получает доступ к файлу, - должна использовать один и тот же способ блокировки, иначе блокировка не будет - работать. По умолчанию функция будет блокироваться до тех пор, - пока запрошенная блокировка не будет получена; это поведение изменяют - через описанный ниже флаг LOCK_NB. + PHP поддерживает переносимый способ блокировки файлов целиком, + который держится на «джентльменском соглашении» и работает, + только если при доступе к файлу каждая программа действует в рамках единой согласованной модели блокировок — + вызывает функцию flock и учитывает чужие блокировки. + По умолчанию функция приостанавливает выполнение скрипта и ждёт, + пока не получит запрошенную блокировку файла, + если только поведение блокировки не изменили флагом LOCK_NB. @@ -48,30 +50,29 @@ operation - operation принимает следующие значения: + Параметр operation принимает следующие значения: - LOCK_SH для получения разделяемой блокировки (чтение). + LOCK_SH — разделяемая блокировка при чтении. - LOCK_EX для получения эксклюзивной блокировки (запись). + LOCK_EX — эксклюзивная блокировка при записи. - LOCK_UN для снятия блокировки (разделяемой или эксклюзивной). + LOCK_UN — снятие блокировки, разделяемой или эксклюзивной. - Флаг LOCK_NB добавляют - как битовую маску к одной операции из списка выше, - если функция flock не должна - блокироваться во время попытки блокировки файла. + Флаг LOCK_NB добавляют к приведённым операциям + как битовую маску, чтобы при попытке заблокировать файл + функция flock не приостанавливала выполнение скрипта. @@ -79,9 +80,10 @@ would_block - Необязательный третий параметр получает значение 1, - если блокировка будет блокирующей - (в переменную errno будет записан код ошибки EWOULDBLOCK). + При вызове с флагом LOCK_NB на занятом файле + выполняется условие, при котором системная переменная errno заполняется значением EWOULDBLOCK, + и третий необязательный параметр заполняется значением 1. Единица указывает, + что при блокирующем вызове потребовалось бы приостановить выполнение скрипта и ждать, пока файл не освободится. @@ -100,21 +102,21 @@ &reftitle.examples; - Пример использования функции <function>flock</function> + Пример блокировки файла функцией <function>flock</function> - Использование функции <function>flock</function> с параметром <constant>LOCK_NB</constant> + Пример вызова функции <function>flock</function> с флагом <constant>LOCK_NB</constant> - В системах Windows функция flock включает обязательную - блокировку вместо рекомендательной. Обязательная - блокировка также поддерживается в операционных системах на базе Linux и System V - через стандартный механизм, который - поддерживает системный вызов fcntl(): то есть, если для файла + В системах Windows функция flock устанавливает обязательную, + а не рекомендательную блокировку. Обязательная блокировка + также поддерживается в операционных системах на базе Linux и System V + через стандартный механизм, + который поддерживается системным вызовом fcntl(): если для файла установлен бит разрешения setgid и сброшен бит группового выполнения. - Чтобы схема работала корректно в Linux, файловую систему - также нужно смонтировать с опцией mand. + Для корректной работы схемы в Linux файловую систему + монтируют с опцией mand. - Поскольку функция flock требует указатель - на файл, возможно, придётся использовать специальный файл - блокировки, чтобы защитить доступ к файлу, который вы собираетесь обрезать, - открыв в режиме записи (в режимах «w» или «w+» - в качестве аргумента функции fopen). + Для блокировки файла функции flock требуется файловый указатель, + а функция fopen при вызове с аргументами "w" или "w+" + сначала усекает файл, а только потом возвращает указатель на файл. + Поэтому защита файла строится на дополнительном lock-файле: вначале получают блокировку дополнительного файла, + а только потом усекают целевой файл. - Функцию разрешено вызывать только на дескрипторах локальных файлов, - которые возвращает функция fopen, или файловых - дескрипторах пользовательских потоков, которые реализуют метод - streamWrapper::stream_lock. - Начиная с PHP 8.5.0 функцию также разрешено вызывать на файловых - дескрипторах, которые возвращает функция gzopen. + Функция работает только при вызове на файловых указателях, + которые функция fopen возвращает для локальных файлов, + или указателях пользовательских потоков, + которые реализуют метод streamWrapper::stream_lock. + Начиная с PHP 8.5.0 появилась поддержка файловых указателей, + которые возвращает функция gzopen. - Присвоение другого значения параметру stream - в следующем дальше коде снимет текущую блокировку. + Текущая блокировка снимется, если после вызова функции переменной, + которую передали в параметр stream, присвоить другое значение. В ряде операционных систем функция flock работает - на уровне процессов. При работе с многопоточными серверными API, - например, ISAPI, нельзя полагаться на функцию flock, - чтобы защитить файлы от других PHP-скриптов, которые - работают в параллельном потоке на том же сервере! + на уровне процессов. При работе с многопоточными серверными API + наподобие ISAPI нельзя полагаться на функцию flock, + чтобы защитить файлы от других PHP-скриптов, + которые работают в параллельном потоке на том же сервере! - Функцию flock не поддерживают старые файловые системы - наподобие FAT и её производные, поэтому функцию будет - возвращать &false; в этих окружениях. + Старые файловые системы наподобие FAT и производные файловые системы + не поддерживают функцию flock, + поэтому в таких окружения функция возвращает &false;. - В Windows попытка выполнить файл с PHP-исходным кодом, который заблокировали - флагом LOCK_EX, приводит к зависанию до тех пор, пока - файл не разблокируют. Следующий пример приводит к взаимоблокировке: + В Windows попытка выполнить из PHP файл с исходным PHP-кодом, + на который через флаг LOCK_EX поставили эксклюзивную блокировку, + зависнет, пока файл не освободится. Следующий пример вызовет взаимную блокировку: @@ -220,12 +224,12 @@ shell_exec("php " . escapeshellarg(__FILE__) . " child"); - Если в Windows процесс блокировки открывает файл во второй раз, он не может - получить доступ к файлу через второй дескриптор, пока не разблокирует файл. + В Windows процесс, который уже держит блокировку файла, не получит доступ к файлу через второй дескриптор, + пока не освободится блокировка первого дескриптора. В Windows попытка подключить файл, который заблокировали флагом LOCK_EX, - завершится ошибкой ErrorException: require(): Read of X bytes failed with errno=13 Permission denied + выбросит исключение ErrorException: require(): Read of X bytes failed with errno=13 Permission denied From 3565b0d6887c1bfea42dd55294e72262e09e9494 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 16 Nov 2026 21:33:51 +0300 Subject: [PATCH 7/9] Update gzfile.xml --- reference/zlib/functions/gzfile.xml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/reference/zlib/functions/gzfile.xml b/reference/zlib/functions/gzfile.xml index d0e0399311..0c7ed4d28b 100644 --- a/reference/zlib/functions/gzfile.xml +++ b/reference/zlib/functions/gzfile.xml @@ -14,7 +14,7 @@ booluse_include_path&false; - Аналогична readgzfile, за исключением того, что она возвращает файл в массиве. + Функция аналогична функции readgzfile, но возвращает содержимое файла в виде массива. @@ -25,7 +25,7 @@ filename - Имя файла. + Название файла. @@ -33,8 +33,8 @@ use_include_path - Если установлено значение &true;, то также выполняется поиск файлов - в include_path. + При установке значения &true; функция ищет файлы + также в списке каталогов директивы include_path. @@ -45,8 +45,8 @@ &reftitle.returnvalues; - Массив строк файла, в каждом элементе массива находится одна строка, - пустые строки включаются, а переносы строк по-прежнему добавляются&return.falseforfailure;. + Функция возвращает массив строк файла&return.falseforfailure;; + каждый элемент содержит одну строку, пустые строки включаются, переводы строк сохраняются. @@ -64,15 +64,15 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. 8.5.0 - Теперь при открытии файла применяется контекст потока по умолчанию - (см. stream_context_set_default). Раньше он игнорировался. + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался. @@ -84,7 +84,7 @@ &reftitle.examples; - Пример использования <function>gzfile</function> + Пример считывания gz-файла функцией <function>gzfile</function> Date: Mon, 16 Nov 2026 22:33:17 +0300 Subject: [PATCH 8/9] Update gzopen.xml --- reference/zlib/functions/gzopen.xml | 51 ++++++++++++++--------------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/reference/zlib/functions/gzopen.xml b/reference/zlib/functions/gzopen.xml index 3a71e29912..abcb4853e8 100644 --- a/reference/zlib/functions/gzopen.xml +++ b/reference/zlib/functions/gzopen.xml @@ -4,7 +4,7 @@ gzopen - Открыть gz-файл + Открывает gz-файл &reftitle.description; @@ -15,12 +15,11 @@ booluse_include_path&false; - Открывает файл gzip (.gz) для чтения или записи. + Функция открывает gzip-файл — файл с расширением .gz — для чтения или записи. - gzopen также можно использовать для чтения несжатых - файлов (то есть не в формате gzip). В этом случае gzread - будет непосредственно читать файл без какой-либо обработки. + При вызове на несжатом файле функция gzopen возвращает указатель, + по которому функция gzread считывает данные без распаковки. @@ -31,7 +30,7 @@ filename - Имя файла. + Название файла. @@ -39,13 +38,13 @@ mode - Как в fopen (rb или - wb), но также может включать уровень сжатия - (wb9) или стратегию: f для - фильтрации данных как в wb6f, h - для сжатия только по алгоритму Хаффмана, как в wb1h - (Для более детальной информации о параметре стратегии смотрите описание - deflateInit2 в zlib.h). + По аналогии с функцией fopen параметр принимает режимы доступа + наподобие rb или wb, но с дополнительным включением уровня сжатия + и (или) стратегии: целочисленные значения обозначают уровень сжатия — wb9, + f включает фильтрацию данных — wb6f, + h указывает сжимать только по алгоритму Хаффмана — wb1h. + Подробнее о параметре стратегии рассказывает описание + макроса deflateInit2 в заголовочном файле zlib.h. @@ -53,8 +52,8 @@ use_include_path - Если установлено значение &true;, то также выполняется поиск файлов - в include_path. + При установке значения &true; функция ищет файлы + также в списке каталогов директивы include_path. @@ -65,12 +64,12 @@ &reftitle.returnvalues; - Возвращает указатель на открытый файл, после чего всё, что вы читаете из - этого дескриптора, будет автоматически распаковываться, а всё, что вы - записываете - упаковываться. + Функция возвращает файловый указатель; + при чтении и записи через дескриптор открытого файла + данные автоматически распаковываются или сжимаются. - Если возникла ошибка, функция возвращает &false;. + При ошибке функция возвращает &false;. @@ -88,22 +87,22 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. 8.5.0 - Теперь при открытии файла применяется контекст потока по умолчанию - (см. stream_context_set_default). Раньше он игнорировался. + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался. 8.5.0 - Теперь с возвращённым файловым дескриптором разрешено работать функцией flock. - Раньше функция flock всегда возвращала &false;. + Функция flock теперь работает с указателем, который возвращает функция; + раньше функция flock возвращала &false;. @@ -115,7 +114,7 @@ &reftitle.examples; - Пример использования <function>gzopen</function> + Пример получения файлового указателя функцией <function>gzopen</function> Date: Tue, 17 Nov 2026 00:11:02 +0300 Subject: [PATCH 9/9] Update readgzfile.xml --- reference/zlib/functions/readgzfile.xml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/reference/zlib/functions/readgzfile.xml b/reference/zlib/functions/readgzfile.xml index 4dfdb70518..fce96d35b8 100644 --- a/reference/zlib/functions/readgzfile.xml +++ b/reference/zlib/functions/readgzfile.xml @@ -39,7 +39,7 @@ Со значением &true; функция определяет путь к файлу, который требуется открыть, - с учётом значения директивы include_path. + с учётом списка каталогов директивы include_path. @@ -50,7 +50,7 @@ &reftitle.returnvalues; - Функция возвращает количество байтов в файле после распаковки, если выполнилась успешно,&return.falseforfailure; + Функция возвращает количество байтов, которое считала из файла после распаковки, если выполнилась успешно,&return.falseforfailure; @@ -73,15 +73,15 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. 8.5.0 - Теперь при открытии файла применяется контекст потока по умолчанию - (см. stream_context_set_default). Раньше он игнорировался. + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался.