PHP: полный мануал с примерами, функциями и ООП

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

CollectionModify::patch(string $document): mysql_xdevapi\CollectionModify

Сохранить только переданные настройки карточки, не потеряв остальные поля.

Запись, вход и результат

CollectionModify::patch(string $document): mysql_xdevapi\CollectionModify

Возвращаемое значение. Возвращает объект CollectionModify для дальнейшей настройки. Сохранение выполняет execute; его отдельный Result — квитанция операции.

Два применения

Сохранить два разрешённых поля формы одним документом изменений.

$patch = json_encode(['name'=>'Светильник PRO','status'=>'published'], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
$collection->modify('_id = :id')->patch($patch)->bind(['id'=>'LED'])->execute();

Исходные данные, полный запуск и результат.

Изменить вложенную настройку и удалить устаревший телефон, сохранив соседние поля.

$collection->modify('_id = :id')->patch('{"display":{"color":"blue"},"contact":{"phone":null}}')
    ->bind(['id'=>'CARD'])->execute();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Merge Patch рекурсивно сливает объекты; отсутствие ключа сохраняет значение, null удаляет ключ, новый ненулевой ключ добавляется. Массив заменяется целиком, не объединяется по индексам. PHP-вариант patch принимает строку: сериализуйте проверенные данные через json_encode, не копируйте объектный синтаксис JavaScript-коннектора. Не путайте Merge Patch с JSON Patch op/path/value. Условия доступа, allowlist полей и проверка версии принадлежат приложению; изменение выбранных полей не защищает автоматически от конкурентного перезаписывания тех же полей.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

Контекст: объект изменения, значения условия и момент выполнения.

• PHP Manual — CollectionModify::patch
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

CollectionModify::replace(string $collection_field, string $expression_or_literal): mysql_xdevapi\CollectionModify

Заменить значение по существующему пути внутри документа.

Запись, вход и результат

CollectionModify::replace(string $collection_field, string $expression_or_literal): mysql_xdevapi\CollectionModify

Возвращаемое значение. CollectionModify для продолжения цепочки. В существующем поле новое значение заменяет старое; отсутствующий путь в данном профиле ничего не добавляет.

Два применения

Исправить существующую цену, не меняя артикул и идентификатор.

$collection->modify('_id = :id')->replace('price_cents',1200)->bind(['id'=>'LED'])->execute();

Исходные данные, полный запуск и результат.

Обнаружить отсутствие поля после квитанции; не выдавать matched/affected за доказательство сохранённой цены.

$receipt = $collection->modify('_id = :id')->replace('price_cents',900)->bind(['id'=>'CABLE'])->execute();
$card = $collection->getOne('CABLE');
$hasPrice = array_key_exists('price_cents',$card);

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

replace изменяет поле, а Collection::replaceOne заменяет документ целиком — это разные операции. set подходит для вставки отсутствующего поля. Строка "price_cents + 100" не превращается автоматически в вычисление: выражение передают соответствующим Expression, уже разобранным отдельно. Здесь используется буквальное целое значение; денежная единица задана явно. При отсутствии документа и при отсутствии пути постусловия различаются, проверяйте нужную бизнес-ситуацию.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

Контекст: объект изменения, значения условия и момент выполнения.

• PHP Manual — CollectionModify::replace
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

CollectionModify::sort(string $sort_expr): mysql_xdevapi\CollectionModify

Выбрать, какие совпадения попадут в ограниченную порцию изменений.

Запись, вход и результат

CollectionModify::sort(string $sort_expr): mysql_xdevapi\CollectionModify

Возвращаемое значение. CollectionModify, который можно дополнить limit, patch и выполнить. Порядок соответствует смыслу ORDER BY; сортируется серверное множество выбранных документов.

Два применения

Опубликовать первые две карточки по приоритету и устойчивому ключу.

$collection->modify('status = :status')->bind(['status'=>'pending'])
    ->sort('priority ASC','_id ASC')->limit(2)->patch('{"status":"published"}')->execute();

Исходные данные, полный запуск и результат.

Брать очередную первую порцию уменьшающейся pending-очереди.

$collection->modify('status = :status')->bind(['status'=>'pending'])
    ->sort('_id ASC')->limit(2)->patch('{"status":"done"}')->execute();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

sort не является usort над уже загруженными документами. Одно поле с повторяющимися значениями не даёт устойчивой границы, поэтому добавлен уникальный _id. Имена полей и направления не подставляют из запроса пользователя без разрешённого словаря. Индекс и план влияют на стоимость; limit не гарантирует, что сервер просмотрит только две записи. При конкурентном изменении набора нужна отдельная стратегия согласованности.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

Контекст: объект изменения, значения условия и момент выполнения.

• PHP Manual — CollectionModify::sort
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

CollectionModify::limit(int $rows): mysql_xdevapi\CollectionModify

Ограничить число документов одного изменения.

Запись, вход и результат

CollectionModify::limit(int $rows): mysql_xdevapi\CollectionModify

Возвращаемое значение. CollectionModify для дальнейшей настройки. Фактический результат зависит от числа совпадений; limit(2) не требует, чтобы совпадений было ровно два.

Два применения

Ограничить одну публикацию двумя карточками.

$operation = $collection->modify('status = :status')->bind(['status'=>'pending']);
$operation->sort('priority ASC','_id ASC')->limit(2)->patch('{"status":"published"}')->execute();

Исходные данные, полный запуск и результат.

Обработать пять фиксированных документов порциями 2,2,1 без растущего смещения.

for ($pass=0; $pass<3; $pass++) {
    $collection->modify('status = :status')->bind(['status'=>'pending'])
        ->sort('_id ASC')->limit(2)->patch('{"status":"done"}')->execute();
}

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Manual предлагает сочетать limit со skip, но проверенный сервер отклоняет ненулевой offset для CollectionModify кодом 5012; это разобрано в следующей карточке. Для размера порции приложение должно задать допустимый положительный диапазон; не передавайте отрицательные значения и не рассчитывайте на неограниченную обработку. Квитанция не заменяет чтение состояния. Отдельные проходы не составляют автоматически одну транзакцию.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

Контекст: объект изменения, значения условия и момент выполнения.

• PHP Manual — CollectionModify::limit
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

CollectionModify::skip(int $position): mysql_xdevapi\CollectionModify

Разобраться со смещением и ограничением конкретного сервера.

Запись, вход и результат

CollectionModify::skip(int $position): mysql_xdevapi\CollectionModify

Возвращаемое значение. На этапе настройки — CollectionModify. При фактическом выполнении проверенного ненулевого смещения возникает серверное исключение 5012.

Два применения

Показать реальный отказ, не принять настройку объекта за успешное изменение.

try {
    $collection->modify('status = :status')->bind(['status'=>'pending'])
        ->set('window_selected',true)->sort('_id ASC')->limit(2)->skip(1)->execute();
} catch (mysql_xdevapi\Exception $error) {
    if ($error->getCode() !== 5012) { throw $error; }
    echo 'Этот сервер не разрешает offset для изменения';
}

Исходные данные, полный запуск и результат.

Выбрать те же ID для отдельного ограниченного изменения; полный файл проверяет отмеченные и нетронутые карточки.

$window = $collection->find('status = :status')->bind(['status'=>'pending'])
    ->fields('_id')->sort('_id ASC')->limit(2)->offset(1)->execute()->fetchAll();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

В проверенной связке PECL mysql_xdevapi 8.0.30/MySQL 8.4.13 skip(1) создаёт допустимую PHP-цепочку, но execute отклоняется сервером: mysql_xdevapi\Exception, код 5012, offset value is not allowed for this operation. После отказа документы остаются прежними. Это зафиксированное ограничение профиля, а не повод скрыть метод из полного справочника. В исходнике отрицательная position отклоняется до отправки операции. При меняющемся фильтре растущий offset пропускает ещё не обработанные документы; используйте ограниченную первую порцию или согласованные ID. Чтение окна и изменение не являются одной атомарной командой: нужны предметные проверки состояния и, при необходимости, транзакции.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

Контекст: объект изменения, значения условия и момент выполнения.

• PHP Manual — CollectionModify::skip
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11. · mysql_xdevapi

interface mysql_xdevapi\CrudOperationBindable

Общий код знает, как привязать значения условия, не зная остальных методов операции.

Запись, вход и результат

interface mysql_xdevapi\CrudOperationBindable

Возвращаемое значение. Возвращает объект, поддерживающий CrudOperationBindable. В конкретном CollectionModify это тот же объект операции, а не результат SQL.

Два применения

Повторно использовать один понятный шаг привязки ID.

function bindDocument(mysql_xdevapi\CrudOperationBindable $operation, string $id): mysql_xdevapi\CrudOperationBindable {
    return $operation->bind(['id'=>$id]);
}

Исходные данные, полный запуск и результат.

Передать текущий статус отдельно от синтаксиса условия.

$operation = $collection->modify('status = :status');
$operation->bind(['status'=>'pending']);

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Интерфейс не предоставляет modify/patch и не создаётся через new. Значения не являются именами коллекций, путями полей или направлениями сортировки. Это контракт CRUD-привязки именованного массива; не переносите его в SqlStatement::bind, где в этом PHP-драйвере используются последовательные скалярные аргументы для ?. Не превращайте отсутствие обязательного placeholder в пустую строку.

Ниже полный краткий synopsis официальной страницы. В нём написано class, однако исходник PECL 8.0.30 этой версии регистрирует именно interface. Его нельзя создать через new; объект конкретной операции реализует объявленный метод.

class mysql_xdevapi\CrudOperationBindable {
    abstract public function bind(array $placeholder_values): mysql_xdevapi\CrudOperationBindable;
}

Единственный член официального обзора: CrudOperationBindable::bind. Обзор не заменяет подробную карточку метода с параметром, результатом и двумя применениями.

Версии. Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11.

• PHP Manual — CrudOperationBindable
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

abstract public CrudOperationBindable::bind(array $placeholder_values): mysql_xdevapi\CrudOperationBindable

Общий код знает, как привязать значения условия, не зная остальных методов операции.

Запись, вход и результат

abstract public CrudOperationBindable::bind(array $placeholder_values): mysql_xdevapi\CrudOperationBindable

Возвращаемое значение. Возвращает объект, поддерживающий CrudOperationBindable. В конкретном CollectionModify это тот же объект операции, а не результат SQL.

Два применения

Повторно использовать один понятный шаг привязки ID.

function bindDocument(mysql_xdevapi\CrudOperationBindable $operation, string $id): mysql_xdevapi\CrudOperationBindable {
    return $operation->bind(['id'=>$id]);
}

Исходные данные, полный запуск и результат.

Передать текущий статус отдельно от синтаксиса условия.

$operation = $collection->modify('status = :status');
$operation->bind(['status'=>'pending']);

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Интерфейс не предоставляет modify/patch и не создаётся через new. Значения не являются именами коллекций, путями полей или направлениями сортировки. Это контракт CRUD-привязки именованного массива; не переносите его в SqlStatement::bind, где в этом PHP-драйвере используются последовательные скалярные аргументы для ?. Не превращайте отсутствие обязательного placeholder в пустую строку.

Контекст контракта: CrudOperationBindable.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

• PHP Manual — CrudOperationBindable::bind
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11. · mysql_xdevapi

interface mysql_xdevapi\CrudOperationLimitable

Передать ограничение порции в общий код, который не отвечает за саму выборку или изменение.

Запись, вход и результат

interface mysql_xdevapi\CrudOperationLimitable

Возвращаемое значение. Объект с контрактом CrudOperationLimitable. Конкретный класс определяет смысл выполнения; у CollectionModify метод возвращает CollectionModify.

Два применения

В одном месте проверить положительный размер порции и настроить операцию.

function limitBatch(mysql_xdevapi\CrudOperationLimitable $operation, int $size): mysql_xdevapi\CrudOperationLimitable {
    if ($size < 1 || $size > 100) { throw new InvalidArgumentException('Недопустимый размер порции'); }
    return $operation->limit($size);
}

Исходные данные, полный запуск и результат.

Выполнить первую порцию по заранее определённому порядку.

$operation->sort('priority ASC','_id ASC')->limit(2);
$receipt = $operation->execute();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Интерфейс не выбирает порядок и не обещает ровно rows совпадений. Две операции с limit(2) могут читать строки или менять документы — общий максимум не делает их эквивалентными. Оценивать стоимость и конкурентное выполнение нужно по конкретному запросу. Наличие этого контракта ничего не говорит о поддержке offset сервером.

Ниже полный краткий synopsis официальной страницы. В нём написано class, однако исходник PECL 8.0.30 этой версии регистрирует именно interface. Его нельзя создать через new; объект конкретной операции реализует объявленный метод.

class mysql_xdevapi\CrudOperationLimitable {
    abstract public function limit(int $rows): mysql_xdevapi\CrudOperationLimitable;
}

Единственный член официального обзора: CrudOperationLimitable::limit. Обзор не заменяет подробную карточку метода с параметром, результатом и двумя применениями.

Версии. Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11.

• PHP Manual — CrudOperationLimitable
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

abstract public CrudOperationLimitable::limit(int $rows): mysql_xdevapi\CrudOperationLimitable

Передать ограничение порции в общий код, который не отвечает за саму выборку или изменение.

Запись, вход и результат

abstract public CrudOperationLimitable::limit(int $rows): mysql_xdevapi\CrudOperationLimitable

Возвращаемое значение. Объект с контрактом CrudOperationLimitable. Конкретный класс определяет смысл выполнения; у CollectionModify метод возвращает CollectionModify.

Два применения

В одном месте проверить положительный размер порции и настроить операцию.

function limitBatch(mysql_xdevapi\CrudOperationLimitable $operation, int $size): mysql_xdevapi\CrudOperationLimitable {
    if ($size < 1 || $size > 100) { throw new InvalidArgumentException('Недопустимый размер порции'); }
    return $operation->limit($size);
}

Исходные данные, полный запуск и результат.

Выполнить первую порцию по заранее определённому порядку.

$operation->sort('priority ASC','_id ASC')->limit(2);
$receipt = $operation->execute();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Интерфейс не выбирает порядок и не обещает ровно rows совпадений. Две операции с limit(2) могут читать строки или менять документы — общий максимум не делает их эквивалентными. Оценивать стоимость и конкурентное выполнение нужно по конкретному запросу. Наличие этого контракта ничего не говорит о поддержке offset сервером.

Контекст контракта: CrudOperationLimitable.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

• PHP Manual — CrudOperationLimitable::limit
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11. · mysql_xdevapi

interface mysql_xdevapi\CrudOperationSkippable

Явно отделить наличие метода пропуска от возможности выполнить операцию на сервере.

Запись, вход и результат

interface mysql_xdevapi\CrudOperationSkippable

Возвращаемое значение. Объект с контрактом CrudOperationSkippable. Этот возврат относится к настройке, не подтверждает успешный серверный результат.

Два применения

Отобразить доступный PHP-контракт в таблице возможностей конкретного объекта.

$supportsMethod = $operation instanceof mysql_xdevapi\CrudOperationSkippable;

Исходные данные, полный запуск и результат.

Отделить общий шаг настройки от обработки отказа при выполнении; полный урок даёт рабочий обход через выбранные ID.

function configureOffset(mysql_xdevapi\CrudOperationSkippable $operation, int $skip): mysql_xdevapi\CrudOperationSkippable {
    return $operation->skip($skip);
}
// Это только настройка; execute CollectionModify со skip(1) здесь даст 5012.

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

В проверенной связке PECL mysql_xdevapi 8.0.30/MySQL 8.4.13 skip(1) создаёт допустимую PHP-цепочку, но execute отклоняется сервером: mysql_xdevapi\Exception, код 5012, offset value is not allowed for this operation. После отказа документы остаются прежними. Это зафиксированное ограничение профиля, а не повод скрыть метод из полного справочника. Краткий пример Manual использует find()->skip(), но PHP CollectionFind в нашем рабочем обходе применяет offset(). Не угадывайте одинаковое имя метода по аналогии с другим классом или коннектором. Интерфейс не гарантирует устойчивый порядок; сначала определяют сортировку и согласованность набора.

Ниже полный краткий synopsis официальной страницы. В нём написано class, однако исходник PECL 8.0.30 этой версии регистрирует именно interface. Его нельзя создать через new; объект конкретной операции реализует объявленный метод.

class mysql_xdevapi\CrudOperationSkippable {
    abstract public function skip(int $skip): mysql_xdevapi\CrudOperationSkippable;
}

Единственный член официального обзора: CrudOperationSkippable::skip. Обзор не заменяет подробную карточку метода с параметром, результатом и двумя применениями.

Версии. Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11.

• PHP Manual — CrudOperationSkippable
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

abstract public CrudOperationSkippable::skip(int $skip): mysql_xdevapi\CrudOperationSkippable

Явно отделить наличие метода пропуска от возможности выполнить операцию на сервере.

Запись, вход и результат

abstract public CrudOperationSkippable::skip(int $skip): mysql_xdevapi\CrudOperationSkippable

Возвращаемое значение. Объект с контрактом CrudOperationSkippable. Этот возврат относится к настройке, не подтверждает успешный серверный результат.

Два применения

Отобразить доступный PHP-контракт в таблице возможностей конкретного объекта.

$supportsMethod = $operation instanceof mysql_xdevapi\CrudOperationSkippable;

Исходные данные, полный запуск и результат.

Отделить общий шаг настройки от обработки отказа при выполнении; полный урок даёт рабочий обход через выбранные ID.

function configureOffset(mysql_xdevapi\CrudOperationSkippable $operation, int $skip): mysql_xdevapi\CrudOperationSkippable {
    return $operation->skip($skip);
}
// Это только настройка; execute CollectionModify со skip(1) здесь даст 5012.

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

В проверенной связке PECL mysql_xdevapi 8.0.30/MySQL 8.4.13 skip(1) создаёт допустимую PHP-цепочку, но execute отклоняется сервером: mysql_xdevapi\Exception, код 5012, offset value is not allowed for this operation. После отказа документы остаются прежними. Это зафиксированное ограничение профиля, а не повод скрыть метод из полного справочника. Краткий пример Manual использует find()->skip(), но PHP CollectionFind в нашем рабочем обходе применяет offset(). Не угадывайте одинаковое имя метода по аналогии с другим классом или коннектором. Интерфейс не гарантирует устойчивый порядок; сначала определяют сортировку и согласованность набора.

Контекст контракта: CrudOperationSkippable.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

• PHP Manual — CrudOperationSkippable::skip
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11. · mysql_xdevapi

interface mysql_xdevapi\CrudOperationSortable

Передать известное правило порядка в общий код, не загружая весь набор в массив PHP.

Запись, вход и результат

interface mysql_xdevapi\CrudOperationSortable

Возвращаемое значение. Объект с контрактом CrudOperationSortable для продолжения настройки. У конкретного CollectionModify фактический класс остаётся CollectionModify.

Два применения

Применять одно явное правило порядка к подходящим операциям.

function byPublicationOrder(mysql_xdevapi\CrudOperationSortable $operation): mysql_xdevapi\CrudOperationSortable {
    return $operation->sort('priority ASC','_id ASC');
}

Исходные данные, полный запуск и результат.

Задать стабильную следующую порцию известной очереди.

$operation->sort('_id ASC')->limit(2);

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Порядок соответствует смыслу ORDER BY; интерфейс не разрешает произвольную SQL-строку от пользователя. Входные значения направления/поля выбираются из словаря приложения, а не экранируются как данные через bind. Без уникального последнего ключа равные значения оставляют неоднозначность. Объекты с orderby вместо sort не получают этот контракт только потому, что тоже умеют сортировать.

Ниже полный краткий synopsis официальной страницы. В нём написано class, однако исходник PECL 8.0.30 этой версии регистрирует именно interface. Его нельзя создать через new; объект конкретной операции реализует объявленный метод.

class mysql_xdevapi\CrudOperationSortable {
    abstract public function sort(string $sort_expr): mysql_xdevapi\CrudOperationSortable;
}

Единственный член официального обзора: CrudOperationSortable::sort. Обзор не заменяет подробную карточку метода с параметром, результатом и двумя применениями.

Версии. Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11.

• PHP Manual — CrudOperationSortable
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

abstract public CrudOperationSortable::sort(string $sort_expr): mysql_xdevapi\CrudOperationSortable

Передать известное правило порядка в общий код, не загружая весь набор в массив PHP.

Запись, вход и результат

abstract public CrudOperationSortable::sort(string $sort_expr): mysql_xdevapi\CrudOperationSortable

Возвращаемое значение. Объект с контрактом CrudOperationSortable для продолжения настройки. У конкретного CollectionModify фактический класс остаётся CollectionModify.

Два применения

Применять одно явное правило порядка к подходящим операциям.

function byPublicationOrder(mysql_xdevapi\CrudOperationSortable $operation): mysql_xdevapi\CrudOperationSortable {
    return $operation->sort('priority ASC','_id ASC');
}

Исходные данные, полный запуск и результат.

Задать стабильную следующую порцию известной очереди.

$operation->sort('_id ASC')->limit(2);

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

Порядок соответствует смыслу ORDER BY; интерфейс не разрешает произвольную SQL-строку от пользователя. Входные значения направления/поля выбираются из словаря приложения, а не экранируются как данные через bind. Без уникального последнего ключа равные значения оставляют неоднозначность. Объекты с orderby вместо sort не получают этот контракт только потому, что тоже умеют сортировать.

Контекст контракта: CrudOperationSortable.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

• PHP Manual — CrudOperationSortable::sort
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11. · mysql_xdevapi

interface mysql_xdevapi\Executable

Выполнить уже настроенную операцию в понятном месте программы и получить её фактический результат.

Запись, вход и результат

interface mysql_xdevapi\Executable

Возвращаемое значение. Один из объектов результата. Manual показывает Result в сигнатуре, но поясняет Result/SqlStatementResult; конкретные операции чтения также возвращают DocResult/RowResult. В этой программе CollectionModify возвращает Result.

Два применения

Выделить точку выполнения в небольшой общей функции без выдуманного единого типа всех результатов.

function runOperation(mysql_xdevapi\Executable $operation) {
    return $operation->execute();
}
$receipt = runOperation($operation);

Исходные данные, полный запуск и результат.

Получить квитанцию ограниченного изменения и перечитать реально опубликованные ID.

$receipt = $operation->execute();
$affected = $receipt->getAffectedItemsCount();
$published = $collection->find('status = :status')->bind(['status'=>'published'])->fields('_id')->execute()->fetchAll();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

execute не означает commit ранее открытой транзакции: её завершение управляется отдельно. До execute вызовы bind/limit/sort лишь настраивают операцию. Ошибки сервера и соединения нужно обрабатывать по задаче, не заменяя их пустым результатом. Повторный вызов может повторно применить изменение; интерфейс не обещает идемпотентность, откат либо автоматические повторы.

Ниже полный краткий synopsis официальной страницы. В нём написано class, однако исходник PECL 8.0.30 этой версии регистрирует именно interface. Его нельзя создать через new; объект конкретной операции реализует объявленный метод.

class mysql_xdevapi\Executable {
    abstract public function execute(): mysql_xdevapi\Result;
}

Единственный член официального обзора: Executable::execute. Обзор не заменяет подробную карточку метода с параметром, результатом и двумя применениями.

Версии. Интерфейс указан в PHP Manual начиная с PECL mysql_xdevapi 8.0.11.

• PHP Manual — Executable
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API

Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах. · mysql_xdevapi

abstract public Executable::execute(): mysql_xdevapi\Result

Выполнить уже настроенную операцию в понятном месте программы и получить её фактический результат.

Запись, вход и результат

abstract public Executable::execute(): mysql_xdevapi\Result

Возвращаемое значение. Один из объектов результата. Manual показывает Result в сигнатуре, но поясняет Result/SqlStatementResult; конкретные операции чтения также возвращают DocResult/RowResult. В этой программе CollectionModify возвращает Result.

Два применения

Выделить точку выполнения в небольшой общей функции без выдуманного единого типа всех результатов.

function runOperation(mysql_xdevapi\Executable $operation) {
    return $operation->execute();
}
$receipt = runOperation($operation);

Исходные данные, полный запуск и результат.

Получить квитанцию ограниченного изменения и перечитать реально опубликованные ID.

$receipt = $operation->execute();
$affected = $receipt->getAffectedItemsCount();
$published = $collection->find('status = :status')->bind(['status'=>'published'])->fields('_id')->execute()->fetchAll();

Исходные данные, полный запуск и результат.

Условия, ошибки и альтернативы

execute не означает commit ранее открытой транзакции: её завершение управляется отдельно. До execute вызовы bind/limit/sort лишь настраивают операцию. Ошибки сервера и соединения нужно обрабатывать по задаче, не заменяя их пустым результатом. Повторный вызов может повторно применить изменение; интерфейс не обещает идемпотентность, откат либо автоматические повторы.

Контекст контракта: Executable.

Версии. Страница метода не сообщает первую версию. Примеры относятся к PECL mysql_xdevapi 8.0.30 и MySQL 8.4.13; версия PHP записана в результатах.

• PHP Manual — Executable::execute
• MySQL X DevAPI: Collection.modify и правила patch
• RFC 7396: JSON Merge Patch
• MySQL 8.4: функции изменения JSON
• MySQL worklog 10797: отображение MERGE_PATCH в X Protocol
• PECL mysql_xdevapi 8.0.30: выбранная реализация PHP API