diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml index 20d6e147dd..72b1959389 100644 --- a/reference/filesystem/functions/flock.xml +++ b/reference/filesystem/functions/flock.xml @@ -1,10 +1,10 @@ - + 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,33 +102,31 @@ &reftitle.examples; - Пример использования функции <function>flock</function> + Пример блокировки файла функцией <function>flock</function> ]]> - Использование функции <function>flock</function> с параметром <constant>LOCK_NB</constant> + Пример вызова функции <function>flock</function> с флагом <constant>LOCK_NB</constant> ]]> @@ -153,58 +152,85 @@ fclose($fp); &reftitle.notes; - В системах 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. - + + Функция работает только при вызове на файловых указателях, + которые функция 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 файл с исходным PHP-кодом, + на который через флаг LOCK_EX поставили эксклюзивную блокировку, + зависнет, пока файл не освободится. Следующий пример вызовет взаимную блокировку: + + + + + - Если в Windows процесс блокировки открывает файл во второй раз, он не может - получить доступ к файлу через второй дескриптор, пока не разблокирует файл. + В Windows процесс, который уже держит блокировку файла, не получит доступ к файлу через второй дескриптор, + пока не освободится блокировка первого дескриптора. + + В Windows попытка подключить файл, который заблокировали флагом LOCK_EX, + выбросит исключение ErrorException: require(): Read of X bytes failed with errno=13 Permission denied + diff --git a/reference/zlib/functions/gzfile.xml b/reference/zlib/functions/gzfile.xml index f8049601d7..0c7ed4d28b 100644 --- a/reference/zlib/functions/gzfile.xml +++ b/reference/zlib/functions/gzfile.xml @@ -1,5 +1,5 @@ - + @@ -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,8 +64,15 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. + + + + 8.5.0 + + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался. @@ -77,15 +84,15 @@ &reftitle.examples; - Пример использования <function>gzfile</function> + Пример считывания gz-файла функцией <function>gzfile</function> ]]> diff --git a/reference/zlib/functions/gzopen.xml b/reference/zlib/functions/gzopen.xml index 59b9e7ca8f..abcb4853e8 100644 --- a/reference/zlib/functions/gzopen.xml +++ b/reference/zlib/functions/gzopen.xml @@ -1,10 +1,10 @@ - + 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,8 +87,22 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. + + + + 8.5.0 + + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался. + + + + 8.5.0 + + Функция flock теперь работает с указателем, который возвращает функция; + раньше функция flock возвращала &false;. @@ -101,12 +114,12 @@ &reftitle.examples; - Пример использования <function>gzopen</function> + Пример получения файлового указателя функцией <function>gzopen</function> ]]> diff --git a/reference/zlib/functions/readgzfile.xml b/reference/zlib/functions/readgzfile.xml index 2139e8d198..fce96d35b8 100644 --- a/reference/zlib/functions/readgzfile.xml +++ b/reference/zlib/functions/readgzfile.xml @@ -1,5 +1,5 @@ - + @@ -38,8 +38,8 @@ use_include_path - Со значением &true; функция определят путь к файлу, который требуется открыть, - с учётом значения директивы include_path. + Со значением &true; функция определяет путь к файлу, который требуется открыть, + с учётом списка каталогов директивы include_path. @@ -50,7 +50,7 @@ &reftitle.returnvalues; - Функция возвращает количество байтов в файле после распаковки, если выполнилась успешно,&return.falseforfailure; + Функция возвращает количество байтов, которое считала из файла после распаковки, если выполнилась успешно,&return.falseforfailure; @@ -73,8 +73,15 @@ 8.5.0 - Тип параметра use_include_path теперь – логическое значение (bool). - Ранее он был целым числом (int). + Тип параметра use_include_path изменили с int + на bool. + + + + 8.5.0 + + При открытии файла функция теперь работает с контекстом потока по умолчанию; + см. описание функции stream_context_set_default. Раньше контекст игнорировался.