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

<?php
declare(strict_types=1);

$block = shmop_open(0, 'n', 0600, 128);
if ($block === false) throw new RuntimeException('Не создан блок');
try { echo shmop_size($block) >= 128 ? "Места достаточно\n" : "Проверьте размер\n"; }
finally { shmop_delete($block); unset($block); }

Места достаточно

0600 — восьмеричные права. Фактический размер узнают функцией size; пример не угадывает платформенные накладные расходы и не использует чужой key.

<?php
declare(strict_types=1);

try { shmop_open(0, 'rw', 0600, 128); }
catch (ValueError $error) { echo "Нужна одна буква режима: a, w, c или n\n"; }

Нужна одна буква режима: a, w, c или n

rw похоже на файловый режим, но shmop принимает ровно одну допустимую букву. Нулевая ёмкость запрещена для c/n; у a/w при открытии существующего используют size=0.

<?php
declare(strict_types=1);

$key = ftok(__DIR__ . '/app.ipc', 'B');
if ($key === -1 || $key === 0) throw new RuntimeException('Нет общего ключа');
$block = shmop_open($key, 'a', 0, 0);
if ($block === false) throw new RuntimeException('Владелец ещё не создал блок либо нет доступа');
try { echo shmop_read($block, 0, 4), "\n"; }
finally { unset($block); }

A42| — если владелец учебного Unix сервиса создал согласованный блок с таким заголовком.

Только ваш выделенный IPC namespace и файл app.ipc, общий с владельцем. Читатель не удаляет сегмент. Если для actual payload нужны согласованные чтения, вокруг чтения применяется общий lock. Это контекстный пример для указанной среды; здесь проверен синтаксис, многопроцессное выполнение не заявляется.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
$payload = 'A42|0007';
$capacity = shmop_size($block);
echo strlen($payload) <= $capacity ? "Пакет помещается\n" : "Пакет слишком большой\n";
} finally { shmop_delete($block); unset($block); }

Пакет помещается

Сравниваются байты. Проверка не резервирует блок для текущего процесса; конкурентные writers всё равно должны иметь общий lock.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
$before = shmop_size($block);
shmop_write($block, 'OK', 0);
$after = shmop_size($block);
echo $before === $after ? "Ёмкость прежняя\n" : "Ёмкость изменилась\n";
echo 'Полезных байтов сейчас: ', strlen('OK'), "\n";
} finally { shmop_delete($block); unset($block); }

Ёмкость прежняя
Полезных байтов сейчас: 2

Чтение всей ёмкости вернуло бы также незанятый/старый хвост. Это не способ узнать длину нового сообщения.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
shmop_write($block, 'A42|0007', 0);
$quantityText = shmop_read($block, 4, 4);
echo 'Количество: ', (int)$quantityText, "\n";
} finally { shmop_delete($block); unset($block); }

Количество: 7

В согласованном учебном ASCII формате поле 4…7 содержит четыре десятичные цифры. Для внешних данных проверяйте формат до (int), иначе мусор может превратиться в неожиданное число.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
$capacity = shmop_size($block);
shmop_write($block, 'END', $capacity - 3);
echo shmop_read($block, $capacity - 3, 0), "\n";
echo strlen(shmop_read($block, $capacity, 0)), "\n";
try { shmop_read($block, $capacity, 1); }
catch (ValueError $error) { echo "За границей блока\n"; }
} finally { shmop_delete($block); unset($block); }

END
0
За границей блока

size=0 означает «до конца», а не всегда пустую строку. Только offset в самом конце даёт пустой результат; запрос хотя бы одного байта за концом запрещён.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
shmop_write($block, 'ABCDEFGH', 0);
shmop_write($block, 'OK', 0);
echo shmop_read($block, 0, 8), "\n";
} finally { shmop_delete($block); unset($block); }

OKCDEFGH

Если новое сообщение должно быть только OK, читатель обязан знать длину 2. Для фиксированного текстового поля можно явно дополнить поле согласованным padding, но это правило формата, не автоматизм write.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
$capacity = shmop_size($block);
$payload = 'ABCDEF';
$written = shmop_write($block, $payload, $capacity - 3);
echo 'Записано: ', $written, ' из ', strlen($payload), "\n";
echo shmop_read($block, $capacity - 3, 3), "\n";
echo shmop_write($block, 'X', $capacity), "\n";
} finally { shmop_delete($block); unset($block); }

Записано: 3 из 6
ABC
0

Запись внутри допустимого offset может быть короткой без исключения. В самом конце остаётся ноль места: вернётся 0. Перед изменением целого пакета лучше заранее проверить capacity и защищать операцию общим lock.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
$first = 'A42|';
$second = '0007';
$packetLength = strlen($first) + strlen($second);
if ($packetLength > shmop_size($block)) throw new LengthException('Не помещается');
if (shmop_write($block, $first, 0) !== strlen($first)) throw new RuntimeException('Первая запись короткая');
if (shmop_write($block, $second, strlen($first)) !== strlen($second)) throw new RuntimeException('Вторая запись короткая');
echo shmop_read($block, 0, $packetLength), "\n";
} finally { shmop_delete($block); unset($block); }

A42|0007

Смещение второй строки — число байтов первой. Два write не становятся одной атомарной операцией: другие процессы должны читать их под общей блокировкой либо по иному корректному протоколу публикации.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes();
try {
    if (!shmop_delete($block)) throw new RuntimeException('Не отмечен к удалению');
    echo "Владелец запросил удаление\n";
} finally { unset($block); }

Владелец запросил удаление

Только приватный блок текущего эксперимента. unset освобождает единственную ссылку PHP; на Windows окончательный lifetime дополнительно связан с mapping handles процесса.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes();
try {
    try { throw new RuntimeException('Неверный пакет'); }
    finally { shmop_delete($block); unset($block); echo "Учебный ресурс завершён\n"; }
} catch (RuntimeException $error) { echo "Ошибка обработки учтена\n"; }

Учебный ресурс завершён
Ошибка обработки учтена

В production один reader не удаляет общий блок в своём finally; это делает владелец после остановки всей группы. Здесь ресурс был создан только ради примера.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
shmop_write($block, 'OK', 0);
set_error_handler(static fn() => true, E_DEPRECATED);
try { shmop_close($block); }
finally { restore_error_handler(); }
echo shmop_read($block, 0, 2), "\n";
} finally { shmop_delete($block); unset($block); }

OK

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

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes();
$reader = $block;
unset($block);
try {
    shmop_write($reader, 'OK', 0);
    echo shmop_read($reader, 0, 2), "\n";
} finally { shmop_delete($reader); unset($reader); }

OK

Присваивание объекта создало ещё одну ссылку на ту же ручку, не копию сегмента. unset первой переменной не закрывает объект, пока он доступен через $reader.

<?php
declare(strict_types=1);

require __DIR__ . '/shmop-lab.php';
$block = lessonBytes(256);
try {
echo $block instanceof Shmop ? "Объект Shmop\n" : "Другой тип\n";
echo is_resource($block) ? "resource\n" : "Это уже не resource\n";
} finally { shmop_delete($block); unset($block); }

Объект Shmop
Это уже не resource

Обновление PHP7→8 требует изменить resource checks. Проверка типа не подтверждает формат данных и наличие требуемой блокировки.

<?php
declare(strict_types=1);

try { new Shmop(); }
catch (Error $error) { echo "Используйте shmop_open\n"; }

Используйте shmop_open

Непосредственное создание запрещено: объект должен получить действующий attachment. Сериализация, клонирование и добавление динамических свойств тоже не поддержаны.