diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 2a7d399de..09326decb 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -1,5 +1,5 @@ - + Изменения, ломающие обратную совместимость @@ -787,15 +787,34 @@ $array["key"]; - DOMNameList - DomImplementationList - DOMConfiguration - DomError - DomErrorHandler - DOMImplementationSource - DOMLocator - DOMUserDataHandler - DOMTypeInfo + DOMNameList + DomImplementationList + DOMConfiguration + DomError + DomErrorHandler + DOMImplementationSource + DOMLocator + DOMUserDataHandler + DOMTypeInfo + DOMStringExtend + + + + Удалены нереализованные методы модуля DOM, у которых не было реализации: + + + + DOMNamedNodeMap::setNamedItem + DOMNamedNodeMap::removeNamedItem + DOMNamedNodeMap::setNamedItemNS + DOMNamedNodeMap::removeNamedItem + DOMText::replaceWholeText + DOMNode::compareDocumentPosition + DOMNode::isEqualNode + DOMNode::getFeature + DOMNode::setUserData + DOMNode::getUserData + DOMDocument::renameNode diff --git a/language/enumerations.xml b/language/enumerations.xml index dad060d86..d42203c02 100644 --- a/language/enumerations.xml +++ b/language/enumerations.xml @@ -1,5 +1,5 @@ - + Перечисления @@ -74,20 +74,24 @@ pick_a_card(Suit::Clubs); pick_a_card('Spades'); ?> ]]> - + - - Перечисление может иметь ноль или более вариантов case без ограничений. - Перечисление без вариантов синтаксически корректно, хотя и бесполезно. - + + Перечисление может иметь ноль или более вариантов case без ограничений. + Перечисление без вариантов синтаксически корректно, хотя и бесполезно. + - - По умолчанию варианты не поддерживаются скалярным значением. То есть Suit::Hearts - не равно "0". Вместо этого каждый вариант поддерживается одноэлементным объектом с таким именем. - Это означает, что: - + + Для вариантов перечисления применяются те же правила синтаксиса, что и для любой метки в PHP, смотрите Константы. + - + + По умолчанию варианты не поддерживаются скалярным значением. То есть Suit::Hearts + не равно "0". Вместо этого каждый вариант поддерживается одноэлементным объектом с таким именем. + Это означает, что: + + + ]]> - + - - Это также означает, что значения перечисления никогда не являются < или > - друг с другом, поскольку эти сравнения не имеют смысла для объектов. - Сравнения всегда будут возвращать false при работе с вариантами перечисления. - + + Это также означает, что значения перечисления никогда не являются < или > + друг с другом, поскольку эти сравнения не имеют смысла для объектов. + Сравнения всегда будут возвращать false при работе с вариантами перечисления. + - - Тип варианта без связанных данных называется "Чистый вариант". Перечисление, которое содержит только чистые варианты, - называется чистым перечислением. - + + Тип варианта без связанных данных называется "Чистый вариант". Перечисление, которое содержит только чистые варианты, + называется чистым перечислением. + - - Все чистые варианты реализованы как экземпляры своего типа перечисления. - Тип перечисления внутренне представлен как класс. - + + Все чистые варианты реализованы как экземпляры своего типа перечисления. + Тип перечисления внутренне представлен как класс. + - - У всех обращений есть свойство, доступное только для чтения, name, - которое является именем самого варианта, чувствительным к регистру. Иногда это может быть полезно для отладки. - + + У всех обращений есть свойство, доступное только для чтения, name, + которое является именем самого варианта, чувствительным к регистру. Иногда это может быть полезно для отладки. + - + name; // prints "Spades" ?> ]]> - + - + - - Типизированные перечисления + + Типизированные перечисления - - По умолчанию у вариантов перечислений нет скалярного эквивалента. Это просто одноэлементные объекты. - Однако существует множество случаев, когда варианты перечислений должны иметь возможность обращаться к базе данных - или аналогичному хранилищу данных и обратно, поэтому полезно иметь встроенный скалярный - (и, следовательно, тривиально сериализуемый) эквивалент, определённый внутренне. - + + По умолчанию у вариантов перечислений нет скалярного эквивалента. Это просто одноэлементные объекты. + Однако существует множество случаев, когда варианты перечислений должны иметь возможность обращаться к базе данных + или аналогичному хранилищу данных и обратно, поэтому полезно иметь встроенный скалярный + (и, следовательно, тривиально сериализуемый) эквивалент, определённый внутренне. + - Чтобы определить скалярный эквивалент для перечислений, используйте следующий синтаксис: + Чтобы определить скалярный эквивалент для перечислений, используйте следующий синтаксис: - + ]]> - + - - Вариант, имеющий скалярный эквивалент, называется типизированным, поскольку он "поддерживается" более простым значением. - Перечисление, у которого все варианты типизированные, называется "типизированным перечислением". - Типизированное перечисление может содержать только типизированные варианты. - Чистое перечисление может содержать только чистые варианты. - + + Вариант, имеющий скалярный эквивалент, называется типизированным, поскольку он "поддерживается" более простым значением. + Перечисление, у которого все варианты типизированные, называется "типизированным перечислением". + Типизированное перечисление может содержать только типизированные варианты. + Чистое перечисление может содержать только чистые варианты. + - - Типизированное перечисление может поддерживаться типами int или string - и данное перечисление поддерживает только один тип за раз (то есть не допускается объединение int|string). - Если перечисление помечено как имеющее скалярный эквивалент, тогда все варианты должны иметь определённый явно уникальный скалярный эквивалент. - Не существует автоматически генерируемых скалярных эквивалентов (например, последовательных целых чисел). - Типизированные варианты должны быть уникальными; два варианта типизированных перечисления не могут иметь одного и того же скалярного эквивалента. - Однако константа может относиться к варианту, фактически создавая псевдоним. - Смотрите Константы перечислений. - + + Типизированное перечисление может поддерживаться типами int или string + и данное перечисление поддерживает только один тип за раз (то есть не допускается объединение int|string). + Если перечисление помечено как имеющее скалярный эквивалент, тогда все варианты должны иметь определённый явно уникальный скалярный эквивалент. + Не существует автоматически генерируемых скалярных эквивалентов (например, последовательных целых чисел). + Типизированные варианты должны быть уникальными; два варианта типизированных перечисления не могут иметь одного и того же скалярного эквивалента. + Однако константа может относиться к варианту, фактически создавая псевдоним. + Смотрите Константы перечислений. + - - Эквивалентные значения должны быть строками или строковыми выражениями. - Константы и постоянные выражения не поддерживаются. То есть 1 + 1 разрешено, - а 1 + SOME_CONST - нет. - + + Эквивалентные значения должны быть строками или строковыми выражениями. + Константы и постоянные выражения не поддерживаются. То есть 1 + 1 разрешено, + а 1 + SOME_CONST - нет. + - - У типизированных вариантов есть дополнительное свойство, доступное только для чтения, value, - которое является значением, указанным в определении. - + + У типизированных вариантов есть дополнительное свойство, доступное только для чтения, value, + которое является значением, указанным в определении. + - + value; // Выведет "C" ?> ]]> - + - - Чтобы сделать свойство value доступным только для чтения, нельзя назначить переменную в качестве ссылки на неё. - То есть следующий код выдаст ошибку: - + + Чтобы сделать свойство value доступным только для чтения, нельзя назначить переменную в качестве ссылки на неё. + То есть следующий код выдаст ошибку: + - + value; // Error: Cannot acquire reference to property Suit::$value ?> ]]> - + - - Типизированные перечисления реализуют внутренний интерфейс BackedEnum, - который предоставляет два дополнительных метода: - + + Типизированные перечисления реализуют внутренний интерфейс BackedEnum, + который предоставляет два дополнительных метода: + - - - from(int|string): self возьмёт скаляр и вернёт соответствующий вариант перечисления. - Если вариант не найден, метод выдаст ValueError. - Это полезно в тех случаях, когда входной скаляр является доверенным, - а отсутствие значения перечисления следует рассматривать как ошибку остановки приложения. - - - tryFrom(int|string): ?self возьмёт скаляр и вернёт соответствующий вариант перечисления. - Если вариант не найден, метод вернёт null. - Это полезно в тех случаях, когда входной скаляр не является доверенным и вызывающая функция - хочет реализовать свою собственную обработку ошибок или логику значения по умолчанию. - - + + + from(int|string): self возьмёт скаляр и вернёт соответствующий вариант перечисления. + Если вариант не найден, метод выдаст ValueError. + Это полезно в тех случаях, когда входной скаляр является доверенным, + а отсутствие значения перечисления следует рассматривать как ошибку остановки приложения. + + + tryFrom(int|string): ?self возьмёт скаляр и вернёт соответствующий вариант перечисления. + Если вариант не найден, метод вернёт null. + Это полезно в тех случаях, когда входной скаляр не является доверенным и вызывающая функция + хочет реализовать свою собственную обработку ошибок или логику значения по умолчанию. + + - - Методы from() и tryFrom() следуют стандартным правилам - слабой/строгой типизации. В режиме слабой типизации допустима передача целого числа или строки - и система соответствующим образом преобразует значение. - Передача числа с плавающей точкой также будет работать с принудительным преобразованием. - В режиме строгой типизации передача целого числа в from() в перечислении - со строковой типизацией (или наоборот) приведёт к TypeError, - как и передача числа с плавающей точкой при любых обстоятельствах. - Все остальные типы параметров вызовут ошибку TypeError в обоих режимах. - + + Методы from() и tryFrom() следуют стандартным правилам + слабой/строгой типизации. В режиме слабой типизации допустима передача целого числа или строки + и система соответствующим образом преобразует значение. + Передача числа с плавающей точкой также будет работать с принудительным преобразованием. + В режиме строгой типизации передача целого числа в from() в перечислении + со строковой типизацией (или наоборот) приведёт к TypeError, + как и передача числа с плавающей точкой при любых обстоятельствах. + Все остальные типы параметров вызовут ошибку TypeError в обоих режимах. + - + value; ?> ]]> - - - - Ручное определение метода from() или tryFrom() в типизированных перечислениях - приведёт к фатальной ошибке. - - - - - Методы перечислений + - Перечисления (как чистые перечисления, так и типизированные перечисления) могут содержать методы и могут реализовывать интерфейсы. - Если перечисление реализует интерфейс, то любая проверка типа для этого интерфейса также будет принимать все варианты этого перечисления. + Ручное определение метода from() или tryFrom() в типизированных перечислениях + приведёт к фатальной ошибке. + - + + Методы перечислений + + + Перечисления (как чистые перечисления, так и типизированные перечисления) могут содержать методы и могут реализовывать интерфейсы. + Если перечисление реализует интерфейс, то любая проверка типа для этого интерфейса также будет принимать все варианты этого перечисления. + + + shape(); // выведет "Rectangle" ?> ]]> - + - - В этом примере у всех четырёх экземпляров Suit есть два метода: - color() и shape(). - Что касается вызывающего кода и проверки типов, они ведут себя точно так же, как и любой другой экземпляр объекта. - + + В этом примере у всех четырёх экземпляров Suit есть два метода: + color() и shape(). + Что касается вызывающего кода и проверки типов, они ведут себя точно так же, как и любой другой экземпляр объекта. + - - В типизированных перечислениях объявление интерфейса идёт после объявления типа. - + + В типизированных перечислениях объявление интерфейса идёт после объявления типа. + - + ]]> - + - - Внутри метода определяется переменная $this, которая ссылается на экземпляр варианта. - + + Внутри метода определяется переменная $this, которая ссылается на экземпляр варианта. + - - Методы могут быть сколь угодно сложными, но на практике обычно возвращают статическое значение - или match для $this, - чтобы предоставить разные результаты для разных случаев. - + + Методы могут быть сколь угодно сложными, но на практике обычно возвращают статическое значение + или match для $this, + чтобы предоставить разные результаты для разных случаев. + - - Обратите внимание, что в этом случае было бы лучше также определить тип перечисления SuitColor - со значениями Red и Black и вернуть его вместо этого. - Однако это усложнило бы этот пример. - + + Обратите внимание, что в этом случае было бы лучше также определить тип перечисления SuitColor + со значениями Red и Black и вернуть его вместо этого. + Однако это усложнило бы этот пример. + - - Вышеупомянутая иерархия логически похожа на следующую структуру классов - (хотя это не фактический исполняемый код): - + + Вышеупомянутая иерархия логически похожа на следующую структуру классов + (хотя это не фактический исполняемый код): + - + ]]> - - - - Методы могут быть общедоступными, закрытыми или защищёнными, хотя на практике закрытые и защищённые эквивалентны, - поскольку наследование не допускается. - - - - - - Статические методы перечислений + - Перечисления также могут иметь статические методы. Использование статических методов в самом перечислении - в первую очередь предназначено для альтернативных конструкторов. Например: + Методы могут быть общедоступными, закрытыми или защищёнными, хотя на практике закрытые и защищённые эквивалентны, + поскольку наследование не допускается. - + + + + Статические методы перечислений + + + Перечисления также могут иметь статические методы. Использование статических методов в самом перечислении + в первую очередь предназначено для альтернативных конструкторов. Например: + + + ]]> - + - - Статические методы могут быть общедоступными, закрытыми или защищёнными, - хотя на практике частные и защищённые эквивалентны, поскольку наследование не допускается. - + + Статические методы могут быть общедоступными, закрытыми или защищёнными, + хотя на практике частные и защищённые эквивалентны, поскольку наследование не допускается. + - + - - Константы перечислений + + Константы перечислений - - Перечисления могут содержать константы, которые могут быть общедоступными, - закрытыми или защищёнными, хотя на практике закрытые и защищённые эквивалентны, - поскольку наследование не допускается. - + + Перечисления могут содержать константы, которые могут быть общедоступными, + закрытыми или защищёнными, хотя на практике закрытые и защищённые эквивалентны, + поскольку наследование не допускается. + - Константа перечисления может относиться к варианту перечисления: + Константа перечисления может относиться к варианту перечисления: - + ]]> - - + + - - Трейты + + Трейты - - Перечисления могут использовать трейты, которые будут вести себя так же, как и классы. - Предостережение заключается в том, что трейты, используемые (use) - в перечислении не должны содержать свойств. - Они могут включать только методы и статические методы. Трейт со свойствами приведёт к фатальной ошибке. - + + Перечисления могут использовать трейты, которые будут вести себя так же, как и классы. + Предостережение заключается в том, что трейты, используемые (use) + в перечислении не должны содержать свойств. + Они могут включать только методы и статические методы. Трейт со свойствами приведёт к фатальной ошибке. + - + ]]> - - + + - - Значения перечисления в постоянных выражениях + + Значения перечисления в постоянных выражениях - - Поскольку варианты представлены как константы в самом перечислении, - они могут использоваться как статические значения в большинстве константных выражений: - значения по умолчанию для свойств, значения по умолчанию для статических переменных, значения по умолчанию для параметров, - глобальные значения и значения констант класса. - Они не могут использоваться в других значениях варианта перечисления, но обычные константы могут относиться к варианту перечисления. - + + Поскольку варианты представлены как константы в самом перечислении, + они могут использоваться как статические значения в большинстве константных выражений: + значения по умолчанию для свойств, значения по умолчанию для статических переменных, значения по умолчанию для параметров, + глобальные значения и значения констант класса. + Они не могут использоваться в других значениях варианта перечисления, но обычные константы могут относиться к варианту перечисления. + - - Однако неявные вызовы магических методов, таких как ArrayAccess в перечислениях, - не допускаются в статических или константных определениях, поскольку мы не можем абсолютно гарантировать, - что результирующее значение будет детерминированным или что вызов метода не будет иметь побочных эффектов. - Вызовы функций, вызовы методов и доступ к свойствам по-прежнему являются недопустимыми операциями в постоянных выражениях. - + + Однако неявные вызовы магических методов, таких как ArrayAccess в перечислениях, + не допускаются в статических или константных определениях, поскольку мы не можем абсолютно гарантировать, + что результирующее значение будет детерминированным или что вызов метода не будет иметь побочных эффектов. + Вызовы функций, вызовы методов и доступ к свойствам по-прежнему являются недопустимыми операциями в постоянных выражениях. + - + ]]> - - + + - - Отличия от объектов + + Отличия от объектов - - Хотя перечисления построены на классах и объектах, они не поддерживают все функциональные возможности, связанные с объектами. - В частности, вариантам перечислений запрещено иметь состояние. - + + Хотя перечисления построены на классах и объектах, они не поддерживают все функциональные возможности, связанные с объектами. + В частности, вариантам перечислений запрещено иметь состояние. + - - Конструкторы и деструкторы запрещены. - Наследование не поддерживается. Перечисления не могут наследовать или наследоваться. - Статические свойства или свойства объекта не допускаются. - Клонирование варианта перечисления не поддерживается, так как варианты должны быть одноэлементными экземплярами. - Магические методы, кроме перечисленных ниже, запрещены. - + + Конструкторы и деструкторы запрещены. + Наследование не поддерживается. Перечисления не могут наследовать или наследоваться. + Статические свойства или свойства объекта не допускаются. + Клонирование варианта перечисления не поддерживается, так как варианты должны быть одноэлементными экземплярами. + Магические методы, кроме перечисленных ниже, запрещены. + - Доступны следующие функциональные возможности объекта, которые ведут себя так же, как и для любого другого объекта: + Доступны следующие функциональные возможности объекта, которые ведут себя так же, как и для любого другого объекта: - - Методы public, private и protected. - Статические методы public, private и protected. - Константы public, private и protected. - Перечисления могут реализовывать любое количество интерфейсов. - - К перечислениям и вариантам могут быть добавлены атрибуты. - Целевой фильтр TARGET_CLASS включает сами перечисления. - Целевой фильтр TARGET_CLASS_CONST включает варианты перечислений. - - - Магические методы __call, __callStatic, - и __invoke. - - Константы __CLASS__ и __FUNCTION__ ведут себя как обычно. - + + Методы public, private и protected. + Статические методы public, private и protected. + Константы public, private и protected. + Перечисления могут реализовывать любое количество интерфейсов. + + К перечислениям и вариантам могут быть добавлены атрибуты. + Целевой фильтр TARGET_CLASS включает сами перечисления. + Целевой фильтр TARGET_CLASS_CONST включает варианты перечислений. + + + Магические методы __call, __callStatic, + и __invoke. + + Константы __CLASS__ и __FUNCTION__ ведут себя как обычно. + - - Магическая константа ::class для типа перечисления оценивает имя типа, - включая любое пространство имён, точно так же, как объект. - Магическая константа ::class в экземпляре варианта также оценивается как тип перечисления, - поскольку она является экземпляром этого типа. - + + Магическая константа ::class для типа перечисления оценивает имя типа, + включая любое пространство имён, точно так же, как объект. + Магическая константа ::class в экземпляре варианта также оценивается как тип перечисления, + поскольку она является экземпляром этого типа. + - - Кроме того, варианты перечисления не могут быть созданы напрямую с помощью new или с помощью - ReflectionClass::newInstanceWithoutConstructor. Оба способа приведут к ошибке. - + + Кроме того, варианты перечисления не могут быть созданы напрямую с помощью new или с помощью + ReflectionClass::newInstanceWithoutConstructor. Оба способа приведут к ошибке. + - + newInstanceWithoutConstructor( // Error: Cannot instantiate enum Suit ?> ]]> - - + + - - Список значений + + Список значений - - И чистые перечисления, и типизированные перечисления реализуют внутренний интерфейс - с именем UnitEnum. - UnitEnum включает статический метод cases(). - cases() возвращает упакованный массив всех определённых вариантов в порядке объявления. - + + И чистые перечисления, и типизированные перечисления реализуют внутренний интерфейс + с именем UnitEnum. + UnitEnum включает статический метод cases(). + cases() возвращает упакованный массив всех определённых вариантов в порядке объявления. + - + ]]> - + - - Ручное определение метода cases() в перечислении приведёт к фатальной ошибке. - - + + Ручное определение метода cases() в перечислении приведёт к фатальной ошибке. + + - - Сериализация + + Сериализация - - Перечисления сериализуются иначе, чем объекты. В частности, у них есть новый код сериализации, - "E", который указывает имя варианта перечисления. - Затем процедура десериализации может использовать это для установки переменной в существующее одноэлементное значение. - Это гарантирует, что: - + + Перечисления сериализуются иначе, чем объекты. В частности, у них есть новый код сериализации, + "E", который указывает имя варианта перечисления. + Затем процедура десериализации может использовать это для установки переменной в существующее одноэлементное значение. + Это гарантирует, что: + - + ]]> - + - - При десериализации, если не удаётся найти перечисление и сопоставить с соответствующим сериализованном значением, - будет выдано предупреждение и будет возвращено false. - + + При десериализации, если не удаётся найти перечисление и сопоставить с соответствующим сериализованном значением, + будет выдано предупреждение и будет возвращено false. + - - Если чистое перечисление сериализуется в JSON, будет выдана ошибка. - Если типизированное перечисление сериализуется в JSON, оно будет представлено только его скаляром значений в соответствующем типе. - Поведение обоих способов может быть изменено путём реализации JsonSerializable. - + + Если чистое перечисление сериализуется в JSON, будет выдана ошибка. + Если типизированное перечисление сериализуется в JSON, оно будет представлено только его скаляром значений в соответствующем типе. + Поведение обоих способов может быть изменено путём реализации JsonSerializable. + - - Для print_r вывод варианта перечисления немного отличается от объектов, чтобы свести к минимуму путаницу. - + + Для print_r вывод варианта перечисления немного отличается от объектов, чтобы свести к минимуму путаницу. + - + ]]> - - + + - - &reftitle.examples; + + &reftitle.examples; - - - Основные ограниченные значения - + + + Основные ограниченные значения + ]]> - - - Функция query() теперь может безопасно работать, - зная, что $order гарантированно будет либо SortOrder::ASC, - либо SortOrder::DESC. - Любое другое значение привело бы к TypeError, - поэтому дальнейшая проверка ошибок или тестирование не требуется. - - - + + + Функция query() теперь может безопасно работать, + зная, что $order гарантированно будет либо SortOrder::ASC, + либо SortOrder::DESC. + Любое другое значение привело бы к TypeError, + поэтому дальнейшая проверка ошибок или тестирование не требуется. + + + - + - - Расширенные эксклюзивные значения + + Расширенные эксклюзивные значения - + ]]> - + - - В этом примере статус пользователя может быть одним из и следующих: - UserStatus::Pending, - UserStatus::Active, UserStatus::Suspended или - UserStatus::CanceledByUser. - Функция может ввести параметр UserStatus и затем принять только эти четыре значения, точка. - + + В этом примере статус пользователя может быть одним из и следующих: + UserStatus::Pending, + UserStatus::Active, UserStatus::Suspended или + UserStatus::CanceledByUser. + Функция может ввести параметр UserStatus и затем принять только эти четыре значения, точка. + - - У всех четырёх значений есть метод label(), который возвращает читаемою строку. - Эта строка не зависит от скалярной эквивалентной строки "machine name", которую можно использовать, - например, в поле базы данных или поле выбора HTML. - + + У всех четырёх значений есть метод label(), который возвращает читаемою строку. + Эта строка не зависит от скалярной эквивалентной строки "machine name", которую можно использовать, + например, в поле базы данных или поле выбора HTML. + - + ]]> - - - + + + - + + Класс DOMDocument @@ -365,6 +365,28 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Нереализованный метод DOMDocument::renameNode был удалён. + + + + + +
+
&reftitle.notes; diff --git a/reference/dom/domnamednodemap.xml b/reference/dom/domnamednodemap.xml index 313fadba1..926b675bc 100644 --- a/reference/dom/domnamednodemap.xml +++ b/reference/dom/domnamednodemap.xml @@ -1,29 +1,12 @@ - + - Класс DOMNamedNodeMap DOMNamedNodeMap - - - -
&reftitle.classsynopsis; @@ -47,7 +30,6 @@ Remove me once you perform substitutions &Properties; - public readonly @@ -81,18 +63,30 @@ Remove me once you perform substitutions
- - - diff --git a/reference/dom/domnode.xml b/reference/dom/domnode.xml index 1e4d9aa36..aebc08558 100644 --- a/reference/dom/domnode.xml +++ b/reference/dom/domnode.xml @@ -1,5 +1,5 @@ - + Класс DOMNode @@ -7,15 +7,6 @@ - -
&reftitle.classsynopsis; @@ -261,6 +252,32 @@
+
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Нереализованные методы DOMNode::compareDocumentPosition, + DOMNode::isEqualNode, + DOMNode::getFeature, + DOMNode::setUserData и + DOMNode::getUserData были удалены. + + + + + +
+
&reftitle.notes; diff --git a/reference/dom/domtext.xml b/reference/dom/domtext.xml index 04f71f718..8c75aac71 100644 --- a/reference/dom/domtext.xml +++ b/reference/dom/domtext.xml @@ -1,5 +1,5 @@ - + Класс DOMText @@ -88,18 +88,28 @@
- - - diff --git a/reference/filesystem/functions/chmod.xml b/reference/filesystem/functions/chmod.xml index 842a0c7c1..a634a1d50 100644 --- a/reference/filesystem/functions/chmod.xml +++ b/reference/filesystem/functions/chmod.xml @@ -1,5 +1,5 @@ - + @@ -103,6 +103,13 @@ chmod("/somedir/somefile", 0750); + + &reftitle.errors; + + В случае возникновения ошибки выдаётся ошибка уровня E_WARNING. + + + &reftitle.notes; @@ -129,7 +136,8 @@ chmod("/somedir/somefile", 0750); - + - Класс GMP @@ -27,20 +26,26 @@
- GMP + + GMP + GMP - - Serializable - + + &Methods; + + +
+ &reference.gmp.entities.gmp; + + - + Класс OCICollection OCICollection @@ -24,22 +24,24 @@
&reftitle.classsynopsis; - + - OCICollection + + OCICollection + - OCICollection - &Methods; - + + + - +
diff --git a/reference/oci8/OCI-Lob.xml b/reference/oci8/OCI-Lob.xml index 08889e350..e2c93be85 100644 --- a/reference/oci8/OCI-Lob.xml +++ b/reference/oci8/OCI-Lob.xml @@ -1,7 +1,7 @@ - + - + Класс OCILob OCILob @@ -24,22 +24,24 @@
&reftitle.classsynopsis; - + - OCILob + + OCILob + - OCILob - &Methods; - + + + - +
diff --git a/reference/oci8/OCI-Lob/close.xml b/reference/oci8/OCI-Lob/close.xml index 738cbb980..8ed9adf57 100644 --- a/reference/oci8/OCI-Lob/close.xml +++ b/reference/oci8/OCI-Lob/close.xml @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ &reftitle.description; - + public boolOCILob::close diff --git a/reference/oci8/OCI-Lob/writeTemporary.xml b/reference/oci8/OCI-Lob/writeTemporary.xml index cdbd5574a..9c781964e 100644 --- a/reference/oci8/OCI-Lob/writeTemporary.xml +++ b/reference/oci8/OCI-Lob/writeTemporary.xml @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ &reftitle.description; - + public boolOCILob::writeTemporary stringdata inttypeOCI_TEMP_CLOB diff --git a/reference/outcontrol/functions/ob-gzhandler.xml b/reference/outcontrol/functions/ob-gzhandler.xml index 3f8a3c7d5..30377f7df 100644 --- a/reference/outcontrol/functions/ob-gzhandler.xml +++ b/reference/outcontrol/functions/ob-gzhandler.xml @@ -1,7 +1,7 @@ - + - + ob_gzhandler callback-функция, используемая для gzip-сжатия буфера вывода при вызове ob_start @@ -10,9 +10,9 @@ &reftitle.description; - stringob_gzhandler - stringbuffer - intmode + stringfalseob_gzhandler + stringdata + intflags Функция ob_gzhandler предназначена для использования в @@ -33,14 +33,14 @@ - buffer + data - mode + flags diff --git a/reference/outcontrol/functions/ob-implicit-flush.xml b/reference/outcontrol/functions/ob-implicit-flush.xml index a3d5aee1a..afbdd8dc9 100644 --- a/reference/outcontrol/functions/ob-implicit-flush.xml +++ b/reference/outcontrol/functions/ob-implicit-flush.xml @@ -1,7 +1,7 @@ - + - + ob_implicit_flush Включение/выключение неявного сброса @@ -11,7 +11,7 @@ &reftitle.description; voidob_implicit_flush - boolflagtrue + boolenable&true; ob_implicit_flush включает или выключает неявный @@ -26,7 +26,7 @@ - flag + enable 1 для включения неявного сброса, false в противном случае. @@ -58,7 +58,7 @@ 8.0.0 - flag теперь принимает логическое значение (bool); + enable теперь принимает логическое значение (bool); ранее принималось целое число (int). diff --git a/reference/pdo/pdo.xml b/reference/pdo/pdo.xml index f76d0cc08..2a92052ec 100644 --- a/reference/pdo/pdo.xml +++ b/reference/pdo/pdo.xml @@ -1,8 +1,7 @@ - + - - + Класс PDO PDO @@ -22,20 +21,23 @@ - PDO + + PDO + - PDO - - - - - + &Methods; + + + + + +
diff --git a/reference/pdo/pdoexception.xml b/reference/pdo/pdoexception.xml index 00dea70f1..1cbf1b5a7 100644 --- a/reference/pdo/pdoexception.xml +++ b/reference/pdo/pdoexception.xml @@ -1,10 +1,7 @@ - + - + Класс PDOException PDOException @@ -27,9 +24,10 @@ - PDOException + + PDOException + - PDOException @@ -39,30 +37,31 @@ extends RuntimeException - - &Properties; - + public - array + arraynull errorInfo - - + null + + + protected string code - + &InheritedProperties; - + + + &InheritedMethods; - - + + + diff --git a/reference/pdo/pdostatement.xml b/reference/pdo/pdostatement.xml index 39562ff5a..fb86ca8ef 100644 --- a/reference/pdo/pdostatement.xml +++ b/reference/pdo/pdostatement.xml @@ -1,8 +1,7 @@ - + - - + Класс PDOStatement PDOStatement @@ -23,26 +22,31 @@ - PDOStatement + + PDOStatement + - PDOStatement - Traversable + IteratorAggregate - &Properties; - readonly stringqueryString + + public + string + queryString + &Methods; - - + + + @@ -61,6 +65,29 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + PDOStatement теперь реализует интерфейс IteratorAggregate + вместо Traversable. + + + + + +
+ &reference.pdo.entities.pdostatement; diff --git a/reference/phar/Phar/convertToData.xml b/reference/phar/Phar/convertToData.xml index c1a75904c..24757ad92 100644 --- a/reference/phar/Phar/convertToData.xml +++ b/reference/phar/Phar/convertToData.xml @@ -1,7 +1,6 @@ - + - Phar::convertToData @@ -12,7 +11,7 @@ &reftitle.description; - public PharnullPhar::convertToData + public PharDatanullPhar::convertToData intnullformat&null; intnullcompression&null; stringnullextension&null; diff --git a/reference/phar/PharData/compress.xml b/reference/phar/PharData/compress.xml index f891514e2..c261f5dfb 100644 --- a/reference/phar/PharData/compress.xml +++ b/reference/phar/PharData/compress.xml @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; - public PharnullPharData::compress + public PharDatanullPharData::compress intcompression stringnullextension&null; diff --git a/reference/phar/PharData/convertToData.xml b/reference/phar/PharData/convertToData.xml index 71e36b3a6..ba164ac83 100644 --- a/reference/phar/PharData/convertToData.xml +++ b/reference/phar/PharData/convertToData.xml @@ -1,7 +1,6 @@ - + - PharData::convertToData @@ -12,7 +11,7 @@ &reftitle.description; - public PharnullPharData::convertToData + public PharDatanullPharData::convertToData intnullformat&null; intnullcompression&null; stringnullextension&null; diff --git a/reference/phar/PharData/decompress.xml b/reference/phar/PharData/decompress.xml index f4c72492e..e51d36f64 100644 --- a/reference/phar/PharData/decompress.xml +++ b/reference/phar/PharData/decompress.xml @@ -1,7 +1,6 @@ - + - PharData::decompress @@ -11,7 +10,7 @@ &reftitle.description; - public PharnullPharData::decompress + public PharDatanullPharData::decompress stringnullextension&null; diff --git a/reference/session/sessionupdatetimestamphandlerinterface.xml b/reference/session/sessionupdatetimestamphandlerinterface.xml index dcaed3c56..2d2c042da 100644 --- a/reference/session/sessionupdatetimestamphandlerinterface.xml +++ b/reference/session/sessionupdatetimestamphandlerinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс SessionUpdateTimestampHandlerInterface @@ -31,29 +30,27 @@ - SessionUpdateTimestampHandlerInterface + + SessionUpdateTimestampHandlerInterface + - - - SessionUpdateTimestampHandlerInterface - + + SessionUpdateTimestampHandlerInterface + - &Methods; - + + + - - + &reference.session.entities.sessionupdatetimestamphandlerinterface; + - - + Класс SNMP SNMP @@ -24,71 +19,67 @@ xmlns="http://docbook.org/ns/docbook">
&reftitle.classsynopsis; - - - SNMP + + + + SNMP + - - - - SNMP - - - + + + SNMP + + - &Properties; - - public - int - max_oids - - - public - int - valueretrieval - - - public - bool - quick_print - - - public - bool - enum_print - - - public - int - oid_output_format - - - public - bool - oid_increasing_check - - - public - int - exceptions_enabled - - - public - array - info - + &Properties; + + public + readonly + array + info + + + public + intnull + max_oids + + + public + int + valueretrieval + + + public + bool + quick_print + + + public + bool + enum_print + + + public + int + oid_output_format + + + public + bool + oid_increasing_check + + + public + int + exceptions_enabled + - &Methods; - - - - - + &Constants; @@ -165,7 +156,7 @@ xmlns="http://docbook.org/ns/docbook"> 3 - + @@ -380,21 +371,21 @@ xmlns="http://docbook.org/ns/docbook"> SNMP::VERSION_1 - + SNMP::VERSION_2C, SNMP::VERSION_2c - + SNMP::VERSION_3 - + diff --git a/reference/snmp/snmp/get.xml b/reference/snmp/snmp/get.xml index 46cb46b5e..6135d74e9 100644 --- a/reference/snmp/snmp/get.xml +++ b/reference/snmp/snmp/get.xml @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; - public arrayboolSNMP::get + public mixedSNMP::get arraystringobjectId boolpreserveKeys&false; diff --git a/reference/snmp/snmpexception.xml b/reference/snmp/snmpexception.xml index 9bee87a56..afd593d4b 100644 --- a/reference/snmp/snmpexception.xml +++ b/reference/snmp/snmpexception.xml @@ -1,11 +1,7 @@ - + - - + Класс SNMPException SNMPException @@ -26,41 +22,41 @@ xmlns:phpdoc="http://php.net/ns/phpdoc">
&reftitle.classsynopsis; - - - SNMPException + + + + SNMPException + - - - - SNMPException - + + + SNMPException + - - extends - RuntimeException - + + extends + RuntimeException + + - - + &Properties; + + protected + string + code + - &Properties; - - protected - string - code - - - &InheritedProperties; - - - &InheritedMethods; - + &InheritedProperties; + + + + &InheritedMethods; + + + - +
diff --git a/reference/stream/functions/stream-get-contents.xml b/reference/stream/functions/stream-get-contents.xml index b7424d136..8b23935bf 100644 --- a/reference/stream/functions/stream-get-contents.xml +++ b/reference/stream/functions/stream-get-contents.xml @@ -1,5 +1,5 @@ - + @@ -10,15 +10,15 @@ &reftitle.description; stringfalsestream_get_contents - resourcehandle - intmaxlength-1 + resourcestream + intnulllength&null; intoffset-1 Похожа на функцию file_get_contents, за исключением того, что stream_get_contents работает с уже открытым ресурсом потока и возвращает оставшуюся часть содержимого в строку размером до - maxlength байт и начиная с указанного смещения + length байт и начиная с указанного смещения offset. @@ -28,7 +28,7 @@ - handle (resource) + stream (resource) Ресурс потока (например, полученный при помощи функции fopen) @@ -36,10 +36,10 @@ - maxlength (int) + length (int) - Максимальное количество байт для чтения. По умолчанию -1 (прочитать весь оставшийся + Максимальное количество байт для чтения. По умолчанию &null; (прочитать весь оставшийся буфер). @@ -64,6 +64,28 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + length теперь допускает значение null. + + + + + + + &reftitle.examples; diff --git a/reference/stream/functions/stream-get-line.xml b/reference/stream/functions/stream-get-line.xml index 414076283..44b4755de 100644 --- a/reference/stream/functions/stream-get-line.xml +++ b/reference/stream/functions/stream-get-line.xml @@ -1,5 +1,5 @@ - + @@ -9,8 +9,8 @@ &reftitle.description; - stringstream_get_line - resourcehandle + stringfalsestream_get_line + resourcestream intlength stringending"" @@ -35,7 +35,7 @@ - handle + stream Допустимый дескриптор файла. @@ -68,11 +68,8 @@ &reftitle.returnvalues; - Возвращает строку длиной до length байт, прочитанную из файла - указанного параметром handle. - - - Если возникает ошибка, возвращает &false;. + Возвращает строку длиной до length байт, прочитанную из файла + указанного параметром stream&return.falseforfailure;. diff --git a/reference/stream/functions/stream-select.xml b/reference/stream/functions/stream-select.xml index 80d5c9399..783e827d9 100644 --- a/reference/stream/functions/stream-select.xml +++ b/reference/stream/functions/stream-select.xml @@ -1,21 +1,21 @@ - + stream_select Запускает эквивалент системного вызова select() на заданных массивах - потоков с таймаутом, указанным параметрами tv_sec и tv_usec + потоков с таймаутом, указанным параметрами seconds и microseconds &reftitle.description; - intstream_select - arrayread - arraywrite - arrayexcept - inttv_sec - inttv_usec0 + intfalsestream_select + arraynullread + arraynullwrite + arraynullexcept + intnullseconds + intmicroseconds0 Функция stream_select получает массивы потоков и ждёт @@ -68,22 +68,22 @@ - tv_sec + seconds - Параметры tv_sec и tv_usec + Параметры seconds и microseconds вместе формируют параметр timeout, - tv_sec указывает число секунд, а - tv_usec - число микросекунд. + seconds указывает число секунд, а + microseconds - число микросекунд. Параметр timeout - это верхняя граница времени, которое функция stream_select будет ожидать до возвращения. - Если параметры tv_sec и tv_usec + Если параметры seconds и microseconds оба установлены в 0, то функция stream_select не будет ожидать данных - вместо этого она вернётся немедленно, указывая текущий статус потоков. - Если параметр tv_sec равен &null;, то функция stream_select + Если параметр seconds равен &null;, то функция stream_select может выполняться неопределённое время, возвращаясь только тогда, когда происходит событие на одном из отслеживаемых потоков (или если системный вызов прерывается сигналом). @@ -109,10 +109,10 @@ - tv_usec + microseconds - Смотрите описание параметра tv_sec. + Смотрите описание параметра seconds. diff --git a/reference/stream/functions/stream-set-write-buffer.xml b/reference/stream/functions/stream-set-write-buffer.xml index 8c4227cfa..3ccf26bd7 100644 --- a/reference/stream/functions/stream-set-write-buffer.xml +++ b/reference/stream/functions/stream-set-write-buffer.xml @@ -1,5 +1,5 @@ - + @@ -11,11 +11,11 @@ intstream_set_write_buffer resourcestream - intbuffer + intsize Устанавливает буферизацию для операций записи на заданном потоке stream - в число buffer байт. + в число size байт. @@ -32,10 +32,10 @@ - buffer + size - Число байт для буферизации. Если аргумент buffer + Число байт для буферизации. Если аргумент size равен 0, то операции записи не буферизуются. Это гарантирует, что все операции записи с использованием функции fwrite будут завершены перед тем, как другим процессам будет разрешено записывать в поток вывода. diff --git a/reference/stream/functions/stream-socket-accept.xml b/reference/stream/functions/stream-socket-accept.xml index 4f8724d9b..c11672481 100644 --- a/reference/stream/functions/stream-socket-accept.xml +++ b/reference/stream/functions/stream-socket-accept.xml @@ -1,5 +1,5 @@ - + @@ -11,9 +11,9 @@ &reftitle.description; resourcefalsestream_socket_accept - resourceserver_socket - floattimeoutini_get("default_socket_timeout") - stringpeername + resourcesocket + floatnulltimeout&null; + stringpeer_name&null; Принимать соединение в сокете, предварительно созданном с помощью функции @@ -26,7 +26,7 @@ - server_socket + socket Серверный сокет для принятия соединения. @@ -38,12 +38,12 @@ Переопределять тайм-аут подключения сокета по умолчанию. Время должно быть указано в - секундах. + секундах. По умолчанию используется значение default_socket_timeout. - peername + peer_name Будет присвоено имя (адрес) клиента, который подсоединился, если оно @@ -68,6 +68,28 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + timeout теперь допускает значение null. + + + + + + + &reftitle.notes; @@ -92,7 +114,7 @@ fwrite fclose feof - + diff --git a/reference/stream/functions/stream-socket-client.xml b/reference/stream/functions/stream-socket-client.xml index 6df3c1e02..0d54a1eb8 100644 --- a/reference/stream/functions/stream-socket-client.xml +++ b/reference/stream/functions/stream-socket-client.xml @@ -1,5 +1,5 @@ - + @@ -10,23 +10,23 @@ &reftitle.description; - resourcestream_socket_client - stringremote_socket - interrno - stringerrstr - floattimeoutini_get("default_socket_timeout") - intflagsSTREAM_CLIENT_CONNECT - resourcecontext + resourcefalsestream_socket_client + stringaddress + interror_code&null; + stringerror_message&null; + floatnulltimeout&null; + intflagsSTREAM_CLIENT_CONNECT + resourcenullcontext&null; Начинает соединение потока или датаграммы с удалённым сокетом, указанным - параметром remote_socket. Тип создаваемого сокета + параметром address. Тип создаваемого сокета определяется по транспорту, указанному с использованием стандартного форматирования URL: transport://target. Для интернет-сокетов, (AF_INET) таких, как TCP и UDP, часть target - параметра remote_socket должна состоять из + параметра address должна состоять из имени хоста или IP-адреса, за которым следует двоеточие и номер порта. Для доменных - сокетов Unix, часть target должна указывать на + сокетов Unix, часть target должна указывать на файл сокета в файловой системе. @@ -43,7 +43,7 @@ - remote_socket + address Адрес удалённого сокета для соединения. @@ -51,7 +51,7 @@ - errno + error_code Будет присвоен номер системной ошибки, если соединение не удалось установить. @@ -59,7 +59,7 @@ - errstr + error_message Будет присвоено сообщение о системной ошибке, если соединение не удалось установить. @@ -71,7 +71,7 @@ Число секунд, в течение которых должен произойти тайм-аут системного - вызова connect(). + вызова connect(). По умолчанию используется значение default_socket_timeout. Этот параметр применяется только если не происходит попытка @@ -124,19 +124,41 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + timeout и context теперь допускают значение null. + + + + + + + &reftitle.errors; - В случае неудачного вызова функции аргументы errno и - errstr будут заполнены системной ошибкой, + В случае неудачного вызова функции аргументы error_code и + error_message будут заполнены системной ошибкой, которая произошла при системном вызове connect(). Если значение, возвращённое в аргументе - errno равно 0 и функция + error_code равно 0 и функция возвратила значение &false;, это означает, что ошибка произошла до вызова connect(). Это произошло скорее всего из-за проблемы инициализации сокета. Примите во внимание, - что аргументы errno и - errstr всегда будут передаваться по ссылке. + что аргументы error_code и + error_message всегда будут передаваться по ссылке. @@ -224,7 +246,7 @@ if (!$fp) { fwrite fclose feof - + diff --git a/reference/stream/functions/stream-socket-enable-crypto.xml b/reference/stream/functions/stream-socket-enable-crypto.xml index e858ca18f..1e477e793 100644 --- a/reference/stream/functions/stream-socket-enable-crypto.xml +++ b/reference/stream/functions/stream-socket-enable-crypto.xml @@ -1,5 +1,5 @@ - + @@ -10,11 +10,11 @@ &reftitle.description; - mixedstream_socket_enable_crypto + intboolstream_socket_enable_crypto resourcestream boolenable - intcrypto_type - resourcesession_stream + intnullcrypto_method&null; + resourcenullsession_stream&null; @@ -49,7 +49,7 @@ - crypto_type + crypto_method Включить шифрование на потоке. @@ -100,6 +100,28 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + session_stream теперь допускает значение null. + + + + + + + &reftitle.examples; @@ -142,8 +164,8 @@ fclose($fp); &reftitle.seealso; - - + + diff --git a/reference/stream/php-user-filter.xml b/reference/stream/php-user-filter.xml index 3702327e6..bb76ce09e 100644 --- a/reference/stream/php-user-filter.xml +++ b/reference/stream/php-user-filter.xml @@ -1,7 +1,6 @@ - + - Класс php_user_filter @@ -27,34 +26,45 @@ - php_user_filter + + php_user_filter + - php_user_filter - + &Properties; public + string filtername + "" public + mixed params + "" + + + public + resourcenull + stream + null - &Methods; - + + +
-
&reftitle.properties; @@ -71,14 +81,19 @@ params - + + + + + stream + +
- &reference.stream.entities.php-user-filter; diff --git a/reference/xmlreader/xmlreader.xml b/reference/xmlreader/xmlreader.xml index 993601fe8..0a1693d9a 100644 --- a/reference/xmlreader/xmlreader.xml +++ b/reference/xmlreader/xmlreader.xml @@ -1,10 +1,7 @@ - + - + Класс XMLReader XMLReader @@ -26,15 +23,15 @@ - XMLReader + + XMLReader + - XMLReader - &Constants; @@ -171,97 +168,83 @@ 4 + &Properties; - - - public - readonly - int - attributeCount - - - public - readonly - string - baseURI - - - public - readonly - int - depth - - - public - readonly - bool - hasAttributes - - - public - readonly - bool - hasValue - - - public - readonly - bool - isDefault - - - public - readonly - bool - isEmptyElement - - - public - readonly - string - localName - - - public - readonly - string - name - - - public - readonly - string - namespaceURI - - - public - readonly - int - nodeType - - - public - readonly - string - prefix - - - public - readonly - string - value - - - public - readonly - string - xmlLang - - + + public + int + attributeCount + + + public + string + baseURI + + + public + int + depth + + + public + bool + hasAttributes + + + public + bool + hasValue + + + public + bool + isDefault + + + public + bool + isEmptyElement + + + public + string + localName + + + public + string + name + + + public + string + namespaceURI + + + public + int + nodeType + + + public + string + prefix + + + public + string + value + + + public + string + xmlLang + &Methods; - - + + + diff --git a/reference/xmlwriter/xmlwriter.xml b/reference/xmlwriter/xmlwriter.xml index b2f4ea22f..795d4b027 100644 --- a/reference/xmlwriter/xmlwriter.xml +++ b/reference/xmlwriter/xmlwriter.xml @@ -1,7 +1,6 @@ - + - Класс XMLWriter @@ -21,22 +20,24 @@
&reftitle.classsynopsis; - + - XMLWriter + + XMLWriter + - XMLWriter - &Methods; - + + + - +
@@ -45,7 +46,6 @@ &reference.xmlwriter.entities.xmlwriter; - + - + Класс <classname>ZipArchive</classname> ZipArchive @@ -19,11 +19,12 @@
&reftitle.classsynopsis; - + - ZipArchive + + ZipArchive + - ZipArchive @@ -33,20 +34,51 @@ Countable - + &Properties; - intlastId - intstatus - intstatusSys - intnumFiles - stringfilename - stringcomment + + public + readonly + int + lastId + + + public + readonly + int + status + + + public + readonly + int + statusSys + + + public + readonly + int + numFiles + + + public + readonly + string + filename + + + public + readonly + string + comment + &Methods; - - + + + - +