diff --git a/appendices/comparisons.xml b/appendices/comparisons.xml index a7bfef1a8..d223d49d1 100644 --- a/appendices/comparisons.xml +++ b/appendices/comparisons.xml @@ -36,7 +36,7 @@ Бывают арифметические операции, возвращающие значение, - которое представляет константа NAN (Not A Number, + которое представляет константа NAN (Not A Number, нечисло). Любое строгое или нестрогое сравнение этого значения с любым другим, включая его самого, но исключая &true;, вернёт &false; (т. е. NAN != NAN и NAN !== NAN). diff --git a/appendices/migration83/incompatible.xml b/appendices/migration83/incompatible.xml index 512559a6b..b0fbd593e 100644 --- a/appendices/migration83/incompatible.xml +++ b/appendices/migration83/incompatible.xml @@ -157,7 +157,7 @@ И трассирующий JIT, и кеш наследования могут изменить разделяемую память (shm) после сохранения скрипта путём аннулирования его контрольной суммы. Были попытки исправить пропуски через модифицируемые указатели, но была отклонена из-за сложности. - Из-за этого решили удалить эту функцию. + Из-за этого решили удалить эту функцию. @@ -181,7 +181,7 @@ Теперь при передаче в параметр $step значения 0 - выбрасывается подробнее описанное исключение ValueError. + выбрасывается подробнее описанное исключение ValueError. Теперь выбрасывается исключение ValueError, когда diff --git a/appendices/migration83/new-features.xml b/appendices/migration83/new-features.xml index 7bb9477e8..c376e2265 100644 --- a/appendices/migration83/new-features.xml +++ b/appendices/migration83/new-features.xml @@ -106,7 +106,7 @@ echo $user_ini['listen']; // localhost:9000 Командная строка CLI - Теперь можно проверять несколько файлов (php -l file1.php file2.php — прим. перев.). + Теперь можно проверять несколько файлов (php -l file1.php file2.php — прим. перев.). diff --git a/appendices/migration83/other-changes.xml b/appendices/migration83/other-changes.xml index 196c0c0fb..5e8a27f4b 100644 --- a/appendices/migration83/other-changes.xml +++ b/appendices/migration83/other-changes.xml @@ -73,7 +73,7 @@ Потоки STDOUT, STDERR и STDIN больше не закрываются при уничтожении ресурсов, - что обычно случается при завершении работы CLI. + что обычно случается при завершении работы CLI. Однако всё ещё можно явно закрыть эти потоки через функцию fclose и похожие. @@ -292,7 +292,7 @@ Теперь для параметра $enable функция odbc_autocommit принимает значение &null;. При передаче значения &null; функция будет вести себя так же, как и при передаче значения только для одного параметра, - то есть — укажет, включена ли автофиксация или нет. + то есть — укажет, включена ли автофиксация или нет. @@ -333,7 +333,7 @@ Изменены функции mt_srand и srand, чтобы не проверять количество аргументов для определения, надо ли использовать случайное начальное число. Передача значения &null; сгенерирует случайное начальное число, при передаче значения 0 - оно и будет выбрано случайным числом. Работа функции теперь согласована с методом + оно и будет выбрано случайным числом. Работа функции теперь согласована с методом Random\Engine\Mt19937::__construct. @@ -555,7 +555,7 @@ Получение текстового содержимого из узлов теперь избегает выделения памяти, - что даёт прирост производительности. + что даёт прирост производительности. diff --git a/appendices/migration84/deprecated.xml b/appendices/migration84/deprecated.xml index 0fc250182..6d138e61c 100644 --- a/appendices/migration84/deprecated.xml +++ b/appendices/migration84/deprecated.xml @@ -104,7 +104,7 @@ function foo(T1 $a, ?T2 $b, T3 $c) {} Возведение числа в отрицательную степень эквивалентно взятию обратной величины числа, возведённого в положительную степень, противоположную отрицательной. - Например: 10-2 — то же, + Например: 10-2 — то же, что 1 / 102. Поэтому возведение числа 0 в отрицательную степень соответствует делению на 0: 0-2 — diff --git a/appendices/migration84/incompatible.xml b/appendices/migration84/incompatible.xml index 13fe09317..d157af645 100644 --- a/appendices/migration84/incompatible.xml +++ b/appendices/migration84/incompatible.xml @@ -164,7 +164,7 @@ Разработчики добавили новые предупреждения и исключения, которые срабатывают - при ошибках программирования, — когда в аргументах передают + при ошибках программирования, — когда в аргументах передают недопустимые значения. diff --git a/appendices/transports.xml b/appendices/transports.xml index 385976412..9830a4fa8 100644 --- a/appendices/transports.xml +++ b/appendices/transports.xml @@ -99,7 +99,7 @@ Протокол unix:// открывает доступ к соединению с сокетом на основе потока в Unix-домене. Протокол udg:// предоставляет альтернативный транспорт - к сокету в домене Unix — через протокол пользовательских датаграмм. + к сокету в домене Unix — через протокол пользовательских датаграмм. diff --git a/faq/com.xml b/faq/com.xml index ac22c723f..858f2bc21 100644 --- a/faq/com.xml +++ b/faq/com.xml @@ -230,7 +230,7 @@ $word = new COM("C:\docs\word.doc"); - Ответ настолько же простой, насколько и неудовлетворительный. + Ответ настолько же простой, насколько и неудовлетворительный. Точно не известно, но, скорее всего, ничего сделать невозможно. diff --git a/faq/installation.xml b/faq/installation.xml index 9e7b9c2c7..3ff736448 100644 --- a/faq/installation.xml +++ b/faq/installation.xml @@ -7,7 +7,7 @@ Раздел содержит общие вопросы о способах установки PHP. - Дистрибутивы PHP совместимы с большей частью операционных систем и веб-серверов. + Дистрибутивы PHP совместимы с большей частью операционных систем и веб-серверов. Инструкции раздела «» рассказывают, как установить PHP. @@ -37,7 +37,7 @@ Посмотрите на конфигурацию протокола FastCGI, в которой PHP выполняется в своём пространстве памяти, - если требуется подключить многопоточный модуль MPM. + если требуется подключить многопоточный модуль MPM. @@ -453,7 +453,7 @@ cgi error: - В Проводнике щёлкните правой кнопкой мыши на каталоге временных файлов — директория, + В Проводнике щёлкните правой кнопкой мыши на каталоге временных файлов — директория, путь к которой хранит переменная %TEMP%, — чтобы через свойства открыть сведения о разрешениях. Путь к каталогу временных файлов доступен из конфигурации или вывода функции phpinfo. diff --git a/faq/passwords.xml b/faq/passwords.xml index 8b5355787..e245db73e 100644 --- a/faq/passwords.xml +++ b/faq/passwords.xml @@ -30,7 +30,7 @@ Алгоритм, который применяют для хеширования паролей пользователей перед сохранением, серьёзно затрудняет раскрытие исходного - пароля злоумышленником, при этом доступ к сравнению хеша с исходным паролем + пароля злоумышленником, при этом доступ к сравнению хеша с исходным паролем в будущем сохраняется. diff --git a/features/commandline.xml b/features/commandline.xml index 2e3eb99cf..65d1cc4c4 100644 --- a/features/commandline.xml +++ b/features/commandline.xml @@ -570,7 +570,7 @@ string(15) "doesntmakesense" В случае успешного выполнения в стадартный поток вывода записывается текст No syntax errors detected in <filename>. - Вместе с внутренней информацией об ошибке парсера + Вместе с внутренней информацией об ошибке парсера в станадртный поток вывода записывается текст Errors parsing <filename>, если возникла ошибка. diff --git a/features/file-upload.xml b/features/file-upload.xml index 3e7994d28..ac3cb32a2 100644 --- a/features/file-upload.xml +++ b/features/file-upload.xml @@ -295,7 +295,7 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) { Директива max_execution_time влияет только на время выполнения самого скрипта. - Время, которое заняли действия за пределами скрипта, — системные вызовы + Время, которое заняли действия за пределами скрипта, — системные вызовы функций system или sleep, запросы к базе данных, время, которое заняла загрузка файла на сервер, и т. д. — не учитывается при определении максимального времени работы скрипта. @@ -461,7 +461,7 @@ PUT /path/filename.html HTTP/1.1 файл /path/filename.html в дереве каталогов веб-сервера. Не сомневаемся, что настраивать веб-сервер Apache или PHP так, чтобы они разрешали - каждому автоматически перезаписывать файлы веб-сервера, — плохая идея. + каждому автоматически перезаписывать файлы веб-сервера, — плохая идея. Поэтому, чтобы обработать такой запрос, потребуется сначала сообщить веб-серверу, чтобы запрос обрабатывал конкретный PHP-скрипт. На веб-сервере Apache это делается через директиву Script. diff --git a/features/sessions.xml b/features/sessions.xml index 138c6275a..475aa5e09 100644 --- a/features/sessions.xml +++ b/features/sessions.xml @@ -5,7 +5,7 @@ Сессии - Поддержка сессий в PHP состоит в сохранении набора данных для повторного обращения к ним. + Поддержка сессий в PHP состоит в сохранении набора данных для повторного обращения к ним. Это помогает повысить индивидуальность разрабатываемого приложения и улучшает привлекательность сайта. Подробнее об этом рассказывает раздел «Управление сессиями». diff --git a/install/pecl.xml b/install/pecl.xml index 519736872..9f69bf72e 100644 --- a/install/pecl.xml +++ b/install/pecl.xml @@ -139,7 +139,7 @@ $ svn checkout https://svn.php.net/repository/pecl/extname/trunk extname Такие модули называются входящими в комплект (“bundled”). - Однако, если входящие в комплект модули не дают нужной функциональности, + Однако, если входящие в комплект модули не дают нужной функциональности, нужный модуль всё ещё может быть найден на сайте &link.pecl;. Библиотека модулей сообщества PHP (The PHP Extension Community Library, PECL) — это @@ -148,8 +148,8 @@ $ svn checkout https://svn.php.net/repository/pecl/extname/trunk extname Разработанный для отдельных целей модуль можно загрузить - в библиотеку PECL, чтобы другие люди, которым он может быть нужен, могли извлечь из него пользу. - Неплохим побочным последствием этого будет хорошая вероятность получить отзывы, + в библиотеку PECL, чтобы другие люди, которым он может быть нужен, могли извлечь из него пользу. + Неплохим побочным последствием этого будет хорошая вероятность получить отзывы, благодарности (надеемся, что так и будет), сообщения об ошибках и даже исправления/патчи. Пожалуйста, прочтите публикацию PECL перед отправкой модуля в PECL. @@ -223,7 +223,7 @@ drive:\path\to\php\executable\php.exe -i Загрузка модуля - Самый распространённый способ загрузить PHP-модуль — + Самый распространённый способ загрузить PHP-модуль — включить модуль в конфигурационном файле &php.ini;. Обратите внимание, что файл &php.ini; уже содержит записи большей части модулей, и для их активации потребуется только удалить точку с запятой. @@ -282,7 +282,7 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini При работе с PHP из командной строки, в режиме CLI, ошибки загрузки - сообщение об ошибке загрузки модуля появится на экране. + сообщение об ошибке загрузки модуля появится на экране. Расположение и формат лог-файлов при работе PHP на веб-сервере @@ -296,7 +296,7 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini и из-за несовпадения настроек компиляции. - Если проблема возникает из-за несовпадения настроек компиляции, + Если проблема возникает из-за несовпадения настроек компиляции, то, возможно, скачали неправильный DLL-файл. Попробуйте скачать модуль снова с правильными настройками. И снова в таких ситуациях помогает информация, которую выводит функция phpinfo. diff --git a/install/unix/apache2.xml b/install/unix/apache2.xml index ed88c05f6..ccd5b1fbd 100644 --- a/install/unix/apache2.xml +++ b/install/unix/apache2.xml @@ -91,7 +91,7 @@ make install стандартный мультипроцессный MPM-модуль, который отвечает на запросы по модели prefork: обрабатывает запросы в отдельном потоке однопоточных процессов. Правильно ли прошла установка, проверяют через стандартную - процедуру запуска Apache — командой наподобие вот такой: + процедуру запуска Apache — командой наподобие вот такой: diff --git a/install/unix/nginx.xml b/install/unix/nginx.xml index c619cc4e3..61184946c 100644 --- a/install/unix/nginx.xml +++ b/install/unix/nginx.xml @@ -55,7 +55,7 @@ tar zxf php-x.x.x Настроить и собрать PHP. Здесь вы настраиваете PHP - с нужными параметрами. + с нужными параметрами. Запустите команду ./configure --help, чтобы получить список доступных опций. В примере будут сделаны простые настройки для включения менеджера процессов PHP-FPM с поддержкой модуля MySQLi. diff --git a/install/unix/source.xml b/install/unix/source.xml index 75f2b421e..7fcb7cc23 100644 --- a/install/unix/source.xml +++ b/install/unix/source.xml @@ -92,7 +92,7 @@ - Из-за вопросов безопасности отдельные Unix-системы наподобие OpenBSD и SELinux + Из-за вопросов безопасности отдельные Unix-системы наподобие OpenBSD и SELinux иногда запрещают отображение в памяти страниц, к которым открыт доступ и на запись, и на выполнение. Такая защита называется PaX MPROTECT или W^X-защита diff --git a/install/windows/commandline.xml b/install/windows/commandline.xml index 56c3ba7d0..fab0b2e81 100644 --- a/install/windows/commandline.xml +++ b/install/windows/commandline.xml @@ -41,7 +41,7 @@ C:\php\php.exe -f "C:\PHP Scripts\script.php" -- -arg1 -arg2 -arg3 Добавьте расположение исполняемого файла PHP — php.exe, php-win.exe или php-cli.exe, - в зависимости от версии PHP и предпочтений отображения — в переменную + в зависимости от версии PHP и предпочтений отображения — в переменную окружения PATH. Подробнее о добавлении каталога PHP в переменную окружения PATH рассказывает запись часто diff --git a/language/attributes.xml b/language/attributes.xml index 971654f2a..0efaa4f7e 100644 --- a/language/attributes.xml +++ b/language/attributes.xml @@ -288,7 +288,7 @@ dumpMyAttributeData(new ReflectionClass(Thing::class)); Хотя нет строго требования, лучше выполнять рекомендацию — - создавать отдельный класс для каждого атрибута. В самом простом случае + создавать отдельный класс для каждого атрибута. В самом простом случае создают пустой класс, для которого объявляют атрибут #[Attribute], который доступен для импорта из глобального пространства имён через оператор use. diff --git a/language/context/http.xml b/language/context/http.xml index fb4853bd1..282457234 100644 --- a/language/context/http.xml +++ b/language/context/http.xml @@ -30,7 +30,7 @@ или любой другой HTTP-метод, который поддерживает удалённый сервер. - По умолчанию — GET. + По умолчанию — GET. @@ -127,7 +127,7 @@ 0. - По умолчанию — 1. + По умолчанию — 1. @@ -158,7 +158,7 @@ Версия HTTP-протокола. - С PHP 8.0.0 значение по умолчанию — 1.1; + С PHP 8.0.0 значение по умолчанию — 1.1; до этой версии значение по умолчанию равнялось 1.0. @@ -192,7 +192,7 @@ статусах завершения. - По умолчанию — &false;. + По умолчанию — &false;. diff --git a/language/control-structures/foreach.xml b/language/control-structures/foreach.xml index 6a0c3d078..0ecfaf81f 100644 --- a/language/control-structures/foreach.xml +++ b/language/control-structures/foreach.xml @@ -10,7 +10,7 @@ перебора массивов. Конструкция foreach работает только с массивами и объектами, и будет выдавать ошибку при попытке использовать её с переменными других типов данных или неинициализированными переменными. - Разработчику доступны два вида синтаксиса: + Разработчику доступны два вида синтаксиса: - Что наихудшее случится, если пользоваться оператором goto? + Что наихудшее случится, если пользоваться оператором goto? diff --git a/language/control-structures/include.xml b/language/control-structures/include.xml index eb29e1888..1af4e3af6 100644 --- a/language/control-structures/include.xml +++ b/language/control-structures/include.xml @@ -127,7 +127,7 @@ echo "Одно $color $fruit"; // Одно зелёное Список протоколов, которые поддерживаются PHP, приводит страница «». Строка URL-запроса умеет передавать переменные во включаемый с удалённого сервера файл HTTP-методом GET, если целевой удалённый сервер интерпретирует целевой файл как PHP-код. Включение файла - с удалённого сервера отличается от включения файла с наследованием включаемым файлом + с удалённого сервера отличается от включения файла с наследованием включаемым файлом родительской области видимости включающего файла; скрипт выполняется на удалённом сервере, а результат затем включается в локальный скрипт. @@ -261,7 +261,7 @@ echo $bar; // выведет 1 Значение переменной $bar равно 1, поскольку инструкция успешно включила файл. Обратите внимание на разницу между приведёнными примерами. - В первом записали return внутри включаемого файла, тогда как во втором — нет. + В первом записали return внутри включаемого файла, тогда как во втором — нет. Выражение включения возвращает &false; и возникает ошибка уровня E_WARNING, если файл невозможно включить. diff --git a/language/expressions.xml b/language/expressions.xml index 40dc42124..9577460b4 100644 --- a/language/expressions.xml +++ b/language/expressions.xml @@ -4,15 +4,15 @@ Выражения - Выражения — самые важные строительные элементы PHP. Почти всё, что разработчик пишет + Выражения — самые важные строительные элементы PHP. Почти всё, что разработчик пишет в PHP, — выражение. Самое простое и точное определение - выражения — «всё, у чего есть значение». + выражения — «всё, у чего есть значение». Главные формы выражений — константы и переменные. В записи $a = 5 значение 5 присвоится переменной $a. У значения 5, очевидно, — значение 5 или, говоря по-другому, - 5 — выражение со значением 5 (в этом случае 5 — целочисленная + 5 — выражение со значением 5 (в этом случае 5 — целочисленная константа). @@ -25,7 +25,7 @@ Немного более сложные примеры выражений — функции. Например, - рассмотрим следующую функцию: + рассмотрим следующую функцию: Однако PHP использует выражения значительно шире, точно так же, как это делают другие языки. - PHP — язык с ориентацией на выражения, который почти всё в коде рассматривает как + PHP — язык с ориентацией на выражения, который почти всё в коде рассматривает как выражение. Вернёмся к тому примеру, с которым мы уже имели дело: $a = 5. Легко заметить, что здесь есть два значения — значение целочисленной константы 5 и значение переменной $a, также принимающей значение 5. Но, хотя это неочевидно, здесь есть ещё одно - значение — значение самого присвоения. Само присвоение вычисляется в - присвоенное значение, в данном случае — в 5. То есть + значение — значение самого присвоения. Само присвоение вычисляется в + присвоенное значение, в данном случае — в 5. То есть выражение $a = 5, независимо от того, что оно делает, — это выражение со значением 5. Поэтому запись $b = ($a = 5) равносильна записи $a = 5; $b = 5; (точка с запятой означает конец инструкции). @@ -77,12 +77,12 @@ function foo () разрешено написать $b = $a = 5. - Другой хороший пример ориентированности на выражения — префиксный и + Другой хороший пример ориентированности на выражения — префиксный и постфиксный инкремент и декремент. Пользователи PHP и других языков возможно уже знакомы с формой записи variable++ и variable--. Это операторы инкремента и декремента. Как и язык Си, язык PHP - поддерживает два типа инкремента — префиксный и постфиксный. Они + поддерживает два типа инкремента — префиксный и постфиксный. Они оба инкрементируют значение переменной и эффект их действия на неё одинаков. Разница состоит в значении выражения инкремента. Префиксный инкремент, записываемый как ++$variable, @@ -132,7 +132,7 @@ function foo () Ещё одно выражение, которое выглядит необычно, - если читатель не встречал такое выражение в других языках, — тернарный условный + если читатель не встречал такое выражение в других языках, — тернарный условный оператор: @@ -170,16 +170,16 @@ function double($i) $b = $a = 5; /* присвоить значение пять переменным $a и $b */ $c = $a++; /* постфиксный инкремент, присвоить значение переменной - $a (5) — переменной $c */ + $a (5) — переменной $c */ $e = $d = ++$b; /* префиксный инкремент, присвоить увеличенное значение переменной $b (6) — переменным $d и $e */ /* в этой точке и переменная $d, и переменная $e равны 6 */ $f = double($d++); /* присвоить удвоенное значение перменной $d перед - инкрементом (2 * 6 = 12) — переменной $f */ + инкрементом (2 * 6 = 12) — переменной $f */ $g = double(++$e); /* присвоить удвоенное значение перменной $e после - инкремента (2 * 7 = 14) — переменной $g */ + инкремента (2 * 7 = 14) — переменной $g */ $h = $g += 10; /* сначала переменная $g увеличивается на 10, приобретая, в итоге, значение 24. Затем значение присвоения (24) присваивается переменной $h, @@ -191,9 +191,9 @@ $h = $g += 10; /* сначала переменная $g увеличива Иногда PHP рассматривает выражения как инструкции. - В этом случае у инструкции следующий вид — «expr ;», то есть выражение, + В этом случае у инструкции следующий вид — «expr ;», то есть выражение, за которым следует точка с запятой. В записи $b = $a = 5;, - часть $a = 5 — допустимое выражение, но оно само — не инструкция. + часть $a = 5 — допустимое выражение, но оно само — не инструкция. Тогда как запись $b = $a = 5; — допустимая инструкция. diff --git a/language/generators.xml b/language/generators.xml index 6ccc5b81b..3658ca793 100644 --- a/language/generators.xml +++ b/language/generators.xml @@ -16,7 +16,7 @@ - Генератор поддерживает удобную передачу данных в циклы &foreach; + Генератор поддерживает удобную передачу данных в циклы &foreach; без предварительной загрузки массива в память, что иногда вызывает превышение программой предела памяти или значительно увеличивает время обработки, которое уходит на генерацию результата. Вместо этого пишут функцию-генератор, @@ -368,7 +368,7 @@ foreach (gen_reference() as &$number) { - Распространенный случай, когда это имеет значение, — функция iterator_to_array, + Распространенный случай, когда это имеет значение, — функция iterator_to_array, которая возвращает массив с ключом по умолчанию, что иногда приводит к неожиданным результатам. У функции iterator_to_array есть второй параметр preserve_keys, которому можно присвоить значение &false; diff --git a/language/oop5/decon.xml b/language/oop5/decon.xml index 79d3f13fb..d84deefb4 100644 --- a/language/oop5/decon.xml +++ b/language/oop5/decon.xml @@ -129,7 +129,7 @@ $p3 = new Point(y: 5, x: 4); У метода, название которого совпадает с именем класса, нет особого значения - в классах внутри пространства имён, а с PHP 8.0.0 — в любых классах. + в классах внутри пространства имён, а с PHP 8.0.0 — в любых классах. В новом коде определяют только метод __construct(). diff --git a/language/oop5/property-hooks.xml b/language/oop5/property-hooks.xml index c1664f1cd..47d10b189 100644 --- a/language/oop5/property-hooks.xml +++ b/language/oop5/property-hooks.xml @@ -522,7 +522,7 @@ class PositivePoint extends Point Хук родительского класса игнорируется, если только доступ к родительскому хуку не выполняется непосредственно. - Такое поведение соответствует работе методов. + Такое поведение соответствует работе методов. Синтаксис обращения к родительскому хуку также открывает доступ к хранилищу родительского класса, если родительский класс содержит такое хранилище. Чтение или запись поведут себя по умолчанию, если хук для родительского свойства не определили. diff --git a/language/oop5/serialization.xml b/language/oop5/serialization.xml index 33967ef27..61c3453b0 100644 --- a/language/oop5/serialization.xml +++ b/language/oop5/serialization.xml @@ -67,7 +67,7 @@ Если в приложении сериализуются объекты, которые будут использованы в приложении позже, - следуют строгой рекомендации — подключать определение класса + следуют строгой рекомендации — подключать определение класса для этого объекта во всём приложении. При невыполнении этого требования десериализация объекта пройдёт и без определения класса, но PHP назначит этому объекту класс __PHP_Incomplete_Class_Name, diff --git a/language/operators.xml b/language/operators.xml index 538e9d48d..d68a18b75 100644 --- a/language/operators.xml +++ b/language/operators.xml @@ -6,7 +6,7 @@ Оператором называется нечто, что принимает одно или более значений (или выражений, если говорить на жаргоне программирования), и вычисляет новое - значение (так, всю конструкцию можно рассматривать как выражение). + значение (так, всю конструкцию можно рассматривать как выражение). Операторы можно сгруппировать по количеству принимаемых ими значений. Унарные @@ -18,7 +18,7 @@ + (плюс) и - (минус), бо́льшая часть поддерживаемых в PHP операторов входит в эту категорию. И на последок, существует всего один тернарный оператор, - ? :, принимающий три значения, обычно о нём говорят просто — «тернарный + ? :, принимающий три значения, обычно о нём говорят просто — «тернарный оператор» (хотя, возможно, более точным названием было бы «условный оператор»). diff --git a/language/operators/comparison.xml b/language/operators/comparison.xml index 046640dbb..0b28a6091 100644 --- a/language/operators/comparison.xml +++ b/language/operators/comparison.xml @@ -335,7 +335,7 @@ var_dump(min(-100, -10, NULL, 10, 100)); // NULL — (bool) NULL < (bool) -100 - У оператора объединения с NULL низкий приоритет. То есть при смешивании его с другими операторами + У оператора объединения с NULL низкий приоритет. То есть при смешивании его с другими операторами (например, с операторами конкатенации строк или арифметическими операторами), скорее всего, потребуются круглые скобки. diff --git a/language/operators/type.xml b/language/operators/type.xml index 209daa232..96d1d0f66 100644 --- a/language/operators/type.xml +++ b/language/operators/type.xml @@ -125,7 +125,7 @@ bool(true) Хотя оператор instanceof обычно указывают с буквальным именем класса, - его можно также указывать с переменной объекта или строковой переменной: + его можно также указывать с переменной объекта или строковой переменной: Использование оператора <literal>instanceof</literal> с другими переменными diff --git a/language/predefined/arrayaccess.xml b/language/predefined/arrayaccess.xml index 72848466c..17e929fae 100644 --- a/language/predefined/arrayaccess.xml +++ b/language/predefined/arrayaccess.xml @@ -12,7 +12,7 @@
&reftitle.intro; - Интерфейс разрешает обращаться к объектам как к массивам. + Интерфейс разрешает обращаться к объектам как к массивам.
diff --git a/language/predefined/generator/send.xml b/language/predefined/generator/send.xml index 1a60846c2..cb6d1bd17 100644 --- a/language/predefined/generator/send.xml +++ b/language/predefined/generator/send.xml @@ -58,7 +58,7 @@ function printer() { - echo "Я — принтер!" . PHP_EOL; + echo "Я — принтер!" . PHP_EOL; while (true) { $string = yield; diff --git a/language/types/declarations.xml b/language/types/declarations.xml index a1eb1241b..2d8950aac 100644 --- a/language/types/declarations.xml +++ b/language/types/declarations.xml @@ -15,14 +15,14 @@ Каждый тип, который поддерживает PHP, за исключением ресурсов (resource), разрешено указывать при пользовательском объявлении типа. На этой странице приведён журнал изменений доступности отдельных типов - и документация о том, как их применять в объявлениях типов. + и документация о том, как их применять в объявлениях типов. Когда класс реализует метод интерфейса или переопределяет метод, который уже был определён родительским классом, - вновь определяемый метод должен быть совместим с определением, + вновь определяемый метод должен быть совместим с определением, которое было сделано ранее. Метод совместим, если он соблюдает правила вариантности. @@ -316,7 +316,7 @@ Stack trace: Ещё один способом добиться nullable-аргументов — указать null значением по умолчанию. - Такой способ не рекомендован, поскольку если значение по умолчанию + Такой способ не рекомендован, поскольку если значение по умолчанию изменится в дочернем классе, нарушится совместимость типов, поскольку в объявление типа потребуется добавить тип null. @@ -353,7 +353,7 @@ NULL Повторяющиеся и избыточные типы - Избыточные типы, которые можно обнаружить без выполнения загрузки класса, + Избыточные типы, которые можно обнаружить без выполнения загрузки класса, приведут к ошибке во время компиляции, чтобы отловить неточности в объявлениях составных типов. В них включены: @@ -367,7 +367,7 @@ NULL - Указание типа mixed (с другими типами) приведёт к ошибке. + Указание типа mixed (с другими типами) приведёт к ошибке. diff --git a/language/types/float.xml b/language/types/float.xml index 5a53df023..d5c154a7d 100644 --- a/language/types/float.xml +++ b/language/types/float.xml @@ -5,8 +5,8 @@ Числа с плавающей точкой - Числа с плавающей запятой в руководстве называются «числами с плавающей точкой», - поскольку в английском языке — языке оригинала PHP-руководства — целую и дробную часть в таких числах + Числа с плавающей запятой в руководстве называются «числами с плавающей точкой», + поскольку в английском языке — языке оригинала PHP-руководства — целую и дробную часть в таких числах разделяет точка, а не запятая. В других языках программирования числа с плавающей точкой называют также: float, double или real. В PHP числа с плавающей точкой записывают следующими синтаксисами: @@ -60,7 +60,7 @@ EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM}) Кроме того, рациональные числа наподобие 0.1 или 0.7, которые легко точно представить - как числа с плавающей точкой по основанию 10 — в десятичной системе счисления, + как числа с плавающей точкой по основанию 10 — в десятичной системе счисления, внутренне невозможно точно представить как числа с плавающей точкой по основанию 2 — в двоичной системе счисления, независимо от размера мантиссы. Поэтому такие числа невозможно преобразовать во внутреннюю двоичную форму без небольшой потери точности. Иногда это даёт противоречивые результаты: @@ -81,7 +81,7 @@ EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM}) «Простое» объяснение даёт руководство по числам с плавающей точкой, которое также называется - «Why don’t my numbers add up?» («Почему мои числа не складываются?» — англ.) + «Why don’t my numbers add up?» («Почему мои числа не складываются?» — англ.) diff --git a/language/types/integer.xml b/language/types/integer.xml index 9cb34fc48..1ace1ce80 100644 --- a/language/types/integer.xml +++ b/language/types/integer.xml @@ -36,7 +36,7 @@ - Для записи в восьмеричной системе счисления перед числом ставят ноль — 0. + Для записи в восьмеричной системе счисления перед числом ставят ноль — 0. Начиная с PHP 8.1.0 восьмеричную нотацию также дополнили символами 0o или 0O, которые записывают перед числом. Для записи в шестнадцатеричной системе счисления перед числом записывают 0x. diff --git a/language/types/null.xml b/language/types/null.xml index 96451547b..fc203373c 100644 --- a/language/types/null.xml +++ b/language/types/null.xml @@ -5,7 +5,7 @@ NULL - Тип null — единичный PHP-тип с единственным значением: &null;. + Тип null — единичный PHP-тип с единственным значением: &null;. @@ -16,7 +16,7 @@ Синтаксис - Типу null принадлежит только одно значение — регистронезависимая + Типу null принадлежит только одно значение — регистронезависимая константа &null;. diff --git a/language/types/resource.xml b/language/types/resource.xml index 35cb1e974..962b1f543 100644 --- a/language/types/resource.xml +++ b/language/types/resource.xml @@ -7,7 +7,7 @@ Resource — переменная, которая хранит ссылку на внешний ресурс. Ресурсы создают и передают в отдельный набор функций для работы с ресурсами. - Список этих функций и типы ресурсов (resource), которые соответствуют функциям, + Список этих функций и типы ресурсов (resource), которые соответствуют функциям, перечисляет приложение. diff --git a/language/types/string.xml b/language/types/string.xml index 858ffb347..8b175d719 100644 --- a/language/types/string.xml +++ b/language/types/string.xml @@ -111,7 +111,7 @@ echo 'Переменные $expand и $either также не разворачи PHP распознает следующие управляющие последовательности служебных символов, - если строку заключили в двойные кавычки — ": + если строку заключили в двойные кавычки — ": @@ -1329,7 +1329,7 @@ bool(false) Строковый тип (string) в PHP реализовали в виде массива байтов и целочисленного значения, которое содержит длину буфера. В этой структуре - нет информации о том, как преобразовывать байты в символы, + нет информации о том, как преобразовывать байты в символы, эту задачу решает программист. Нет ограничений на значения, из которых состоит строка, например, байт со значением 0 (NUL-байт) разрешается где угодно в строке (однако рекомендуют учитывать, что ряд функций, @@ -1371,7 +1371,7 @@ bool(false) - Одни — предполагают, что строка закодирована в какой-то + Одни — предполагают, что строка закодирована в какой-то однобайтовой кодировке, но для корректной работы им не нужно интерпретировать байты как конкретные символы. Сюда попадают функции вроде substr, @@ -1383,7 +1383,7 @@ bool(false) - Другим — передаётся кодировка строки или они принимают + Другим — передаётся кодировка строки или они принимают значение по умолчанию, если кодировку не передали. Это относится к функции htmlentities и большей части функций модуля mbstring. @@ -1391,7 +1391,7 @@ bool(false) - Третьи — работают с текущими настройками локали (смотрите + Третьи — работают с текущими настройками локали (смотрите setlocale), но оперируют побайтово. diff --git a/language/types/type-system.xml b/language/types/type-system.xml index b7da1d1f7..87a7e9242 100644 --- a/language/types/type-system.xml +++ b/language/types/type-system.xml @@ -180,7 +180,7 @@ Поэтому объединение типов T, U и V, будет записано как T|U|V. Если при объединении типов добавляют пересечение типов, - то пересечение типов берут в скобки для записи + то пересечение типов берут в скобки для записи в дизъюнктивной нормальной форме (DNF): T|(X&Y). diff --git a/language/types/void.xml b/language/types/void.xml index 20004472a..e336d825d 100644 --- a/language/types/void.xml +++ b/language/types/void.xml @@ -16,7 +16,7 @@ - Даже если объявить, что функция возвращает тип void, + Даже если объявить, что функция возвращает тип void, она всё равно вернёт значение &null;. diff --git a/reference/apcu/book.xml b/reference/apcu/book.xml index ff8a587bc..bfedbacc0 100644 --- a/reference/apcu/book.xml +++ b/reference/apcu/book.xml @@ -9,7 +9,7 @@ &reftitle.intro; - Модуль APCu — хранилище «ключ — значение» для PHP. Ключи и значения хранятся в памяти. + Модуль APCu — хранилище «ключ — значение» для PHP. Ключи и значения хранятся в памяти. Ключи хранятся как строки (&string;), а значения как произвольные PHP-переменные. Модуль APCu поддерживает кеширование переменных только в пространстве пользователя. diff --git a/reference/array/book.xml b/reference/array/book.xml index c7b6df688..3b40b83de 100644 --- a/reference/array/book.xml +++ b/reference/array/book.xml @@ -9,8 +9,8 @@ &reftitle.intro; - Эти функции помогают взаимодействовать с массивами и манипулировать - массивами набором способов. Массивы идеально подходят для хранения, + Эти функции помогают взаимодействовать с массивами и манипулировать + массивами набором способов. Массивы идеально подходят для хранения, изменения и работы с наборами переменных. diff --git a/reference/array/functions/array-diff-uassoc.xml b/reference/array/functions/array-diff-uassoc.xml index bc232c8fc..7f132f85f 100644 --- a/reference/array/functions/array-diff-uassoc.xml +++ b/reference/array/functions/array-diff-uassoc.xml @@ -5,7 +5,7 @@ array_diff_uassoc Вычисляет расхождение массивов с дополнительной проверкой индекса - через пользовательскую callback-функцию + через пользовательскую callback-функцию diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml index f13a3627b..72fabf438 100644 --- a/reference/array/functions/array-filter.xml +++ b/reference/array/functions/array-filter.xml @@ -74,7 +74,7 @@ ARRAY_FILTER_USE_BOTH — вместо значения массива как единственного аргумента - callback-функции передавать и значение — первым аргументом, + callback-функции передавать и значение — первым аргументом, и ключ массива — вторым аргументом. diff --git a/reference/array/functions/array-intersect-ukey.xml b/reference/array/functions/array-intersect-ukey.xml index 1fb93a376..e0b34e5d4 100644 --- a/reference/array/functions/array-intersect-ukey.xml +++ b/reference/array/functions/array-intersect-ukey.xml @@ -57,7 +57,7 @@ Возвращает ассоциативный массив, состоящий из значений массива array, - ключи которых содержатся во всех аргументах. + ключи которых содержатся во всех аргументах. diff --git a/reference/array/functions/array-multisort.xml b/reference/array/functions/array-multisort.xml index da1501ab2..17ae6e3f4 100644 --- a/reference/array/functions/array-multisort.xml +++ b/reference/array/functions/array-multisort.xml @@ -50,7 +50,7 @@ Этот аргумент разрешено менять местами с аргументом array1_sort_flags - или не указывать, тогда функция возьмёт за основу значение SORT_ASC. + или не указывать, тогда функция возьмёт за основу значение SORT_ASC. @@ -306,8 +306,8 @@ volume | edition Сортировка без учёта регистра - Обе константы — SORT_STRING - и SORT_REGULAR — учитывают регистр при + Обе константы — SORT_STRING + и SORT_REGULAR — учитывают регистр при сортировке, поэтому строки, которые начинаются с заглавной буквы, будут идти раньше строк, которые начинаются со строчной буквы. diff --git a/reference/array/functions/array.xml b/reference/array/functions/array.xml index 79451c6be..6bd2ddac5 100644 --- a/reference/array/functions/array.xml +++ b/reference/array/functions/array.xml @@ -15,7 +15,7 @@ Конструкция создаёт массив. Подробнее о массивах рассказывает раздел «Массивы», включая сведения - об альтернативном синтаксисе с квадратными скобками — []. + об альтернативном синтаксисе с квадратными скобками — []. @@ -78,7 +78,7 @@ $fruits = array ( - Пример автоматической индексация при вызове конструкции <function>array</function> + Пример автоматической индексация при вызове конструкции <function>array</function> current на пустом массиве, массиве со сдвинутым за пределы элементов внутренним указателем и массиве с указателем на элементе с логическим (bool) - значением &false; — неотличимы. Чтобы правильно обойти массив + значением &false; — неотличимы. Чтобы правильно обойти массив с элементами &false;, пользуются управляющей конструкцией &foreach;. diff --git a/reference/classobj/functions/get-mangled-object-vars.xml b/reference/classobj/functions/get-mangled-object-vars.xml index 7771923c5..52fcac041 100644 --- a/reference/classobj/functions/get-mangled-object-vars.xml +++ b/reference/classobj/functions/get-mangled-object-vars.xml @@ -14,7 +14,7 @@ objectobject - Функция возвращает массив (&array;), элементы которого — свойства объекта. + Функция возвращает массив (&array;), элементы которого — свойства объекта. Ключами массива будут имена переменных-членов, с рядом примечательных исключений: в начало имён закрытых переменных добавляется имя класса; в начало имён защищённых переменных — символ *. diff --git a/reference/classobj/functions/is-subclass-of.xml b/reference/classobj/functions/is-subclass-of.xml index 5bc1cfadc..5e736e76f 100644 --- a/reference/classobj/functions/is-subclass-of.xml +++ b/reference/classobj/functions/is-subclass-of.xml @@ -4,7 +4,7 @@ is_subclass_of - Проверяет, принадлежит ли объект к потомкам класса, или реализует ли объект или родители объекта интерфейс + Проверяет, принадлежит ли объект к потомкам класса, или реализует ли объект или родители объекта интерфейс &reftitle.description; diff --git a/reference/com/functions/variant-idiv.xml b/reference/com/functions/variant-idiv.xml index 5654bd7ff..d478180f7 100644 --- a/reference/com/functions/variant-idiv.xml +++ b/reference/com/functions/variant-idiv.xml @@ -15,7 +15,7 @@ Преобразовывает операнды left и right - в целочисленные значения и выполняет целочисленное деление. + в целочисленные значения и выполняет целочисленное деление. diff --git a/reference/cubrid/functions/cubrid-close-request.xml b/reference/cubrid/functions/cubrid-close-request.xml index eb6c06cda..b64eec19f 100644 --- a/reference/cubrid/functions/cubrid-close-request.xml +++ b/reference/cubrid/functions/cubrid-close-request.xml @@ -16,7 +16,7 @@ Функция cubrid_close_request закрывает обработчик запроса, который задали в параметре req_identifier, и высвобождает выделенную ему память. - Эта функция — псевдоним функции cubrid_close_prepare. + Эта функция — псевдоним функции cubrid_close_prepare. diff --git a/reference/curl/constants_curl_multi_setopt.xml b/reference/curl/constants_curl_multi_setopt.xml index 2611ecd31..ff2e7ecf7 100644 --- a/reference/curl/constants_curl_multi_setopt.xml +++ b/reference/curl/constants_curl_multi_setopt.xml @@ -110,7 +110,7 @@ насколько это окажется возможным для передач через этот дескриптор. Это означает, что добавление второго запроса, который может использовать уже существующее соединение, «конвейеризует» второй запрос через то же соединение. - Начиная с cURL 7.43.0 это значение — битовая маска, + Начиная с cURL 7.43.0 это значение — битовая маска, и при передаче значения 2 модуль попытается мультиплексировать новую передачу через существующие HTTP/2-соединение. Значение 3 инструктирует модуль cURL запрашивать конвейерную обработку и мультиплексирование diff --git a/reference/datetime/dateinvalidoperationexception.xml b/reference/datetime/dateinvalidoperationexception.xml index 1e2e3f03a..99ff37898 100644 --- a/reference/datetime/dateinvalidoperationexception.xml +++ b/reference/datetime/dateinvalidoperationexception.xml @@ -18,7 +18,7 @@ Пример такой неподдерживаемой операции — это попытка отнять хранящийся в объекте DateInterval временной интервал - вроде next weekday («следующий будний день» — англ.), представляющий относительную характеристику времени, + вроде next weekday («следующий будний день» — англ.), представляющий относительную характеристику времени, поскольку невозможно построить обратное логическое утверждение. diff --git a/reference/datetime/datetimeinterface/diff.xml b/reference/datetime/datetimeinterface/diff.xml index 4118c8a59..5e0543a9a 100644 --- a/reference/datetime/datetimeinterface/diff.xml +++ b/reference/datetime/datetimeinterface/diff.xml @@ -74,7 +74,7 @@ объекта DateInterval. - Конкретнее — метод возвращает значение, которое представляет интервал времени, + Конкретнее — метод возвращает значение, которое представляет интервал времени, который требуется применить к исходному объекту $this или $originObject, чтобы получить целевой объект $targetObject. Процесс обратим не всегда. diff --git a/reference/datetime/datetimeinterface/gettimestamp.xml b/reference/datetime/datetimeinterface/gettimestamp.xml index e6581ef57..9a3ae8e69 100644 --- a/reference/datetime/datetimeinterface/gettimestamp.xml +++ b/reference/datetime/datetimeinterface/gettimestamp.xml @@ -51,7 +51,7 @@ &reftitle.errors; Метод выбросит исключение DateRangeError, - если не получится представить метку времени целым числом (&integer;). + если не получится представить метку времени целым числом (&integer;). До PHP 8.3.0 выбрасывалось исключение ValueError. А до PHP 8.0.0 возвращалось логическое значение &false;. При этом метку времени в виде строки (&string;) получают diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml index 1a7f122bb..179457930 100644 --- a/reference/datetime/functions/strptime.xml +++ b/reference/datetime/functions/strptime.xml @@ -219,7 +219,7 @@ Array - Элемент "tm_sec" включает високосные секунды — до двух в год. + Элемент "tm_sec" включает високосные секунды — до двух в год. Подробнее о високосных секунды рассказывает статья о високосной секунде на сайте Википедии. diff --git a/reference/datetime/functions/strtotime.xml b/reference/datetime/functions/strtotime.xml index 26ed52a79..2ecb1c34c 100644 --- a/reference/datetime/functions/strtotime.xml +++ b/reference/datetime/functions/strtotime.xml @@ -31,7 +31,7 @@ Каждый параметр функции будет использовать часовой пояс по умолчанию, - если он не указан в нём. Соблюдают осторожность и не указывают разные + если он не указан в нём. Соблюдают осторожность и не указывают разные метки времени в параметрах, если только так не было задумано. О способах установки часового пояса по умолчанию рассказано в описании функции date_default_timezone_get. @@ -52,7 +52,7 @@ baseTimestamp - Метка времени, которую функция будет использовать как основу для вычисления + Метка времени, которую функция будет использовать как основу для вычисления относительных дат. @@ -167,7 +167,7 @@ if (($timestamp = strtotime($str)) === false) { Корректный диапазон меток времени — это обычно даты с 13 декабря 1901 20:45:54 UTC по 19 января 2038 03:14:07 UTC. (Эти даты - соответствуют крайним значениям 32-битного целого числа со знаком.) + соответствуют крайним значениям 32-битного целого числа со знаком.) В 64-битных версиях PHP корректный диапазон меток времени практически бесконечен, @@ -178,7 +178,7 @@ if (($timestamp = strtotime($str)) === false) { Использовать эту функцию для математических операций не рекомендовано. - Лучше пользоваться методами DateTime::add + Лучше пользоваться методами DateTime::add и DateTime::sub. diff --git a/reference/dba/examples.xml b/reference/dba/examples.xml index e7b4a6f15..d76d5c9ce 100644 --- a/reference/dba/examples.xml +++ b/reference/dba/examples.xml @@ -36,7 +36,7 @@ dba_close($id); DBA является бинарно безопасным и не имеет каких-либо произвольных ограничений. Тем не менее, он наследует все ограничения, установленные базовой -   реализацией базы данных + реализацией базы данных Все файловые базы данных должны обеспечивать способ задания файлового режима diff --git a/reference/dom/domdocument.xml b/reference/dom/domdocument.xml index dbd49c401..fb64a820c 100644 --- a/reference/dom/domdocument.xml +++ b/reference/dom/domdocument.xml @@ -340,7 +340,7 @@ - Включение подмены сущностей способствует атакам XML External Entity (XXE). + Включение подмены сущностей способствует атакам XML External Entity (XXE). diff --git a/reference/dom/domdocument/createelement.xml b/reference/dom/domdocument/createelement.xml index bb14202d9..b0ca90ba5 100644 --- a/reference/dom/domdocument/createelement.xml +++ b/reference/dom/domdocument/createelement.xml @@ -35,7 +35,7 @@ Значение элемента. По умолчанию будет создан пустой элемент. - Значение также может быть установлено позднее путём присваивания при прямом обращении к свойству + Значение также может быть установлено позднее путём присваивания при прямом обращении к свойству DOMElement::$nodeValue. diff --git a/reference/dom/domdocument/normalizedocument.xml b/reference/dom/domdocument/normalizedocument.xml index 059affe0f..85a8a8bbb 100644 --- a/reference/dom/domdocument/normalizedocument.xml +++ b/reference/dom/domdocument/normalizedocument.xml @@ -15,7 +15,7 @@ Этот метод работает так, как если бы документ сохранили, а затем - загрузили, — приводит документ к «нормальной» форме. + загрузили, — приводит документ к «нормальной» форме. diff --git a/reference/dom/domdocumenttype.xml b/reference/dom/domdocumenttype.xml index 9bcec1b23..66441ac44 100644 --- a/reference/dom/domdocumenttype.xml +++ b/reference/dom/domdocumenttype.xml @@ -12,7 +12,7 @@ &reftitle.intro; У каждого объекта DOMDocument есть атрибут - doctype, значение которого — либо &null;, либо объект + doctype, значение которого — либо &null;, либо объект класса DOMDocumentType. diff --git a/reference/ds/ds.queue.xml b/reference/ds/ds.queue.xml index 42b131277..f8a8d13ac 100644 --- a/reference/ds/ds.queue.xml +++ b/reference/ds/ds.queue.xml @@ -12,7 +12,7 @@
&reftitle.intro; - Очередь — коллекция по принципу «Первым пришёл — первым ушёл» (First In, First Out), или FIFO, + Очередь — коллекция по принципу «Первым пришёл — первым ушёл» (First In, First Out), или FIFO, которая разрешает доступ только к значению в начале очереди и выполняет итерации от начала к концу с удалением взятого элемента. diff --git a/reference/eio/constants.xml b/reference/eio/constants.xml index 7c3ef4288..0b81d9b1d 100644 --- a/reference/eio/constants.xml +++ b/reference/eio/constants.xml @@ -167,7 +167,7 @@ - Тип узла — FIFO. + Тип узла — FIFO. diff --git a/reference/errorfunc/functions/debug-backtrace.xml b/reference/errorfunc/functions/debug-backtrace.xml index ab7588e51..775255259 100644 --- a/reference/errorfunc/functions/debug-backtrace.xml +++ b/reference/errorfunc/functions/debug-backtrace.xml @@ -105,7 +105,7 @@ Этим параметром можно ограничить количество возвращаемых вызовов функций. По умолчанию - параметр (limit=0) — будет выведен весь + параметр (limit=0) — будет выведен весь стек вызовов. diff --git a/reference/event/examples.xml b/reference/event/examples.xml index caf47c7b5..7edd82e2a 100644 --- a/reference/event/examples.xml +++ b/reference/event/examples.xml @@ -602,9 +602,9 @@ echo "Используется событийный метод: ", $base->getMet echo "Способы:\n"; $features = $base->getFeatures(); -($features & EventConfig::FEATURE_ET) and print "ET — одноразовое срабатывание при пересечении порога (edge-triggered IO)\n"; -($features & EventConfig::FEATURE_O1) and print "O1 — операции добавления/удаления событий со сложностью O(1)\n"; -($features & EventConfig::FEATURE_FDS) and print "FDS — обычные дескрипторы файлов, а не только сокеты\n"; +($features & EventConfig::FEATURE_ET) and print "ET — одноразовое срабатывание при пересечении порога (edge-triggered IO)\n"; +($features & EventConfig::FEATURE_O1) and print "O1 — операции добавления/удаления событий со сложностью O(1)\n"; +($features & EventConfig::FEATURE_FDS) and print "FDS — обычные дескрипторы файлов, а не только сокеты\n"; // Запрашиваем способ FDS if ($cfg->requireFeatures(EventConfig::FEATURE_FDS)) { @@ -612,7 +612,7 @@ if ($cfg->requireFeatures(EventConfig::FEATURE_FDS)) { $base = new EventBase($cfg); ($base->getFeatures() & EventConfig::FEATURE_FDS) - and print "FDS — обычные дескрипторы файлов, а не только сокеты\n"; + and print "FDS — обычные дескрипторы файлов, а не только сокеты\n"; } /* }}} */ diff --git a/reference/exif/book.xml b/reference/exif/book.xml index 8978a448e..c2063dfb6 100644 --- a/reference/exif/book.xml +++ b/reference/exif/book.xml @@ -13,7 +13,7 @@ С модулем EXIF работают с метаданными изображений. Например, EXIF-функции вызывают, чтобы прочитать метаданные - изображений с цифровых камер — работают с информацией, которую + изображений с цифровых камер — работают с информацией, которую хранят заголовки. Обычно заголовки встречаются в изображениях форматов JPEG и TIFF. diff --git a/reference/fdf/functions/fdf-get-version.xml b/reference/fdf/functions/fdf-get-version.xml index 575f3f9b5..da0570064 100644 --- a/reference/fdf/functions/fdf-get-version.xml +++ b/reference/fdf/functions/fdf-get-version.xml @@ -42,7 +42,7 @@ Метод возвращает версию в виде строки. Для текущего набора инструментов FDF toolkit 5.0 номер версии API-интерфейса равен 5.0, а номер версии - документа — 1.2, 1.3 + документа — 1.2, 1.3 или 1.4. diff --git a/reference/filesystem/functions/umask.xml b/reference/filesystem/functions/umask.xml index ed1de11bc..693a2a9a0 100644 --- a/reference/filesystem/functions/umask.xml +++ b/reference/filesystem/functions/umask.xml @@ -15,7 +15,7 @@ Функция umask устанавливает применяемую PHP - по умолчанию umask в значение параметра mask & 0777 и возвращает + по умолчанию umask в значение параметра mask & 0777 и возвращает старую umask. Если PHP работает как серверный модуль, umask будет восстанавливаться после окончания каждого запроса. diff --git a/reference/fpm/status.xml b/reference/fpm/status.xml index 17311e005..b87bbfd87 100644 --- a/reference/fpm/status.xml +++ b/reference/fpm/status.xml @@ -255,7 +255,7 @@ какой процент от общего времени работы процессора занял последний запрос, — в расчёте менеджер учтёт процессы на каждом ядре, - тогда как 100 % — это значение только для одного ядра. + тогда как 100 % — это значение только для одного ядра. diff --git a/reference/gettext/functions/gettext.xml b/reference/gettext/functions/gettext.xml index e7f119024..944b9a54d 100644 --- a/reference/gettext/functions/gettext.xml +++ b/reference/gettext/functions/gettext.xml @@ -66,7 +66,7 @@ textdomain("myPHPApp"); // Выводим тестовое сообщение echo gettext("Welcome to My PHP Application"); -// Или вызываем псевдоним функции gettext() — функцию _() +// Или вызываем псевдоним функции gettext() — функцию _() echo _("Have a nice day"); ?> diff --git a/reference/gmp/functions/gmp-random-range.xml b/reference/gmp/functions/gmp-random-range.xml index dea339192..7e4e7b4c3 100644 --- a/reference/gmp/functions/gmp-random-range.xml +++ b/reference/gmp/functions/gmp-random-range.xml @@ -33,7 +33,7 @@ min - GMP-число — нижня граница случайного числа. + GMP-число — нижня граница случайного числа. @@ -41,7 +41,7 @@ max - GMP-число — верхняя граница случайного числа. + GMP-число — верхняя граница случайного числа. diff --git a/reference/ibase/functions/ibase-backup.xml b/reference/ibase/functions/ibase-backup.xml index 9c5f6e377..d56a46e02 100644 --- a/reference/ibase/functions/ibase-backup.xml +++ b/reference/ibase/functions/ibase-backup.xml @@ -58,7 +58,7 @@ Дополнительные опции для передачи на сервер базы данных для резервного копирования. Параметр options может быть комбинацией -        из следующих констант: + из следующих констант: IBASE_BKP_IGNORE_CHECKSUMS, IBASE_BKP_IGNORE_LIMBO, IBASE_BKP_METADATA_ONLY, @@ -90,7 +90,7 @@ Поскольку процесс резервного копирования выполняется на (удалённом) сервере, эта функция просто передаёт ему аргументы. -    Пока аргументы корректны, вы не получите &false;. + Пока аргументы корректны, вы не получите &false;. diff --git a/reference/ibm_db2/functions/db2-pconnect.xml b/reference/ibm_db2/functions/db2-pconnect.xml index f7f3adc76..6d0a211b6 100644 --- a/reference/ibm_db2/functions/db2-pconnect.xml +++ b/reference/ibm_db2/functions/db2-pconnect.xml @@ -359,20 +359,20 @@ db2set DB2COMM=TCPIP i5_date_sep - DB2_I5_SEP_SLASH — Разделитель даты — слеш (/). + DB2_I5_SEP_SLASH — Разделитель даты — слеш (/). Это значение по умолчанию. - DB2_I5_SEP_DASH — Разделитель даты — дефис (-). + DB2_I5_SEP_DASH — Разделитель даты — дефис (-). - DB2_I5_SEP_PERIOD — Разделитель даты — точка (.). + DB2_I5_SEP_PERIOD — Разделитель даты — точка (.). - DB2_I5_SEP_COMMA — Разделитель даты — запятая (,). + DB2_I5_SEP_COMMA — Разделитель даты — запятая (,). - DB2_I5_SEP_BLANK — Разделитель даты — пробел. + DB2_I5_SEP_BLANK — Разделитель даты — пробел. DB2_I5_SEP_JOB — Задание по умолчанию. @@ -410,13 +410,13 @@ db2set DB2COMM=TCPIP Это значение по умолчанию. - DB2_I5_SEP_PERIOD — Разделитель времени — точка (.). + DB2_I5_SEP_PERIOD — Разделитель времени — точка (.). - DB2_I5_SEP_COMMA — Разделитель времени — запятая (,). + DB2_I5_SEP_COMMA — Разделитель времени — запятая (,). - DB2_I5_SEP_BLANK — Разделитель времени — пробел. + DB2_I5_SEP_BLANK — Разделитель времени — пробел. DB2_I5_SEP_JOB — Задание по умолчанию. diff --git a/reference/iconv/book.xml b/reference/iconv/book.xml index c23907ede..1c0c05bc1 100644 --- a/reference/iconv/book.xml +++ b/reference/iconv/book.xml @@ -13,10 +13,10 @@ функцией iconv. С этим модулем можно изменять кодировку строки на другую, которая может быть набором символов Юникод. Набор поддерживаемых кодировок зависит от реализации iconv в системе. - Заметьте, бывают системы, в которых функция iconv работает не так, как ожидалось. + Заметьте, бывают системы, в которых функция iconv работает не так, как ожидалось. Тогда хорошей идеей будет — установить библиотеку GNU libiconv. - Скорее всего, это приведёт к более непротиворечивым результатам. + Скорее всего, это приведёт к более непротиворечивым результатам. diff --git a/reference/imagick/imagick/affinetransformimage.xml b/reference/imagick/imagick/affinetransformimage.xml index ccb6460bc..7f2be4f54 100644 --- a/reference/imagick/imagick/affinetransformimage.xml +++ b/reference/imagick/imagick/affinetransformimage.xml @@ -14,7 +14,7 @@ ImagickDrawmatrix - Преобразовывает изображения как продиктовано аффинной матрицей. + Преобразовывает изображения как продиктовано аффинной матрицей. diff --git a/reference/info/constants.xml b/reference/info/constants.xml index 4053b1cb0..f9d2e4ccd 100644 --- a/reference/info/constants.xml +++ b/reference/info/constants.xml @@ -444,7 +444,7 @@ Содержит значение для определения констант семейства PHP_WINDOWS_NT_*. - Значение — константа семейства + Значение — константа семейства PHP_WINDOWS_NT_*, которая указывает тип платформы. diff --git a/reference/info/functions/get-loaded-extensions.xml b/reference/info/functions/get-loaded-extensions.xml index d20c2aedc..965ce8ff6 100644 --- a/reference/info/functions/get-loaded-extensions.xml +++ b/reference/info/functions/get-loaded-extensions.xml @@ -30,7 +30,7 @@ Возвращать только модули Zend или обычные модули наподобие mysqli. - По умолчанию — &false; (возврат обычных модулей). + По умолчанию — &false; (возврат обычных модулей). diff --git a/reference/info/functions/memory-get-usage.xml b/reference/info/functions/memory-get-usage.xml index 79055ffdd..ed363723b 100644 --- a/reference/info/functions/memory-get-usage.xml +++ b/reference/info/functions/memory-get-usage.xml @@ -26,7 +26,7 @@ real_usage - При передаче в параметр значения &true; функция возвращает общий объём + При передаче в параметр значения &true; функция возвращает общий объём памяти, которую система выделила PHP-процессу, включая свободные страницы памяти. При вызове функции без аргументов или при передаче в аргументе значения &false; функция сообщит только о количестве памяти, которую заинимает PHP-скрипт. diff --git a/reference/intl/constants.xml b/reference/intl/constants.xml index 8a510a996..5c0fdfc3e 100644 --- a/reference/intl/constants.xml +++ b/reference/intl/constants.xml @@ -185,7 +185,7 @@ - Следующие ошибки — часть битовой маски, которую возвращает + Следующие ошибки — часть битовой маски, которую возвращает алгоритм UTS #46 в функциях idn_to_utf8 и idn_to_ascii. diff --git a/reference/intl/intlcalendar.xml b/reference/intl/intlcalendar.xml index ad3515d69..71c7efb9f 100644 --- a/reference/intl/intlcalendar.xml +++ b/reference/intl/intlcalendar.xml @@ -726,7 +726,7 @@ Вывод метода IntlCalendar::getDayOfWeekType - означает, что день — будний. + означает, что день — будний. diff --git a/reference/intl/intlchar/chardigitvalue.xml b/reference/intl/intlchar/chardigitvalue.xml index b048a9824..5dcc502a7 100644 --- a/reference/intl/intlchar/chardigitvalue.xml +++ b/reference/intl/intlchar/chardigitvalue.xml @@ -14,7 +14,7 @@ intstringcodepoint - Метод возвращает значение десятичной цифры — символа, которым записывают числа + Метод возвращает значение десятичной цифры — символа, которым записывают числа в десятичной системе счисления. diff --git a/reference/intl/intlchar/getpropertyenum.xml b/reference/intl/intlchar/getpropertyenum.xml index 681f9aafc..ddef2985e 100644 --- a/reference/intl/intlchar/getpropertyenum.xml +++ b/reference/intl/intlchar/getpropertyenum.xml @@ -15,7 +15,7 @@ Метод возвращает постоянное значение свойства по названию свойства, как определяет - файл базы данных Юникода — PropertyAliases.txt. Метод распознаёт короткие, длинные и другие варианты имён. + файл базы данных Юникода — PropertyAliases.txt. Метод распознаёт короткие, длинные и другие варианты имён. Кроме того, метод сопоставляет свойство IntlChar::PROPERTY_GENERAL_CATEGORY_MASK diff --git a/reference/intl/intlchar/getpropertyvalueenum.xml b/reference/intl/intlchar/getpropertyvalueenum.xml index f96025e45..42f69faf1 100644 --- a/reference/intl/intlchar/getpropertyvalueenum.xml +++ b/reference/intl/intlchar/getpropertyvalueenum.xml @@ -28,17 +28,17 @@ категории, а также сокращённое описание): - "C" / "Other" — прочие символы (управлящие, форматирования, суррогаты, частные и зарезервированные неназначенные + "C" / "Other" — прочие символы (управлящие, форматирования, суррогаты, частные и зарезервированные неназначенные кодовые точки и несимвольные коды) - "L" / "Letter" — буквы + "L" / "Letter" — буквы - "LC" / "Cased_Letter" — категория регистровых букв, которая объединяет категории: + "LC" / "Cased_Letter" — категория регистровых букв, которая объединяет категории: заглавных букв — Lu, строчных букв — Ll и категорию букв титульного регистра — Lt, в которую входят диграфы — символы, которые состоят из двух букв, которые закодировали как один символ, первый из которых — заглавный, например U+01F2 LATIN CAPITAL LETTER D WITH SMALL LETTER Z - "M" / "Mark" — метки + "M" / "Mark" — метки "N" / "Number" — числа "P" / "Punctuation" — символы пунктуации "S" / "Symbol" — символы (математические, валют, диакритические и прочие) diff --git a/reference/intl/intlchar/getpropertyvaluename.xml b/reference/intl/intlchar/getpropertyvaluename.xml index ca398d171..baa5081f7 100644 --- a/reference/intl/intlchar/getpropertyvaluename.xml +++ b/reference/intl/intlchar/getpropertyvaluename.xml @@ -28,17 +28,17 @@ категории, а также сокращённое описание): - "C" / "Other" — прочие символы (управлящие, форматирования, суррогаты, частные и зарезервированные неназначенные + "C" / "Other" — прочие символы (управлящие, форматирования, суррогаты, частные и зарезервированные неназначенные кодовые точки и несимвольные коды) - "L" / "Letter" — буквы + "L" / "Letter" — буквы - "LC" / "Cased_Letter" — категория регистровых букв, которая объединяет категории: + "LC" / "Cased_Letter" — категория регистровых букв, которая объединяет категории: заглавных букв — Lu, строчных букв — Ll и категорию букв титульного регистра — Lt, в которую входят диграфы — символы, которые состоят из двух букв, которые закодировали как один символ, первый из которых — заглавный, например U+01F2 LATIN CAPITAL LETTER D WITH SMALL LETTER Z - "M" / "Mark" — метки + "M" / "Mark" — метки "N" / "Number" — числа "P" / "Punctuation" — символы пунктуации "S" / "Symbol" — символы (математические, валют, диакритические и прочие) diff --git a/reference/intl/intlchar/isalnum.xml b/reference/intl/intlchar/isalnum.xml index 1420d2f0f..a879db529 100644 --- a/reference/intl/intlchar/isalnum.xml +++ b/reference/intl/intlchar/isalnum.xml @@ -15,7 +15,7 @@ Метод определяет, относится ли кодовая точка к буквам или цифрам. Метод возвращает &true; - для символов общей категорий букв — L и десятичных цифр — Nd. + для символов общей категорий букв — L и десятичных цифр — Nd. diff --git a/reference/intl/intlchar/isalpha.xml b/reference/intl/intlchar/isalpha.xml index 1bff9eb95..420355746 100644 --- a/reference/intl/intlchar/isalpha.xml +++ b/reference/intl/intlchar/isalpha.xml @@ -15,7 +15,7 @@ Метод определяет, относится ли кодовая точка к символам букв. Метод возвращает &true; - для символов общей категории букв — L, которая объединяет категории букв в верхнем — Lu, Ll, Lt, Lm и Lo. + для символов общей категории букв — L, которая объединяет категории букв в верхнем — Lu, Ll, Lt, Lm и Lo. diff --git a/reference/intl/intlchar/isbase.xml b/reference/intl/intlchar/isbase.xml index c2523868d..2d0783e4d 100644 --- a/reference/intl/intlchar/isbase.xml +++ b/reference/intl/intlchar/isbase.xml @@ -15,7 +15,7 @@ Метод проверяет, относится ли кодовая точка к базовому символу. Метод возвращает &true; для общих категорий - букв — L, чисел — N, протяжённых комбинирующих меток — Mc и охватывающих меток — Me. + букв — L, чисел — N, протяжённых комбинирующих меток — Mc и охватывающих меток — Me. diff --git a/reference/intl/intlchar/isdefined.xml b/reference/intl/intlchar/isdefined.xml index 637f4039f..73be23ff7 100644 --- a/reference/intl/intlchar/isdefined.xml +++ b/reference/intl/intlchar/isdefined.xml @@ -18,13 +18,13 @@ Метод возвращает &true; для символов всех общих категорий, за исключением - категории неназначенных кодовых точек — Cn, в которую входят и несимвольные кодовые точки. + категории неназначенных кодовых точек — Cn, в которую входят и несимвольные кодовые точки. Обратите внимание, метод не считает несимвольные кодовые точки наподобие U+FDD0 «определёнными», поскольку такие кодовые точки входят в категорию Cn, - тогда как суррогатные кодовые точки «определены», поскольку входят в категорию суррогатов — Cs. + тогда как суррогатные кодовые точки «определены», поскольку входят в категорию суррогатов — Cs. diff --git a/reference/intl/intlchar/isidpart.xml b/reference/intl/intlchar/isidpart.xml index 46358cb5e..5dc388d15 100644 --- a/reference/intl/intlchar/isidpart.xml +++ b/reference/intl/intlchar/isidpart.xml @@ -17,17 +17,17 @@ Метод определяет, допустим ли символ как часть идентификатора. - Метод возвращает &true; для символов общей категории букв — L, буквенных чисел — Nl, десятичных цифр — Nd, - протяжённых и непротяжённых комбинирующих меток — Mc и Mn, соединителей пунктуации — Pc + Метод возвращает &true; для символов общей категории букв — L, буквенных чисел — Nl, десятичных цифр — Nd, + протяжённых и непротяжённых комбинирующих меток — Mc и Mn, соединителей пунктуации — Pc и символов, которые разрешается игнорировать в идентификаторах, как это определяет внутренняя функция - библиотеки ICU — u_isIDIgnorable(c). + библиотеки ICU — u_isIDIgnorable(c). Почти то же самое, что и символы со свойством ID_Continue в кодировке Unicode, которые в PHP кодирует константа IntlChar::PROPERTY_ID_CONTINUE, за исключением того, что Юникод рекомендует игнорировать символы общей категории - прочих символов форматирования — Cf, набор которых меньше набора игнорируемых символов, + прочих символов форматирования — Cf, набор которых меньше набора игнорируемых символов, как их определяет метод IntlChar::isIDIgnorable. diff --git a/reference/json/functions/json-validate.xml b/reference/json/functions/json-validate.xml index 27ec872a9..b97aa0615 100644 --- a/reference/json/functions/json-validate.xml +++ b/reference/json/functions/json-validate.xml @@ -88,7 +88,7 @@ &reftitle.returnvalues; - Функция возвращает &true;, если входная строка — синтаксически допустимый JSON, + Функция возвращает &true;, если входная строка — синтаксически допустимый JSON, иначе &false;. @@ -100,7 +100,7 @@ если значение параметра depth выходит за пределы допустимого диапазона. - Если значение параметра flags — недопустимый флаг, + Если значение параметра flags — недопустимый флаг, выбрасывается исключение ValueError. diff --git a/reference/ldap/functions/ldap-connect.xml b/reference/ldap/functions/ldap-connect.xml index b0cdfdee4..0686b8d46 100644 --- a/reference/ldap/functions/ldap-connect.xml +++ b/reference/ldap/functions/ldap-connect.xml @@ -89,7 +89,7 @@ Если никакие параметры не будут определены, тогда будет возвращён экземпляр - открытого соединения — LDAP\Connection. + открытого соединения — LDAP\Connection. diff --git a/reference/ldap/functions/ldap-get-values.xml b/reference/ldap/functions/ldap-get-values.xml index 1c4b11e5b..2f4425965 100644 --- a/reference/ldap/functions/ldap-get-values.xml +++ b/reference/ldap/functions/ldap-get-values.xml @@ -115,7 +115,7 @@ // Переменная $ds — допустимый экземпляр класса LDAP\Connection -// Переменная $sr — правильный результат поиска в LDAP-директории +// Переменная $sr — правильный результат поиска в LDAP-директории // Переменная $entry — правильный идентификатор записи из вызова функции, // которая вернула запись директории diff --git a/reference/ldap/functions/ldap-search.xml b/reference/ldap/functions/ldap-search.xml index aaafc53a0..143a33489 100644 --- a/reference/ldap/functions/ldap-search.xml +++ b/reference/ldap/functions/ldap-search.xml @@ -71,7 +71,7 @@ Этот параметр эффективнее, чем действие по умолчанию, которое возвращает все атрибуты и присвоенные атрибутам значения. - Поэтому работа с этим параметром — хорошая практика. + Поэтому работа с этим параметром — хорошая практика. @@ -215,7 +215,7 @@ // $ds допустимый экземпляр класса LDAP\Connection -// Переменная $person — всё или часть имени человека, например Jo +// Переменная $person — всё или часть имени человека, например Jo $dn = "o=My Company, c=US"; $filter="(|(sn=$person*)(givenname=$person*))"; diff --git a/reference/math/functions/bindec.xml b/reference/math/functions/bindec.xml index e1ece9349..f911438b3 100644 --- a/reference/math/functions/bindec.xml +++ b/reference/math/functions/bindec.xml @@ -114,7 +114,7 @@ echo bindec('111'); &reftitle.returnvalues; - Функция возвращает число с плавающей точкой — результат + Функция возвращает число с плавающей точкой — результат деления числа num1 на число num2. @@ -83,7 +83,7 @@ var_dump(fdiv(0.0, 0.0)); // float(NAN) - / — Оператор деления + / — Оператор деления intdiv — Целочисленное деление fmod diff --git a/reference/mbstring/functions/mb-convert-case.xml b/reference/mbstring/functions/mb-convert-case.xml index 7af940e3a..4b04f4664 100644 --- a/reference/mbstring/functions/mb-convert-case.xml +++ b/reference/mbstring/functions/mb-convert-case.xml @@ -162,7 +162,7 @@ echo $str; // Выведет Τάχιστη Αλώπηξ Βαφήσ Ψημένη регистр меняется на основе свойств символа Юникода. Поэтому на поведение этой функции не влияют региональные настройки системы, и она умеет конвертировать символы с Unicode-свойством 'alphabetic' - наподобие символа буквы «а» с умлаутом — ä. + наподобие символа буквы «а» с умлаутом — ä. Подробнее о свойствах Юникода рассказывает страница Текущая кодировка, которая будет использована для интерпретации строки string. Несколько кодировок разрешено указывать в виде массива (&array;) или разделённого запятыми списка, - тогда PHP попытается определить правильную кодировку по тому же алгоритму, + тогда PHP попытается определить правильную кодировку по тому же алгоритму, который использует функция mb_detect_encoding. diff --git a/reference/mbstring/functions/mb-detect-encoding.xml b/reference/mbstring/functions/mb-detect-encoding.xml index 5a2216e53..4f7a7661e 100644 --- a/reference/mbstring/functions/mb-detect-encoding.xml +++ b/reference/mbstring/functions/mb-detect-encoding.xml @@ -24,7 +24,7 @@ Автоматическое определение предполагаемой кодировки символов не полностью надёжно; без дополнительной информации это похоже на расшифровку зашифрованной строки без ключа. Лучше предпочесть указание кодировки символов, хранящейся или передаваемой с данными, - например в HTTP-заголовке Content-Type. + например в HTTP-заголовке Content-Type. Функция будет полезнее, если вызывать её с многобайтовыми кодировками, diff --git a/reference/mbstring/functions/mb-detect-order.xml b/reference/mbstring/functions/mb-detect-order.xml index ae4feee14..73de4bc1d 100644 --- a/reference/mbstring/functions/mb-detect-order.xml +++ b/reference/mbstring/functions/mb-detect-order.xml @@ -71,7 +71,7 @@ &reftitle.returnvalues; - При установке порядка определения кодировки: возвращает &true; в случае успешного выполнения или &false; в случае возникновения ошибки. + При установке порядка определения кодировки: возвращает &true; в случае успешного выполнения или &false; в случае возникновения ошибки. При получении порядка определения кодировки: возвращает массив кодировок в установленном порядке. diff --git a/reference/mbstring/functions/mb-ereg-search-getregs.xml b/reference/mbstring/functions/mb-ereg-search-getregs.xml index 09b1883f1..7aec3b7af 100644 --- a/reference/mbstring/functions/mb-ereg-search-getregs.xml +++ b/reference/mbstring/functions/mb-ereg-search-getregs.xml @@ -29,7 +29,7 @@ &reftitle.returnvalues; Возвращает массив (array), содержащий совпавшие с регулярным выражением - подстроки, полученные после срабатывания функций + подстроки, полученные после срабатывания функций mb_ereg_search, mb_ereg_search_pos, mb_ereg_search_regs. Если совпадений несколько, то первый элемент будет содержать совпавшую подстроку, второй будет diff --git a/reference/mbstring/functions/mb-language.xml b/reference/mbstring/functions/mb-language.xml index d8012622b..48c45fe46 100644 --- a/reference/mbstring/functions/mb-language.xml +++ b/reference/mbstring/functions/mb-language.xml @@ -28,7 +28,7 @@ Функцией кодируют сообщения электронной почты. Допустимые языки перечислены в следующей таблице. -       Функция mb_send_mail использует параметр для кодирования электронной почты. + Функция mb_send_mail использует параметр для кодирования электронной почты. diff --git a/reference/mbstring/functions/mb-strripos.xml b/reference/mbstring/functions/mb-strripos.xml index 291b825ca..dde6beccd 100644 --- a/reference/mbstring/functions/mb-strripos.xml +++ b/reference/mbstring/functions/mb-strripos.xml @@ -73,7 +73,7 @@ &reftitle.returnvalues; - Возвращает число — позицию последнего вхождения подстроки needle + Возвращает число — позицию последнего вхождения подстроки needle в строку haystack либо &false;, если подстрока needle не найдена. diff --git a/reference/mbstring/reference.xml b/reference/mbstring/reference.xml index 4325b5556..feee0e4df 100644 --- a/reference/mbstring/reference.xml +++ b/reference/mbstring/reference.xml @@ -10,7 +10,7 @@ Схемы многобайтного кодирования символов и связанные с ними проблемы сложны, а их описание выходит за пределы этой документации. Дополнительная информация - о кодировках и о том, как они устроены, доступна в следующих источниках: + о кодировках и о том, как они устроены, доступна в следующих источниках: diff --git a/reference/mcrypt/functions/mcrypt-module-open.xml b/reference/mcrypt/functions/mcrypt-module-open.xml index 2aa694023..b019f848f 100644 --- a/reference/mcrypt/functions/mcrypt-module-open.xml +++ b/reference/mcrypt/functions/mcrypt-module-open.xml @@ -119,7 +119,7 @@ $iv = mcrypt_create_iv(mcrypt_enc_get_iv_size($td), MCRYPT_DEV_RANDOM); $ks = mcrypt_enc_get_key_size($td); - /* Создаём ключ (только как пример: алгортим MD5 — плохой алгоритм хеширования для хранения секретов) */ + /* Создаём ключ (только как пример: алгортим MD5 — плохой алгоритм хеширования для хранения секретов) */ $key = substr(hash('md5', 'very secret key'), 0, $ks); /* Инициализируем шифрование */ diff --git a/reference/memcached/ini.xml b/reference/memcached/ini.xml index 20856def9..0aacbfa0c 100644 --- a/reference/memcached/ini.xml +++ b/reference/memcached/ini.xml @@ -225,7 +225,7 @@ Если установлено значение On, то для обработки сессий будет использовано согласованное хеширование (libketama). При использовании согласованного хеширования можно добавлять или удалять узлы кеширования без больших потерь кешированных ключей. - По умолчанию — On. + По умолчанию — On. @@ -264,7 +264,7 @@ - Префикс ключа сессии. Строка длиной не более 219 байтов. По умолчанию — memc.sess.key. + Префикс ключа сессии. Строка длиной не более 219 байтов. По умолчанию — memc.sess.key. @@ -328,7 +328,7 @@ Коэффициент сжатия. Хранить значения сжатыми только если коэффициент сжатия превышает заданный. Храним сжатым, если: plain_len > comp_len * factor. - По умолчанию — 1.3 (экономия места 23 %). + По умолчанию — 1.3 (экономия места 23 %). @@ -478,7 +478,7 @@ Реплики модуля libmemcached работают, только если включён двоичный режим. Однако некоторые прокси (например, twemproxy) будут работать, только если двоичный протокол отключён. - По умолчанию — On с libmemcached 1.0.18 или новее. + По умолчанию — On с libmemcached 1.0.18 или новее. До libmemcached 1.0.18 значение по умолчанию Off. @@ -611,7 +611,7 @@ - Установка большего, чем установленное по умолчанию, + Установка большего, чем установленное по умолчанию, значения разрешит удаление сервера после заданного количества непрерывных сбоев подключения. По умолчанию — 0. diff --git a/reference/misc/functions/exit.xml b/reference/misc/functions/exit.xml index 3ce4288b1..6c777a625 100644 --- a/reference/misc/functions/exit.xml +++ b/reference/misc/functions/exit.xml @@ -28,7 +28,7 @@ Функция exit не похожа на другие функции, поскольку в парсере для неё выделили отдельный токен, - поэтому функцию разрешается вызывать без круглых скобок — как инструкцию + поэтому функцию разрешается вызывать без круглых скобок — как инструкцию завершения скрипта с кодом статуса по умолчанию. diff --git a/reference/misc/functions/pack.xml b/reference/misc/functions/pack.xml index b208bb92d..063974a03 100644 --- a/reference/misc/functions/pack.xml +++ b/reference/misc/functions/pack.xml @@ -270,7 +270,7 @@ $binarydata = pack("nvc*", 0x1234, 0x5678, 65, 66); будут храниться как float. При упаковке чисел с плавающей точкой как целых чисел числа с плавающей точкой сначала приводятся к целочисленному типу. - Поэтому результат или будет совпадать с заданной структурой байтов, или нет. + Поэтому результат или будет совпадать с заданной структурой байтов, или нет. Нагляднее остальных это показывает пример с упаковкой беззнаковых чисел, которые можно было бы представить diff --git a/reference/mongodb/architecture.xml b/reference/mongodb/architecture.xml index 1a4ecff93..ebce4f1e0 100644 --- a/reference/mongodb/architecture.xml +++ b/reference/mongodb/architecture.xml @@ -39,17 +39,17 @@ и реализует междрайверные спецификации. Хотя модуль можно использовать напрямую, библиотека даёт минимальные накладные расходы - и должна быть общей зависимостью для большей части приложений, построенных с MongoDB. + и должна быть общей зависимостью для большей части приложений, построенных с MongoDB. На уровень ниже библиотеки располагается PHP-модуль, который распространяется через репозиторий PECL. - Модуль образует связующую прослойку между PHP и системными библиотеками + Модуль образует связующую прослойку между PHP и системными библиотеками (libmongoc, libbson и libmongocrypt). - Этот публичный API предлагает только самую базовую функциональность: + Этот публичный API предлагает только самую базовую функциональность: Управление соединением diff --git a/reference/mongodb/configure.xml b/reference/mongodb/configure.xml index c0ff02719..a56fd45e7 100644 --- a/reference/mongodb/configure.xml +++ b/reference/mongodb/configure.xml @@ -78,7 +78,7 @@ $ sudo pecl install --configureoptions='with-mongodb-system-libs="yes" enable-mo И наконец, добавляют следующую строку в файл &php.ini; для каждого окружения, - в котором будет работать модуль: + в котором будет работать модуль: --with-mongodb-ssl команды configure. Начиная с версии модуля 1.17.0 по умолчанию предпочтение отдаётся библиотеке OpenSSL. Предыдущие версии драйвера на системах с macOS по умолчанию выбирали Secure Transport, - а на остальных платформах — OpenSSL. + а на остальных платформах — OpenSSL. diff --git a/reference/mongodb/mongodb/driver/cursorid.xml b/reference/mongodb/mongodb/driver/cursorid.xml index f44d0af99..0d98a4c72 100644 --- a/reference/mongodb/mongodb/driver/cursorid.xml +++ b/reference/mongodb/mongodb/driver/cursorid.xml @@ -12,7 +12,7 @@
&reftitle.intro; - Класс MongoDB\Driver\CursorID — объект значения, + Класс MongoDB\Driver\CursorID — объект значения, который представляет идентификатор курсора. Экземпляры класса возвращает метод MongoDB\Driver\Cursor::getId. diff --git a/reference/mongodb/mongodb/driver/manager/executequery.xml b/reference/mongodb/mongodb/driver/manager/executequery.xml index 4387f7f5c..f7463b42e 100644 --- a/reference/mongodb/mongodb/driver/manager/executequery.xml +++ b/reference/mongodb/mongodb/driver/manager/executequery.xml @@ -86,7 +86,7 @@ PECL mongodb 1.4.0 - Третий параметр теперь — массив параметров options. + Третий параметр теперь — массив параметров options. В целях обратной совместимости этот параметр по-прежнему будет принимать объект MongoDB\Driver\ReadPreference. diff --git a/reference/mqseries/constants.xml b/reference/mqseries/constants.xml index 5193c5250..ca6498a16 100644 --- a/reference/mqseries/constants.xml +++ b/reference/mqseries/constants.xml @@ -7,7 +7,7 @@ Модуль mqseries содержит дубликаты каждой константы диспетчера очередей WebSphere MQ. - Про значение и как применять эти константы рассказывают книги + Про значение и как применять эти константы рассказывают книги WebSphere MQ Application Programming Guide и WebSphere MQ Application Programming Referenc. diff --git a/reference/mysql_xdevapi/examples.xml b/reference/mysql_xdevapi/examples.xml index c3cd5e1b3..e7598a13a 100644 --- a/reference/mysql_xdevapi/examples.xml +++ b/reference/mysql_xdevapi/examples.xml @@ -100,7 +100,7 @@ array(4) { В примере также показано, что извлечённые данные отсортированы по алфавиту. - Этот конкретный порядок обоснован эффективным двоичным хранилищем внутри сервера MySQL, но + Этот конкретный порядок обоснован эффективным двоичным хранилищем внутри сервера MySQL, но на него не нужно полагаться. Подробнее об этом рассказано в документации по типу данных MySQL JSON. diff --git a/reference/mysql_xdevapi/mysql_xdevapi/collection/removeone.xml b/reference/mysql_xdevapi/mysql_xdevapi/collection/removeone.xml index 7bc948248..7477bd81d 100644 --- a/reference/mysql_xdevapi/mysql_xdevapi/collection/removeone.xml +++ b/reference/mysql_xdevapi/mysql_xdevapi/collection/removeone.xml @@ -16,7 +16,7 @@ Метод удаляет один документ из коллекции по идентификатору. - Этот метод — сокращённая запись вызова Collection.remove("_id = :id").bind("id", id).execute(). + Этот метод — сокращённая запись вызова Collection.remove("_id = :id").bind("id", id).execute(). diff --git a/reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockexclusive.xml b/reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockexclusive.xml index 28e63a326..18b8339fa 100644 --- a/reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockexclusive.xml +++ b/reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockexclusive.xml @@ -22,7 +22,7 @@ которые существуют в представлении чтения. - Чтобы не было проблем с конкурентным доступом, + Чтобы не было проблем с конкурентным доступом, имеет ссмысл вызывать этот метод совместно с методом mysql_xdevapi\Collection::modify. По существу, эта функция использует блокировки строк для сериализации доступа к строкам. @@ -37,7 +37,7 @@ Дополнительная опция ожидания. Значение по умолчанию — MYSQLX_LOCK_DEFAULT. - Допустимые значения определены константами: + Допустимые значения определены константами: MYSQLX_LOCK_DEFAULT diff --git a/reference/mysql_xdevapi/mysql_xdevapi/collectionmodify/arrayinsert.xml b/reference/mysql_xdevapi/mysql_xdevapi/collectionmodify/arrayinsert.xml index 73ddca9b7..474ad5756 100644 --- a/reference/mysql_xdevapi/mysql_xdevapi/collectionmodify/arrayinsert.xml +++ b/reference/mysql_xdevapi/mysql_xdevapi/collectionmodify/arrayinsert.xml @@ -16,7 +16,7 @@ Добавляет элемент в поле документа, когда поле — это массив из нескольких элементов. - Через этот метод, в отличие от метода mysql_xdevapi\CollectionModify::arrayAppend, + Через этот метод, в отличие от метода mysql_xdevapi\CollectionModify::arrayAppend, можно указать, куда добавится новый элемент, определяя, после какого элемента он будет идти, тогда как метод mysql_xdevapi\CollectionModify::arrayAppend добавляет новый элемент в конец массива. @@ -36,7 +36,7 @@ а INDEX — это INDEX элемента в поле. - Поле INDEX основано на нуле, поэтому у первого элемента массива индекс — 0. + Поле INDEX основано на нуле, поэтому у первого элемента массива индекс — 0. diff --git a/reference/mysqli/overview.xml b/reference/mysqli/overview.xml index 070779c7f..2986bd569 100644 --- a/reference/mysqli/overview.xml +++ b/reference/mysqli/overview.xml @@ -23,7 +23,7 @@ Программисты взаимодействуют с модулями через процедурный или объектно-ориентированный API-интерфейс. - При работе через процедурный API задачи выполняют путём вызова функций, + При работе через процедурный API задачи выполняют путём вызова функций, при взаимодействии через объектно-ориентированный API-интерфейс создают экземпляры классов, а затем вызывают методы этих объектов. Из этих двух интерфейсов часто выбирают последний, поскольку код в объектно-ориентированном стиле лучше организован, что снижает сложность @@ -76,7 +76,7 @@ Например, PHP-модуль PDO, который поддерживает доступ к базам данных на уровне абстракции, содержит набор драйверов для доступа к конкретным базам данных. - В список доступных модулю драйверов входит драйвер PDO_MYSQL, + В список доступных модулю драйверов входит драйвер PDO_MYSQL, который разрешает модулю PDO взаимодействовать с сервером MySQL. @@ -142,7 +142,7 @@ - Каждый модуль содержит достоинства, но встречаются и недостатки. Цель следующей части обзора + Каждый модуль содержит достоинства, но встречаются и недостатки. Цель следующей части обзора состоит в кратком описании характеристик каждого API-интерфейса. diff --git a/reference/mysqlnd/plugin.xml b/reference/mysqlnd/plugin.xml index b57da0528..7a6a0209a 100644 --- a/reference/mysqlnd/plugin.xml +++ b/reference/mysqlnd/plugin.xml @@ -480,7 +480,7 @@ void minit_register_hooks(TSRMLS_D) { Если записи оригинальной таблицы функций сохранились, - остаётся возможность вызвать оригинальный метод — родительский. + остаётся возможность вызвать оригинальный метод — родительский. В отдельных случаях, например, для Connection::stmt_init(), жизненно diff --git a/reference/mysqlnd/stats.xml b/reference/mysqlnd/stats.xml index 9405d3a60..d6835d577 100644 --- a/reference/mysqlnd/stats.xml +++ b/reference/mysqlnd/stats.xml @@ -59,7 +59,7 @@ Обе функции возвращают ассоциативный массив, - в котором метрики статистики — ключи, которые + в котором метрики статистики — ключи, которые соответствуют статистическим данным.
diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml index c47215ea4..aaacce61f 100644 --- a/reference/network/functions/setcookie.xml +++ b/reference/network/functions/setcookie.xml @@ -251,7 +251,7 @@ setcookie("TestCookie", $value, time()+3600, "/~rasmus/", "example.com", true); Обратите внимание, что функция автоматически URL-кодирует часть значения cookie перед отправкой клиенту, - а когда получает cookie — автоматически декодирует часть значения и присваивает переменной + а когда получает cookie — автоматически декодирует часть значения и присваивает переменной с тем же именем, что и имя cookie. Если URL-кодирование значения не нужно, вызывают функцию setrawcookie. Просто запустите один из примеров, чтобы просмотреть имена и значения тестовых блоков данных cookie в скрипте: diff --git a/reference/openssl/functions/openssl-pkcs7-encrypt.xml b/reference/openssl/functions/openssl-pkcs7-encrypt.xml index 8522b04fe..67f263aa8 100644 --- a/reference/openssl/functions/openssl-pkcs7-encrypt.xml +++ b/reference/openssl/functions/openssl-pkcs7-encrypt.xml @@ -140,7 +140,7 @@ $data = << Определяет, готов ли буфер вывода, который создали - функцией ob_start, к сбросу — выводу и очистке — + функцией ob_start, к сбросу — выводу и очистке — функцией ob_flush. Это флаг не управляет поведением функций ob_end_flush или ob_get_flush. diff --git a/reference/outcontrol/examples.xml b/reference/outcontrol/examples.xml index 1d5e22921..026f1e6fe 100644 --- a/reference/outcontrol/examples.xml +++ b/reference/outcontrol/examples.xml @@ -29,7 +29,7 @@ ob_end_flush(); будет храниться в буфере вывода до вызова функции ob_end_flush. Тем временем вызов функции setcookie успешно сохранится в - cookie браузера, не вызывая ошибки (заголовки не получится отправить + cookie браузера, не вызывая ошибки (заголовки не получится отправить в браузер, когда данные уже отправлены).
diff --git a/reference/outcontrol/flushing-system-buffers.xml b/reference/outcontrol/flushing-system-buffers.xml index ac7850e01..130c3646a 100644 --- a/reference/outcontrol/flushing-system-buffers.xml +++ b/reference/outcontrol/flushing-system-buffers.xml @@ -6,8 +6,8 @@ PHP предлагает два взаимосвязанных способа сброса (отправки и удаления содержимого) системных буферов: - один — вызов функции flush, - другой — включение неявного сброса + один — вызов функции flush, + другой — включение неявного сброса функцией ob_implicit_flush или директивой implicit_flush в файле &php.ini;. diff --git a/reference/outcontrol/functions/flush.xml b/reference/outcontrol/functions/flush.xml index 17c0d6d1f..80270a866 100644 --- a/reference/outcontrol/functions/flush.xml +++ b/reference/outcontrol/functions/flush.xml @@ -24,7 +24,7 @@ Функция flush, возможно, не сумеет переопределить схему буферизации веб-сервера и работа функция не отразится - на буферизации на стороне клиента в браузере. + на буферизации на стороне клиента в браузере. diff --git a/reference/parle/pattern.matching.xml b/reference/parle/pattern.matching.xml index 83403eda1..33efdd0ad 100644 --- a/reference/parle/pattern.matching.xml +++ b/reference/parle/pattern.matching.xml @@ -365,10 +365,10 @@ -i — с учётом регистра. - s — изменяет значение ., чтобы соответствовать любому символу. + s — изменяет значение ., чтобы соответствовать любому символу. - -s — изменяет значение ., + -s — изменяет значение ., чтобы соответствовать любому символу кроме \n. diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml index 46ac53bb9..0e0d4e34f 100644 --- a/reference/password/functions/password-hash.xml +++ b/reference/password/functions/password-hash.xml @@ -140,7 +140,7 @@ Использование алгоритма PASSWORD_BCRYPT приведёт - к обрезанию поля password до максимальной длины — 72 байта. + к обрезанию поля password до максимальной длины — 72 байта. @@ -319,7 +319,7 @@ $2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K * Этот код замерит скорость выполнения операции с разными значениями алгоритмической сложности хеширования * на вашем сервере и определит * его максимальное значение, не приводящее к деградации производительности. Хорошее базовое - * значение — 10, но если ваш сервер достаточно мощный, то можно + * значение — 10, но если ваш сервер достаточно мощный, то можно * задать и больше. Данный скрипт ищет максимальное значение, при котором * хеширование уложится в значение ≤ 350 миллисекундам, что считается приемлемой задержкой * для систем, которые обрабатывают интерактивные входы. diff --git a/reference/pcre/configure.xml b/reference/pcre/configure.xml index be30b5d98..23de48bec 100644 --- a/reference/pcre/configure.xml +++ b/reference/pcre/configure.xml @@ -14,7 +14,7 @@ Компиляция регулярных выражений библиотеки PCRE по принципу «точно в срок», - или JIT, поддерживается по умолчанию. C PHP 7.0.12 появился доступ к отключению + или JIT, поддерживается по умолчанию. C PHP 7.0.12 появился доступ к отключению JIT-компиляции регулярных выражений через опцию . diff --git a/reference/pcre/constants.xml b/reference/pcre/constants.xml index 66d75d037..99b154997 100644 --- a/reference/pcre/constants.xml +++ b/reference/pcre/constants.xml @@ -39,7 +39,7 @@ элемент $matches[0] содержал первый набор вхождений (полное вхождение, вхождение первой подмаски, заключённой в круглые скобки...), аналогично элемент - $matches[1] — второй набор вхождений и т. д. + $matches[1] — второй набор вхождений и т. д. Этот флаг указывают только при вызове функции preg_match_all. @@ -87,7 +87,7 @@ Когда указывают этот флаг, учитывают, что флаг меняет формат данных, которые возвращает функция: каждое вхождение возвращается как массив, в нулевом элементе - которого содержится найденная подстрока, а в первом — смещение. + которого содержится найденная подстрока, а в первом — смещение. Этот флаг указывают только при вызове функции preg_split. diff --git a/reference/pcre/pattern.modifiers.xml b/reference/pcre/pattern.modifiers.xml index dedfca651..24c33d7b1 100644 --- a/reference/pcre/pattern.modifiers.xml +++ b/reference/pcre/pattern.modifiers.xml @@ -28,7 +28,7 @@ которая состоит из одной «строки» символов, даже если строка содержит переходы на новую строку. - Метасимвол «начала строки» — «^» — соответствует только началу + Метасимвол «начала строки» — «^» — соответствует только началу строки, тогда как метасимвол «конца строки» — «$» — соответствует только концу строки или позиции перед переводом строки, который завершает текст, если не установили модификатор @@ -103,7 +103,7 @@ Шаблон, который сопоставляется многократно, заслуживает того, чтобы парсер - потратил на анализ этого шаблона больше времени, чтобы увеличить скорость сопоставления. + потратил на анализ этого шаблона больше времени, чтобы увеличить скорость сопоставления. Парсер дополнительно анализирует шаблон при установке этого модификатора. Изучение шаблона парсером полезно только для «незаякоренных» шаблонов, которые не начинаются с фиксированного начального символа. С PHP 7.3.0 флаг не даёт эффекта. diff --git a/reference/pcre/pattern.syntax.xml b/reference/pcre/pattern.syntax.xml index 6c2558544..dbf1c18b8 100644 --- a/reference/pcre/pattern.syntax.xml +++ b/reference/pcre/pattern.syntax.xml @@ -2257,7 +2257,7 @@ int(1) - Максимальная длина входной строки — наибольшее положительное число, + Максимальная длина входной строки — наибольшее положительное число, которое может содержать целочисленная переменная. Однако, поскольку для обработки подшаблонов и бесконечного повторения модуль PCRE запускает рекурсию, это означает, что размер обрабатываемых строк в некоторых шаблонах также может быть diff --git a/reference/pdo/pdo/getattribute.xml b/reference/pdo/pdo/getattribute.xml index 4d1e27410..28e3ea3d2 100644 --- a/reference/pdo/pdo/getattribute.xml +++ b/reference/pdo/pdo/getattribute.xml @@ -36,7 +36,7 @@ attribute - Одна из констант PDO::ATTR_*. Список общих атрибутов, + Одна из констант PDO::ATTR_*. Список общих атрибутов, применяемых к подключениям к базе данных: PDO::ATTR_AUTOCOMMIT @@ -55,7 +55,7 @@ Некоторые драйверы могут использовать дополнительные, - характерные для этого драйвера, атрибуты. + характерные для этого драйвера, атрибуты. Обратите внимание, что атрибуты драйвера не должны быть использованы с другими драйверами. diff --git a/reference/pdo_dblib/reference.xml b/reference/pdo_dblib/reference.xml index c9cfd6b90..07554dfbd 100644 --- a/reference/pdo_dblib/reference.xml +++ b/reference/pdo_dblib/reference.xml @@ -25,7 +25,7 @@ Когда использовать драйвер SqlSrv невозможно, с СУБД Microsoft SQL Server и Sybase соединяются через драйвер - PDO_ODBC, поскольку собственный драйвер Windows DB-LIB + PDO_ODBC, поскольку собственный драйвер Windows DB-LIB устарел, непотокобезопасен и не поддерживается корпорацией Microsoft. diff --git a/reference/pdo_ibm/reference.xml b/reference/pdo_ibm/reference.xml index 96886a8fc..016a5c10a 100644 --- a/reference/pdo_ibm/reference.xml +++ b/reference/pdo_ibm/reference.xml @@ -57,7 +57,7 @@ - b) Каталогизированное имя базы данных — псевдоним базы данных + b) Каталогизированное имя базы данных — псевдоним базы данных в каталоге клиента БД DB2 diff --git a/reference/pdo_informix/reference.xml b/reference/pdo_informix/reference.xml index 98e828050..5df57754b 100644 --- a/reference/pdo_informix/reference.xml +++ b/reference/pdo_informix/reference.xml @@ -52,7 +52,7 @@ DSN-префикс - DSN-префикс — строка informix:. + DSN-префикс — строка informix:. diff --git a/reference/pdo_mysql/reference.xml b/reference/pdo_mysql/reference.xml index cd998a25d..4d14a79f1 100644 --- a/reference/pdo_mysql/reference.xml +++ b/reference/pdo_mysql/reference.xml @@ -46,7 +46,7 @@ если в коде, который работает с транзакционной базой данных, указали таблицу, которая не поддерживает транзакции. Кроме того, каждый выполненный DDL-запрос - будет неявно фиксировать незавершённые транзакции — то есть завершать открытые транзакции + будет неявно фиксировать незавершённые транзакции — то есть завершать открытые транзакции и выполнять стек незавершённых запросов. diff --git a/reference/pgsql/constants.xml b/reference/pgsql/constants.xml index 0df6fc044..b829f46f7 100644 --- a/reference/pgsql/constants.xml +++ b/reference/pgsql/constants.xml @@ -24,7 +24,7 @@ - До PHP 8.0.0 — длинное обозначение версии модуля libpq, которое включает информацию о компиляторе. + До PHP 8.0.0 — длинное обозначение версии модуля libpq, которое включает информацию о компиляторе. Начиная с PHP 8.0.0, значение идентично PGSQL_LIBPQ_VERSION, а использование PGSQL_LIBPQ_VERSION_STR устарело. diff --git a/reference/pgsql/functions/pg-fetch-array.xml b/reference/pgsql/functions/pg-fetch-array.xml index 3367021db..c026085dd 100644 --- a/reference/pgsql/functions/pg-fetch-array.xml +++ b/reference/pgsql/functions/pg-fetch-array.xml @@ -20,7 +20,7 @@ который соответствует выбранной строке (записи). - Функция pg_fetch_array — расширенный вариант функции + Функция pg_fetch_array — расширенный вариант функции pg_fetch_row. Эта функция умеет сохранять данные не только с числовыми индексами (номерами полей), но и с ассоциативными (именами полей). По умолчанию функция хранит и те, и другие. diff --git a/reference/phar/fileformat.xml b/reference/phar/fileformat.xml index 0dba3be82..c4562088e 100644 --- a/reference/phar/fileformat.xml +++ b/reference/phar/fileformat.xml @@ -56,10 +56,10 @@ __HALT_COMPILER(); В phar-архиве, основанном на tar или zip, заглушка хранится в -  файле .phar/stub.php. Заглушка по умолчанию для Phar-архива, -  основанного на phar, содержит приблизительно 7 килобайт кода для извлечения содержимого -  Phar-архива и его выполнения. Смотрите Phar::createDefaultStub -  для более подробной информации. + файле .phar/stub.php. Заглушка по умолчанию для Phar-архива, + основанного на phar, содержит приблизительно 7 килобайт кода для извлечения содержимого + Phar-архива и его выполнения. Смотрите Phar::createDefaultStub + для более подробной информации. В phar-архиве, основанном на tar или zip, псевдоним phar хранится в diff --git a/reference/radius/constants.xml b/reference/radius/constants.xml index ccdd61b99..722e2935d 100644 --- a/reference/radius/constants.xml +++ b/reference/radius/constants.xml @@ -615,7 +615,7 @@ radius_put_attr($radh, RADIUS_CHAP_CHALLENGE, $challenge); - Атрибут State. Значение атрибута — строка (string), которая зависит + Атрибут State. Значение атрибута — строка (string), которая зависит от реализации, включённая в ответ сервера Access-Challenge, которую нужно включить в следующий запрос Access-Request, и которая устанавливается функцией radius_put_attr. diff --git a/reference/random/random/randomizer/getfloat.xml b/reference/random/random/randomizer/getfloat.xml index 05b0d47aa..e296ac922 100644 --- a/reference/random/random/randomizer/getfloat.xml +++ b/reference/random/random/randomizer/getfloat.xml @@ -133,7 +133,7 @@ оно бы столкнулся со значением 2.125, который не совсем представим и будет подвергаться неявному округлению. - Поэтому алгоритм начинает работу с верхней границы — 2.5. + Поэтому алгоритм начинает работу с верхней границы — 2.5. Доступные значения: diff --git a/reference/readline/book.xml b/reference/readline/book.xml index e6252b859..bce224fe7 100644 --- a/reference/readline/book.xml +++ b/reference/readline/book.xml @@ -23,7 +23,7 @@ Модуль Readline непотокобезопасен! Поэтому не рекомендуют - использовать модуль с потокобезопасными SAPI-интерфейсами наподобие Apache-модуля для Windows — mod_winnt. + использовать модуль с потокобезопасными SAPI-интерфейсами наподобие Apache-модуля для Windows — mod_winnt. diff --git a/reference/reflection/reflectionclass/initializelazyobject.xml b/reference/reflection/reflectionclass/initializelazyobject.xml index 96b9ee271..3b4bb6d73 100644 --- a/reference/reflection/reflectionclass/initializelazyobject.xml +++ b/reference/reflection/reflectionclass/initializelazyobject.xml @@ -23,7 +23,7 @@ - В большей части случаев вызывать метод не потребуется, поскольку ленивые объекты + В большей части случаев вызывать метод не потребуется, поскольку ленивые объекты инициализируются автоматически, при начале отслеживания состояния или изменении ленивого объекта. diff --git a/reference/reflection/reflectionfunctionabstract/getclosurecalledclass.xml b/reference/reflection/reflectionfunctionabstract/getclosurecalledclass.xml index d956f31e5..762765e94 100644 --- a/reference/reflection/reflectionfunctionabstract/getclosurecalledclass.xml +++ b/reference/reflection/reflectionfunctionabstract/getclosurecalledclass.xml @@ -15,7 +15,7 @@ Метод возвращает объект рефлексии ReflectionClass для класса, - который соответствует статическому разрешению названия класса — static:: + который соответствует статическому разрешению названия класса — static:: внутри объекта Closure. @@ -28,7 +28,7 @@ &reftitle.returnvalues; - Метод возвращает объект рефлексии класса — ReflectionClass, + Метод возвращает объект рефлексии класса — ReflectionClass, который соответствует представлению static:: внутри объекта Closure. Метод вернёт &null; вместо объекта рефлексии класса, если функция не принадлежит типу замыкания или ограничивается глобальной областью видимости. diff --git a/reference/reflection/reflectionparameter/getclass.xml b/reference/reflection/reflectionparameter/getclass.xml index efcd82fac..3d3408890 100644 --- a/reference/reflection/reflectionparameter/getclass.xml +++ b/reference/reflection/reflectionparameter/getclass.xml @@ -24,7 +24,7 @@ Начиная с PHP 8.0.0 метод устарел и им не рекомендуют пользоваться. Вместо него лучше вызывать метод ReflectionParameter::getType, - чтобы получить экземпляр отражения параметра — ReflectionType, + чтобы получить экземпляр отражения параметра — ReflectionType, а затем опросить этот объект, чтобы определить тип параметра. diff --git a/reference/session/functions/session-create-id.xml b/reference/session/functions/session-create-id.xml index 99493aaef..8e0c1b570 100644 --- a/reference/session/functions/session-create-id.xml +++ b/reference/session/functions/session-create-id.xml @@ -24,7 +24,7 @@ Функция создаёт идентификатор сессии, который соответствует настройкам файла конфигурации php.ini. - Скрипт, который содержит задание по сборке мусора, требуется запускать с тем же идентификатором пользователя, + Скрипт, который содержит задание по сборке мусора, требуется запускать с тем же идентификатором пользователя, от имени которого запускается процесс веб-сервера. Несовпадение идентификаторов вызывает проблемы с разрешениями, которые острее остальных проявляются при работе дескриптора сохранения файлов. diff --git a/reference/simplexml/simplexmlelement/construct.xml b/reference/simplexml/simplexmlelement/construct.xml index afd1bf048..6464b676f 100644 --- a/reference/simplexml/simplexmlelement/construct.xml +++ b/reference/simplexml/simplexmlelement/construct.xml @@ -95,7 +95,7 @@ Для подавления XML-ошибок вызывают функцию libxml_use_internal_errors, - а для дальнейшей итерации по ошибкам — libxml_get_errors. + а для дальнейшей итерации по ошибкам — libxml_get_errors. diff --git a/reference/snmp/snmp/construct.xml b/reference/snmp/snmp/construct.xml index 12f629be1..3d06d4962 100644 --- a/reference/snmp/snmp/construct.xml +++ b/reference/snmp/snmp/construct.xml @@ -44,7 +44,7 @@ SNMP-агент. Необязательный порт SNMP-агента указывают - в виде суффикса — после имени хоста hostname через двоеточие. + в виде суффикса — после имени хоста hostname через двоеточие. IPv6-адреса заключают в квадратные скобки, если указывают с портом. Полное доменное имя (англ. Fully Qualified Domain Name, FQDN) разрешит PHP-модуль SNMP, а не движок Net-SNMP, если в аргументе hostname diff --git a/reference/sockets/book.xml b/reference/sockets/book.xml index 1c56b57f5..c1c1fbf31 100644 --- a/reference/sockets/book.xml +++ b/reference/sockets/book.xml @@ -22,12 +22,12 @@ Хотя заметная часть их имён похожа на имена аналогов в языке Си, - они часто объявлены по-разному. Об этом нужно помнить при работе с этими функциями. + они часто объявлены по-разному. Об этом нужно помнить при работе с этими функциями. Пожалуйста, прочитайте описания функций, чтобы избежать путаницы. - Много информации для знакомства с программированием сокетов - можно узнать на связанных страницах руководств для систем Unix, + Много информации для знакомства с программированием сокетов + можно узнать на связанных страницах руководств для систем Unix, в Интернете также много учебной информации по программированию сокетов на языке Си, большую часть которой с небольшими изменениями можно применить к программированию сокетов на PHP. Хорошим началом может быть diff --git a/reference/sodium/functions/sodium-crypto-auth-verify.xml b/reference/sodium/functions/sodium-crypto-auth-verify.xml index 6a4e0a384..38b2e026f 100644 --- a/reference/sodium/functions/sodium-crypto-auth-verify.xml +++ b/reference/sodium/functions/sodium-crypto-auth-verify.xml @@ -21,7 +21,7 @@ В отличие от цифровых подписей (например, которые проверяет функция sodium_crypto_sign_verify_detached), любая сторона, которая способна проверить сообщение, также способна проверить подлинность - своих собственных сообщений. (Следовательно, проверка подлинности — симметричная.) + своих собственных сообщений. (Следовательно, проверка подлинности — симметричная.) diff --git a/reference/spl/seekableiterator/seek.xml b/reference/spl/seekableiterator/seek.xml index 92489dee5..970cc2630 100644 --- a/reference/spl/seekableiterator/seek.xml +++ b/reference/spl/seekableiterator/seek.xml @@ -46,7 +46,7 @@ &reftitle.errors; - К реализациям метода предъявляется требование — выбрасывать + К реализациям метода предъявляется требование — выбрасывать исключение OutOfBoundsException, если смещение offset выходит за пределы доступного диапазона. diff --git a/reference/ssdeep/book.xml b/reference/ssdeep/book.xml index 41d9f343c..912931b19 100644 --- a/reference/ssdeep/book.xml +++ b/reference/ssdeep/book.xml @@ -9,7 +9,7 @@ &reftitle.intro; - ssdeep — утилита, которая умеет создавать и сравнивать нечёткие хеши + ssdeep — утилита, которая умеет создавать и сравнивать нечёткие хеши или частичное хеширование, которое зависит от контекста. diff --git a/reference/stats/book.xml b/reference/stats/book.xml index 12e436b1a..604ab9062 100644 --- a/reference/stats/book.xml +++ b/reference/stats/book.xml @@ -16,8 +16,8 @@ библиотек — DCDFLIB (библиотека процедур языка C для функций кумулятивного распределения, инверсий и других параметров) за авторством Б. Брауна и Дж. Лавато и библиотека RANDLIB за авторством Барри Брауна, Джеймса Лавато и Кэти Рассел. - Модуль включает биноминальные кумулятивные функция распределения — CD-функции - и биномиальные функция плотности вероятности — PD-функции. + Модуль включает биноминальные кумулятивные функция распределения — CD-функции + и биномиальные функция плотности вероятности — PD-функции. diff --git a/reference/stream/book.xml b/reference/stream/book.xml index 36b584a0b..b7386f711 100644 --- a/reference/stream/book.xml +++ b/reference/stream/book.xml @@ -38,7 +38,7 @@ Примеры включают: file, http, https, ftp, ftps, compress.zlib, compress.bz2 и php. Список встроенных в PHP обёрток приводит раздел «». - Функции устанавливают соединение через обёртку по умолчанию, часто это обёртка + Функции устанавливают соединение через обёртку по умолчанию, часто это обёртка file://, если обёртку не указали. diff --git a/reference/stream/constants.xml b/reference/stream/constants.xml index 672b1184c..711fd3b29 100644 --- a/reference/stream/constants.xml +++ b/reference/stream/constants.xml @@ -524,7 +524,7 @@ - IPv4 — интернет-протокол 4-й версии. + IPv4 — интернет-протокол 4-й версии. diff --git a/reference/strings/constants.xml b/reference/strings/constants.xml index 11ae3dabf..535de3948 100644 --- a/reference/strings/constants.xml +++ b/reference/strings/constants.xml @@ -349,7 +349,7 @@ - Сокращенное название первого дня недели (начиная с воскресенья — прим. перев.). + Сокращенное название первого дня недели (начиная с воскресенья — прим. перев.). @@ -855,7 +855,7 @@ - Дата и время в формате альтернативной эры — строка, которую + Дата и время в формате альтернативной эры — строка, которую разрешается передавать как строку формата в функцию strftime. @@ -868,7 +868,7 @@ - Дата в формате альтернативной эры — строка, которую + Дата в формате альтернативной эры — строка, которую разрешается передавать как строку формата в функцию strftime. @@ -881,7 +881,7 @@ - Время в формате альтернативной эры — строка, которую + Время в формате альтернативной эры — строка, которую разрешается передавать как строку формата в функцию strftime. diff --git a/reference/strings/functions/echo.xml b/reference/strings/functions/echo.xml index c084f5dde..9d6229810 100644 --- a/reference/strings/functions/echo.xml +++ b/reference/strings/functions/echo.xml @@ -21,7 +21,7 @@ Аргументы конструкции — список выражений, которые идут за ключевым словом echo, разделяются запятыми и не ограничиваются круглыми скобками. Языковая конструкция echo, в отличие от других языковых конструкций, - не возвращает никаких значений, поэтому её нельзя использовать в контексте выражения. + не возвращает никаких значений, поэтому её нельзя использовать в контексте выражения. У конструкции echo есть также краткий синтаксис, @@ -132,7 +132,7 @@ echo $some_var ? 'true': 'false'; // сначала выполняется вы Заключение одного аргумента для конструкции echo в круглые скобки не вызовет синтаксической ошибки и создаст синтаксис, который выглядит как обычный вызов функции. Однако это может ввести в заблуждение, потому что круглые скобки - интерпретируются как часть выводимого выражения, а не часть самого + интерпретируются как часть выводимого выражения, а не часть самого синтаксиса echo. diff --git a/reference/strings/functions/html-entity-decode.xml b/reference/strings/functions/html-entity-decode.xml index 341933d21..22aa8e0e9 100644 --- a/reference/strings/functions/html-entity-decode.xml +++ b/reference/strings/functions/html-entity-decode.xml @@ -18,11 +18,11 @@ Функция html_entity_decode выполняет преобразование обратное функции htmlentities, разница в том, что эта функция - наоборот — преобразовывает HTML-сущности в строке string в символы. + наоборот — преобразовывает HTML-сущности в строке string в символы. - Точнее, эта функция декодирует сущности (включая числовые), - которые а) допускает тип документа — то есть, + Точнее, эта функция декодирует сущности (включая числовые), + которые а) допускает тип документа — то есть, для XML-документов функция не декодирует именованные сущности, которые определяет схема DTD и б) символ или символы которых входят в кодированный набор символов, который связан с выбранной кодировкой, и которые разрешает выбранный тип документа. diff --git a/reference/strings/functions/htmlentities.xml b/reference/strings/functions/htmlentities.xml index af7403460..305cca3ed 100644 --- a/reference/strings/functions/htmlentities.xml +++ b/reference/strings/functions/htmlentities.xml @@ -27,7 +27,7 @@ Функция html_entity_decode выполняет обратное - преобразование — декодирует HTML-сущности в символы. + преобразование — декодирует HTML-сущности в символы. diff --git a/reference/strings/functions/strpos.xml b/reference/strings/functions/strpos.xml index 01a076679..ad9f796cb 100644 --- a/reference/strings/functions/strpos.xml +++ b/reference/strings/functions/strpos.xml @@ -118,7 +118,7 @@ $findme = 'a'; $pos = strpos($mystring, $findme); // Обратите внимание, что значения сравниваются оператором ===. Оператор == не будет работать -// как ожидается, поскольку позиция символа «a» — первого по счёту символа — равнялась 0. +// как ожидается, поскольку позиция символа «a» — первого по счёту символа — равнялась 0. if ($pos === false) { echo "Функция не нашла подстроку «{$findme}» в строке «{$mystring}»"; } else { diff --git a/reference/taint/book.xml b/reference/taint/book.xml index de1eba618..dfd229511 100644 --- a/reference/taint/book.xml +++ b/reference/taint/book.xml @@ -10,7 +10,7 @@ &reftitle.intro; - Taint — модуль определения XSS-кодов — вредоносных, или «грязных» строк (англ. tainted strings). + Taint — модуль определения XSS-кодов — вредоносных, или «грязных» строк (англ. tainted strings). Модуль также помогает выявлять попытки внедрения SQL-инъекций, shell-инъекций и т. д. diff --git a/reference/trader/functions/trader-sarext.xml b/reference/trader/functions/trader-sarext.xml index 1f11cc3c8..6278835b3 100644 --- a/reference/trader/functions/trader-sarext.xml +++ b/reference/trader/functions/trader-sarext.xml @@ -96,7 +96,7 @@ Коэффициент ускорения для длинного направления. - Допустимый диапазон — от 0 до значения константы + Допустимый диапазон — от 0 до значения константы TRADER_REAL_MAX . diff --git a/reference/trader/functions/trader-ultosc.xml b/reference/trader/functions/trader-ultosc.xml index 33f05d3f6..75d0e5ead 100644 --- a/reference/trader/functions/trader-ultosc.xml +++ b/reference/trader/functions/trader-ultosc.xml @@ -55,7 +55,7 @@ timePeriod1 - Количество баров (столбцов) за 1-й период. Допустимый диапазон — от 1 до 100 000. + Количество баров (столбцов) за 1-й период. Допустимый диапазон — от 1 до 100 000. diff --git a/reference/uodbc/functions/odbc-connect.xml b/reference/uodbc/functions/odbc-connect.xml index 119452d86..7317b6e57 100644 --- a/reference/uodbc/functions/odbc-connect.xml +++ b/reference/uodbc/functions/odbc-connect.xml @@ -27,7 +27,7 @@ select statement in it" («Невозможно открыть курсор в хранимой процедуре, которая содержит другие команды, кроме одной команды SELECT»). Тип курсора SQL_CUR_USE_ODBC помогает избегать появления этой ошибки. Отдельные драйверы также не поддерживают необязательный параметр row_number - в функции odbc_fetch_row. Курсор SQL_CUR_USE_ODBC также иногда помогает в похожих случаях. + в функции odbc_fetch_row. Курсор SQL_CUR_USE_ODBC также иногда помогает в похожих случаях. diff --git a/reference/uodbc/functions/odbc-error.xml b/reference/uodbc/functions/odbc-error.xml index d619da56c..2c4d30f04 100644 --- a/reference/uodbc/functions/odbc-error.xml +++ b/reference/uodbc/functions/odbc-error.xml @@ -42,7 +42,7 @@ Функция возвращает осмысленное значение, только если последний ODBC-запрос - завершился ошибкой, — если функция odbc_exec вернула + завершился ошибкой, — если функция odbc_exec вернула значение &false;. diff --git a/reference/var/functions/is-bool.xml b/reference/var/functions/is-bool.xml index 475dd3f09..27fa7a765 100644 --- a/reference/var/functions/is-bool.xml +++ b/reference/var/functions/is-bool.xml @@ -57,7 +57,7 @@ if (is_bool($a) === true) { echo "Да, это логическая переменная"; } -// Поскольку переменная $b — не логическая переменная, функция вернёт false +// Поскольку переменная $b — не логическая переменная, функция вернёт false if (is_bool($b) === false) { echo "Нет, это не логическая переменная"; } diff --git a/reference/var/functions/is-numeric.xml b/reference/var/functions/is-numeric.xml index c927ef20d..e43a46b2d 100644 --- a/reference/var/functions/is-numeric.xml +++ b/reference/var/functions/is-numeric.xml @@ -101,9 +101,9 @@ $tests = array( foreach ($tests as $element) { if (is_numeric($element)) { - echo var_export($element, true) . " — число", PHP_EOL; + echo var_export($element, true) . " — число", PHP_EOL; } else { - echo var_export($element, true) . " — НЕ число", PHP_EOL; + echo var_export($element, true) . " — НЕ число", PHP_EOL; } } @@ -113,22 +113,22 @@ foreach ($tests as $element) { &example.outputs; @@ -164,8 +164,8 @@ foreach ($tests as $element) { &example.outputs.7; diff --git a/reference/var/functions/is-scalar.xml b/reference/var/functions/is-scalar.xml index 83409f30e..dcaca2548 100644 --- a/reference/var/functions/is-scalar.xml +++ b/reference/var/functions/is-scalar.xml @@ -27,7 +27,7 @@ Функция is_scalar не считает ресурсы (resource) скалярными значениями, поскольку ресурсы — это абстрактные типы данных, которые пока основаны на целых числах (&integer;). Полагаться на эту деталь не нужно, - поскольку не исключено, что в будущем функция будет рассматривать ресурсы по-другому. + поскольку не исключено, что в будущем функция будет рассматривать ресурсы по-другому. diff --git a/reference/win32service/rightinfo/get-rights.xml b/reference/win32service/rightinfo/get-rights.xml index eb4e5da2b..4ef364452 100644 --- a/reference/win32service/rightinfo/get-rights.xml +++ b/reference/win32service/rightinfo/get-rights.xml @@ -30,10 +30,10 @@ Метод возвращает список прав пользователя. - Индекс массива — двоичная маска прав из констант прав доступа. + Индекс массива — двоичная маска прав из констант прав доступа. - Значение — строка с именем константы ОС Windows без префикса WIN32_. + Значение — строка с именем константы ОС Windows без префикса WIN32_. diff --git a/reference/xml/case-folding.xml b/reference/xml/case-folding.xml index 7e9c59329..9714a915a 100644 --- a/reference/xml/case-folding.xml +++ b/reference/xml/case-folding.xml @@ -16,7 +16,7 @@ Регистр имён элементов, которые передают функциям-обработчикам, по умолчанию выравнивается. Такое поведение для каждого отдельного XML-парсера запрашивают функцией xml_parser_get_option, - а управляют — функцией xml_parser_set_option. + а управляют — функцией xml_parser_set_option.