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

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmaddtag(RPMTAG_SHA256HEADER);
var_dump($result);

rpmaddtag: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: bool(true) при успешной операции.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmaddtag(RPMTAG_LONGFILESIZES);
var_dump($result);

rpmaddtag: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: bool(true) при успешной операции.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmdbinfo('php-cli', false);
if ($result === null) { throw new RuntimeException('Запись в rpmdb не найдена'); }
echo 'records=', count($result), PHP_EOL;

rpmdbinfo: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: records=<количество найденных записей>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

rpmaddtag(RPMTAG_INSTALLTIME);
$result = rpmdbinfo('php-cli', true);
if (!is_array($result) || $result === []) { throw new RuntimeException('php-cli не найден в rpmdb'); }
usort($result, static fn(array $a, array $b): int => ((int) ($b['Installtime'] ?? 0)) <=> ((int) ($a['Installtime'] ?? 0)));
$active = $result[0];
foreach (['Name', 'Version', 'Release', 'Arch'] as $key) { if (!isset($active[$key])) { throw new RuntimeException("В rpmdb нет {$key}"); } }
printf("installed=%s-%s-%s.%s candidates=%d\n", $active['Name'], $active['Version'], $active['Release'], $active['Arch'], count($result));

rpmdbinfo: Из rpmdb выбирается фактически установленная запись, проверяются ключевые теги и явно учитывается возможность нескольких кандидатов. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: installed=<Name-Version-Release.Arch> candidates=<число записей>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmdbsearch('php*');
if ($result === null) { throw new RuntimeException('Запись в rpmdb не найдена'); }
echo 'records=', count($result), PHP_EOL;

rpmdbsearch: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: records=<количество найденных записей>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmdbsearch('/usr/bin/php', RPMTAG_BASENAMES);
if ($result === null) { throw new RuntimeException('Запись в rpmdb не найдена'); }
echo 'records=', count($result), PHP_EOL;

rpmdbsearch: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: records=<количество найденных записей>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmdefine('_aen_root /srv/aen');
var_dump($result);

rpmdefine: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: bool(true) при успешной операции.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmdefine('_aen_release 42');
var_dump($result);
$expanded = rpmexpand('%{_aen_release}');
if ($expanded !== '42') { throw new RuntimeException('RPM-макрос не раскрылся'); }
echo 'expanded=', $expanded, PHP_EOL;

rpmdefine: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: bool(true) при успешной операции. После определения макрос раскрывается в 42.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmexpand('%{_bindir}');
if ($result === null) { throw new RuntimeException('Значение не получено'); }
echo $result, PHP_EOL;

rpmexpand: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Строка раскрытого макроса или цель символической ссылки; пустая строка для rpmgetsymlink означает «не ссылка».

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

rpmdefine('_aen_root /srv/aen');
rpmdefine('_aen_release 42');
$result = rpmexpand('%{_aen_root}/releases/%{_aen_release}');
if ($result === null) { throw new RuntimeException('Значение не получено'); }
echo $result, PHP_EOL;

rpmexpand: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Строка раскрытого макроса или цель символической ссылки; пустая строка для rpmgetsymlink означает «не ссылка».

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmexpandnumeric('1');
var_dump($result);

rpmexpandnumeric: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Для сравнения без operator: -1, 0 или 1; с operator: bool. Для numeric expansion: int.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

rpmdefine('_aen_release 42');
$result = rpmexpandnumeric('%{?_aen_release}');
var_dump($result);

rpmexpandnumeric: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Для сравнения без operator: -1, 0 или 1; с operator: bool. Для numeric expansion: int.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$rpmFixture = __DIR__ . '/fixtures/service.rpm';
if (!is_file($rpmFixture)) { throw new RuntimeException('Нужен RPM fixture с известным хешем'); }
$result = rpmgetsymlink($rpmFixture, 'usr/bin/service');
if ($result === null) { throw new RuntimeException('Значение не получено'); }
echo $result, PHP_EOL;

rpmgetsymlink: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Строка раскрытого макроса или цель символической ссылки; пустая строка для rpmgetsymlink означает «не ссылка».

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$rpmFixture = __DIR__ . '/fixtures/service.rpm';
if (!is_file($rpmFixture)) { throw new RuntimeException('Нужен RPM fixture с известным хешем'); }
$result = rpmgetsymlink($rpmFixture, 'etc/service/current');
if ($result === null) { throw new RuntimeException('Значение не получено'); }
echo $result, PHP_EOL;
if ($result === '') { echo 'entry=regular-file', PHP_EOL; }
else { echo 'symlink-target=', $result, PHP_EOL; }

rpmgetsymlink: второй пример использует данные развёртывания и обрабатывает отсутствие результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Строка раскрытого макроса или цель символической ссылки; пустая строка для rpmgetsymlink означает «не ссылка». Пустая строка означает обычный файл; непустая — цель ссылки.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$rpmFixture = __DIR__ . '/fixtures/service.rpm';
if (!is_file($rpmFixture)) { throw new RuntimeException('Нужен RPM fixture с известным хешем'); }
$error = '';
$result = rpminfo($rpmFixture, false, $error);
if ($result === null) { throw new RuntimeException($error !== '' ? $error : 'RPM не прочитан'); }
echo 'records=', count($result), PHP_EOL;

rpminfo: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: records=<количество найденных записей>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$rpmFixture = __DIR__ . '/fixtures/service.rpm';
if (!is_file($rpmFixture)) { throw new RuntimeException('Нужен RPM fixture с известным хешем'); }
$error = '';
$result = rpminfo($rpmFixture, true, $error);
if (!is_array($result)) { throw new RuntimeException($error !== '' ? $error : 'RPM не прочитан'); }
$required = ['Name', 'Version', 'Release', 'Arch'];
foreach ($required as $key) { if (!array_key_exists($key, $result)) { throw new RuntimeException("В RPM нет {$key}"); } }
$identity = sprintf('%s-%s-%s.%s', $result['Name'], $result['Version'], $result['Release'], $result['Arch']);
echo 'package=', $identity, PHP_EOL;
echo 'fixture-sha256=', hash_file('sha256', $rpmFixture), PHP_EOL;

rpminfo: Полный заголовок локального RPM проверяется на обязательные поля и связывается с хешем конкретного fixture — имя файла не принимается за доказательство содержимого. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: package=<Name-Version-Release.Arch> fixture-sha256=<64 hex-символа>

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$result = rpmvercmp('1.0-4', '1.0-5');
var_dump($result);

rpmvercmp: показан минимальный договор и реальный тип результата. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: Для сравнения без operator: -1, 0 или 1; с operator: bool. Для numeric expansion: int.

<?php
declare(strict_types=1);

if (!extension_loaded('rpminfo')) {
    throw new RuntimeException('Нужно расширение rpminfo');
}

$installed = '1:2.4.1-3';
$candidate = '1:2.5.0-1';
$upgradeNeeded = rpmvercmp($installed, $candidate, 'lt');
if (!is_bool($upgradeNeeded)) { throw new RuntimeException('Ожидался bool для оператора lt'); }
$ordering = rpmvercmp($installed, $candidate);
if ($ordering !== -1 || $upgradeNeeded !== true) { throw new RuntimeException('EVR сравнивается неожиданно'); }
echo $upgradeNeeded ? 'decision=upgrade' : 'decision=keep', PHP_EOL;
echo 'ordering=', $ordering, PHP_EOL;

rpmvercmp: Сервис обновления принимает реальное решение по EVR: оператор lt даёт bool, а второй вызов подтверждает порядок значением -1. Выполнение требует Linux/RPM-окружение с rpminfo; локально заявлен только lint.
Что должно получиться в совместимом окружении: decision=upgrade ordering=-1