From 36b8f6b09b08f53e6d3dfebdcba865437d961652 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Tue, 5 Jan 2021 21:19:26 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=B8=D0=B5=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA?= =?UTF-8?q?=D0=B8=20EditorConfig=20=D0=B2=20CI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes GH-10 --- .editorconfig | 2 +- .github/workflows/editorconfig.yml | 22 ++++++ .gitignore | 2 +- language-snippets.ent | 120 ++++++++++++++--------------- 4 files changed, 84 insertions(+), 62 deletions(-) create mode 100644 .github/workflows/editorconfig.yml diff --git a/.editorconfig b/.editorconfig index 9eb2dc3f1..1af1f08b2 100644 --- a/.editorconfig +++ b/.editorconfig @@ -11,5 +11,5 @@ indent_size = 2 insert_final_newline = true trim_trailing_whitespace = true -[*.xml] +[*.{xml,ent}] indent_size = 1 diff --git a/.github/workflows/editorconfig.yml b/.github/workflows/editorconfig.yml new file mode 100644 index 000000000..b6a513b1e --- /dev/null +++ b/.github/workflows/editorconfig.yml @@ -0,0 +1,22 @@ +name: Check EditorConfig + +on: + push: + branches: + - master + pull_request: + branches: + - master + +jobs: + lint: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Get changed files + id: get_file_changes + uses: trilom/file-changes-action@v1.2.3 + with: + output: ' ' + - name: Run editorconfig-checker + run: npx editorconfig-checker ${{ steps.get_file_changes.outputs.files }} diff --git a/.gitignore b/.gitignore index 723ef36f4..485dee64b 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1 @@ -.idea \ No newline at end of file +.idea diff --git a/language-snippets.ent b/language-snippets.ent index 4049c6405..d09265220 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -252,7 +252,7 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была '> -При использовании SSL, Microsoft IIS нарушает протокол, закрывая соединение без отправки индикатора close_notify. PHP сообщит об этом как "SSL: Fatal Protocol Error" в тот момент, когда вы достигнете конца данных. Чтобы обойти это, вы должны установить error_reporting на уровень, исключающий E_WARNING. PHP умеет определять, что на стороне сервера находится проблемный IIS при открытии потока с помощью обёртки https:// и не выводит предупреждение. Если вы используете fsockopen для создания ssl:// сокета, вы сами отвечаете за определение и подавление этого предупреждения.'> +При использовании SSL, Microsoft IIS нарушает протокол, закрывая соединение без отправки индикатора close_notify. PHP сообщит об этом как "SSL: Fatal Protocol Error" в тот момент, когда вы достигнете конца данных. Чтобы обойти это, вы должны установить error_reporting на уровень, исключающий E_WARNING. PHP умеет определять, что на стороне сервера находится проблемный IIS при открытии потока с помощью обёртки https:// и не выводит предупреждение. Если вы используете fsockopen для создания ssl:// сокета, вы сами отвечаете за определение и подавление этого предупреждения.'> @@ -306,7 +306,7 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была - Эта функция объявлена УСТАРЕВШЕЙ в PHP 7.1.0 и + Эта функция объявлена УСТАРЕВШЕЙ в PHP 7.1.0 и УДАЛЕНА в PHP 7.2.0. @@ -375,7 +375,7 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была flags - Необязательный второй параметр flags + Необязательный второй параметр flags может использоваться для изменения поведения сортировки с использованием следующих значений: @@ -393,20 +393,20 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была - SORT_LOCALE_STRING - сравнение элементов как - строки на основе текущего языкового стандарта. Используется языковой стандарт, + SORT_LOCALE_STRING - сравнение элементов как + строки на основе текущего языкового стандарта. Используется языковой стандарт, который можно изменить с помощью setlocale - SORT_NATURAL - сравнение элементов как строки, + SORT_NATURAL - сравнение элементов как строки, используя "естественный порядок", например natsort - SORT_FLAG_CASE - можно объединять + SORT_FLAG_CASE - можно объединять (побитовое ИЛИ) с SORT_STRING или SORT_NATURAL для сортировки строк без учёта регистра @@ -527,12 +527,12 @@ font_indexРесурс шрифта, возв В зависимости от того, какая библиотека GD используется в PHP, если fontfile не начинается с символа - /, то к имени файла будет добавлено + /, то к имени файла будет добавлено .ttf и библиотека будет пытаться искать это имя файла по определённому библиотекой пути шрифтов. - При использовании библиотеки GD версии ниже 2.0.18, в качестве + При использовании библиотеки GD версии ниже 2.0.18, в качестве разделителя путей для разных файлов шрифтов используется пробел, а не точка с запятой. Непреднамеренное использование этой особенности приведёт к предупреждению: @@ -541,7 +541,7 @@ font_indexРесурс шрифта, возв директорию не содержащую пробелов. - Во многих случаях, когда шрифт находится в том же каталоге, что и + Во многих случаях, когда шрифт находится в том же каталоге, что и скрипт PHP, поможет следующий трюк. - Обратите внимание, что open_basedir + Обратите внимание, что open_basedir не применяется к fontfile. @@ -669,7 +669,7 @@ dbm_identifierИдентификатор со 8.0.0 - handle теперь ожидает экземпляр CurlHandle; + handle теперь ожидает экземпляр CurlHandle; раньше, ожидался ресурс (resource). '> @@ -677,7 +677,7 @@ dbm_identifierИдентификатор со 8.0.0 - multi_handle теперь ожидает экземпляр; + multi_handle теперь ожидает экземпляр; раньше, ожидался ресурс (resource). '> @@ -713,7 +713,7 @@ dbm_identifierИдентификатор со - До dbase 7.0.0, логические значение (L) преобразуются в + До dbase 7.0.0, логические значение (L) преобразуются в 1 или 0. @@ -795,9 +795,9 @@ imapПоток IMAP, полученный и - Функция была объявлена УСТАРЕВШЕЙ в PHP 7.4.0 + Функция была объявлена УСТАРЕВШЕЙ в PHP 7.4.0 и УДАЛЕНА в PHP 8.0.0. - Вместо неё следует использовать параметр controls в + Вместо неё следует использовать параметр controls в ldap_search. Смотрите также Управляющие объекты LDAP для получения дополнительной информации. @@ -815,7 +815,7 @@ imapПоток IMAP, полученный и Для этой функции будет использована внутренняя кодировка или кодировка, установленная функцией mb_regex_encoding.'> -Кодировка символов, указанная функцией mb_regex_encoding, +Кодировка символов, указанная функцией mb_regex_encoding, будет по умолчанию использована для данной функции.'> Параметр encoding @@ -913,7 +913,7 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время Etc/GMT+n и Etc/GMT-n обратные общепринятым. - Например, временная зона на 8 часов вперёд от GMT, используемая в Китае, + Например, временная зона на 8 часов вперёд от GMT, используемая в Китае, Западной Австралии и других местах, в действительности записана в базе данных как Etc/GMT-8, а не как Etc/GMT+8, который вы могли ожидать. @@ -1058,7 +1058,7 @@ objectТолько для процедурн В этом режиме типы boolean, null и integer будут, по возможности, сохраняться. Строковые значения "true", "on" и "yes" будут преобразованы в &true;. "false", "off", "no" -и "none" в &false;. "null" преобразуется в &null;. +и "none" в &false;. "null" преобразуется в &null;. Кроме этого, все числовые строки будут, по возможности, преобразованы к целым числам. '> @@ -1080,7 +1080,7 @@ objectТолько для процедурн % соответствующий нулю или более символам, +% соответствующий нулю или более символам, и _ соответствующий ровно одному символу.'> @@ -1109,7 +1109,7 @@ objectТолько для процедурн 10g или старше. Easy Connect string для Oracle 10g принимает следующую форму: [//]host_name[:port][/service_name]. Начиная с Oracle 11g синтаксис таков: [//]host_name[:port][/service_name][:server_type][/instance_name]. - В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности. + В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности. Обратитесь к документации Oracle. Названия служб могут быть определены с помощью запуска Oracle утилиты lsnrctl status на сервере базы данных. @@ -1443,32 +1443,32 @@ field_offsetЧисловое смещение Данное расширение устарело, начиная с версии PHP 5.5.0, и удалено в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. -Смотрите также инструкцию MySQL: -выбор API и соответствующий FAQ для получения более подробной информации. +Смотрите также инструкцию MySQL: +выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:'> Данная функция объявлена устаревшей в PHP 4.3.0, и, вместе с расширением MySQL, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения MySQLi или PDO_MySQL. Так же смотрите раздел MySQL: выбор API и -это FAQ. +это FAQ. Альтернативы для этой функции:'> Данная функция объявлена устаревшей в PHP 5.3.0, и, вместе с расширением MySQL, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения MySQLi или PDO_MySQL. Так же смотрите раздел MySQL: выбор API и -это FAQ. +это FAQ. Альтернативы для этой функции:'> Данная функция объявлена устаревшей в PHP 5.4.0, и, вместе с расширением MySQL, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения MySQLi или PDO_MySQL. Так же смотрите раздел MySQL: выбор API и -это FAQ. +это FAQ. Альтернативы для этой функции:'> Данная функция объявлена устаревшей в PHP 5.5.0, и, вместе с расширением MySQL, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения MySQLi или PDO_MySQL. Так же смотрите раздел MySQL: выбор API и -это FAQ. +это FAQ. Альтернативы для этой функции:'> @@ -1752,8 +1752,8 @@ writerТолько для процедурн Phar::addFile, Phar::addFromString и Phar::offsetSet - сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство, - вместо этого следует использовать Phar::buildFromDirectory + сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство, + вместо этого следует использовать Phar::buildFromDirectory или Phar::buildFromIterator. '> @@ -2047,7 +2047,7 @@ xmlns="http://docbook.org/ns/docbook">Возвращает _id сохранённого документа. Это будет сгенерированный MongoId, за исключением случая, когда _id был явно указан в параметре metadata.'> Массив опций записи.ключзначениеw (int|string)Значения контроля записиwtimeout (int)Максимальное время ожидания репликацииorderedОпределяет, должна ли MongoDB применять этот пакет в определённом по порядку. Упорядоченная запись запускается последовательно (по одному элементу за раз) и запись прекращается после первой же ошибки. Неупорядоченная запись может запускаться параллельно и ошибки не приводят к остановке записи. По умолчанию &true;j (bool)Ожидать журналирование на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)fsync (bool)Ожидать fsync на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)'> Объект MongoCollection для выполняемого пакета. Его опции контроля записи будут скопированы и использованы по умолчанию, если не будут переданы через $write_options или MongoWriteBatch::execute.'> - server Массив, содержащий основную информацию о выбранном сервере. ключ значение hash хеш сервера, например: localhost:27017;-;X;56052 type Тип узла (primary/secondary/mongos/arbiter): 2 max_bson_size максимальный размер BSON, который этот узел поддерживает: 16777216 max_message_size Максимальный размер сообщения, который этот узел поддерживает: 48000000 request_id Идентификатор запроса для этого сообщения: 42 '> + server Массив, содержащий основную информацию о выбранном сервере. ключ значение hash хеш сервера, например: localhost:27017;-;X;56052 type Тип узла (primary/secondary/mongos/arbiter): 2 max_bson_size максимальный размер BSON, который этот узел поддерживает: 16777216 max_message_size Максимальный размер сообщения, который этот узел поддерживает: 48000000 request_id Идентификатор запроса для этого сообщения: 42 '> writeOptions key value ordered булево, если операция (в случае пакетных операций) должна выполняться последовательно (ordered=true) writeConcern Массив опций контроля записи (writeConcern, смотри ниже) значения массива writeConcern ключ значение fsync булево, сбрасывать на диск перед запуском j булево, записывать в журнал перед запуском wtimeout целое число, миллисекунды, максимальное время, которое основной сервер (primary) ждёт подтверждение репликации w integer=число серверов, или string=тэг-репликации
'> protocolOptions key value message_length Общий размер в байтах закодированного сообщения, отправляемого по сети request_id Идентификатор для сообщения: 42 namespace Пространство имён MongoDB , используемого для сообщений протокола dbname.collectionname '> Расширение, задающее э Никакой замены данному классу не предусмотрено.'> Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение MongoDB. -Есть такие альтернативы:'> +Есть такие альтернативы:'> Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение MongoDB. Никакой замены данному методу не предусмотрено.'> @@ -2140,11 +2140,11 @@ local: { integer - Максимальный период времени в миллисекундах, в течение которого может + Максимальный период времени в миллисекундах, в течение которого может выполняться одна команда commitTransaction. - Если указано, maxCommitTimeMS должно быть 32-разрядным + Если указано, maxCommitTimeMS должно быть 32-разрядным целым числом со знаком, большим или равным нулю. @@ -2325,7 +2325,7 @@ local: { На Unix, драйвер MongoDB чувствителен к сценариям, которые используют системный вызов fork() без последующего exec(). Пользователям рекомендуется - не переиспользовать экземпляр MongoDB\Driver\Manager + не переиспользовать экземпляр MongoDB\Driver\Manager в дочернем процессе. child process. @@ -2346,8 +2346,8 @@ local: { Опция "readPreference" не контролирует сервер, к которому драйвер выполняет операцию; она всегда будет выполняться на этом объекте сервера. Вместо этого, он может быть использован при выполнении операции на втором узле - (из набора реплик, не автономный) или на узле mongos для обеспечения того, что драйвер - устанавливает проводной протокол соответствующим образом или добавляет предпочтение чтения + (из набора реплик, не автономный) или на узле mongos для обеспечения того, что драйвер + устанавливает проводной протокол соответствующим образом или добавляет предпочтение чтения к операции, соответственно. @@ -2390,8 +2390,8 @@ local: { С каждым ресурсом ассоциированы свои мягкие и жёсткие ограничения. Мягкие ограничения - это величина, которую ядро обещает обеспечить - ресурсу. Жёсткие ограничения - это величина, характеризующая потолок - мягких ресурсов. Непривилегированный процесс может управлять только своими + ресурсу. Жёсткие ограничения - это величина, характеризующая потолок + мягких ресурсов. Непривилегированный процесс может управлять только своими мягкими ограничениями, выставляя их от 0 до величины жёсткого ограничения. '> @@ -2421,24 +2421,24 @@ local: { Строка формата состоит из нуля или более директив: обычные символы (за исключением %), которые - просто выводятся без изменения и + просто выводятся без изменения и спецификаторы преобразования, каждый из которых требует передачи своего параметра. - + Спецификаторы преобразования имеют следующий формат: %[argnum$][flags][width][.precision]specifier. - + Argnum - Целое число, за которым следует знак доллара $, + Целое число, за которым следует знак доллара $, чтобы указать, какой числовой аргумент обрабатывать при преобразовании. - + Флаги @@ -2460,7 +2460,7 @@ local: { + - Печатает плюс + у не отрицательных чисел; + Печатает плюс + у не отрицательных чисел; По умолчанию знак печатается только у отрицательных чисел. @@ -2489,7 +2489,7 @@ local: {
- + Ширина @@ -2497,7 +2497,7 @@ local: { символов, которое будет напечатано. - + Точность @@ -2508,7 +2508,7 @@ local: { Для спецификаторов e, E, f и F: - задаёт количество цифр после десятичной запятой (по умолчанию 6). + задаёт количество цифр после десятичной запятой (по умолчанию 6). @@ -2532,14 +2532,14 @@ local: { - + Попытка использовать спецификатор позиции со значением больше, чем PHP_INT_MAX приведёт к выводу предупреждения. - + Спецификаторы @@ -2574,7 +2574,7 @@ local: { d - Аргумент рассматривается как целое число и печатается + Аргумент рассматривается как целое число и печатается как целое число со знаком. @@ -2582,7 +2582,7 @@ local: { e Аргумент считается за число в научной нотации (т.е. 1.2e+2). - Начиная с PHP 5.2.1, спецификатор точности задаёт количество + Начиная с PHP 5.2.1, спецификатор точности задаёт количество цифр после десятичной запятой. В более ранних версиях он задавал общее количество значащих цифр (т.е. после запятой выводилось на 1 символ меньше). @@ -2653,7 +2653,7 @@ local: { o - Аргумент рассматривается как целое число и печатается + Аргумент рассматривается как целое число и печатается в восьмеричном представлении. @@ -2666,21 +2666,21 @@ local: { u - Аргумент рассматривается как целое число и печатается + Аргумент рассматривается как целое число и печатается как беззнаковое целое число. x - Аргумент рассматривается как целое число и печатается в + Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в нижнем регистре). X - Аргумент рассматривается как целое число и печатается в + Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в верхнем регистре). @@ -2688,20 +2688,20 @@ local: {
- + Спецификатор c игнорирует значения ширины и дополнения - + Попытка использовать спецификаторы с указанием ширины для строки в многобайтовой кодировке может привести к неожиданным результатам. - + Переменные будут приведены к подходящему для спецификатора типу: @@ -2864,13 +2864,13 @@ xmlns="http://docbook.org/ns/docbook">Эта функция была Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров. По умолчанию используется OpenSSL CA пакет для проверки сертификата - пира. В большинстве случаев не требуется ничего делать для + пира. В большинстве случаев не требуется ничего делать для соединения с серверами с правильным SSL сертификатом, так как обычно OpenSSL уже настроен для использования хороших CA пакетов. - Стандартный CA пакет может быть переопределён глобально с помощью + Стандартный CA пакет может быть переопределён глобально с помощью установки или openssl.cafile или openssl.capath строк конфигурации, или же на уровне каждого запроса используя опции контекста cafile или