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

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $data = file_get_contents(__DIR__ . '/invoice.txt');
    if ($data === false) { throw new RuntimeException('Выгрузка недоступна'); }
    $old = mhash(MHASH_SHA256, $data);
    $new = hash('sha256', $data, true);
    echo 'invoice.txt: ', bin2hex($new), "\n";
    echo hash_equals($old, $new) ? "Старый формат подтверждён; получатель примет тот же digest.\n" : "Миграция меняет байты.\n";
} finally { restore_error_handler(); }
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

invoice.txt: 36c43bb2eda40f4ea02f6ef2b7a4d0dbf7754df0c0f2c88fb1b120d6d2b1bdb2
Старый формат подтверждён; получатель примет тот же digest.
Устаревший API: да

Обработчик предупреждений временно собирает только ожидаемые deprecation Mhash; finally восстанавливает обычную обработку. Все mhash-функции устарели с8.1, MHASH-константы с8.5. Этот код нужен для изучения/переноса существующих данных, новые проекты используют Hash/password API. Сбой чтения или чужое предупреждение не маскируются.

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $body = '{"order":42}';
    $key = 'demo-key-not-a-real-secret';
    $legacy = mhash(MHASH_SHA256, $body, $key);
    $modern = hash_hmac('sha256', $body, $key, true);
    var_dump(hash_equals($legacy, $modern));
    var_dump(base64_encode($legacy) === base64_encode($modern));
    var_dump(hash_equals($modern, hash_hmac('sha256', $body . "\n", $key, true)));
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

bool(true)
bool(true)
bool(false)
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $plain = mhash(MHASH_SHA256, 'abc', null);
    $emptyKey = mhash(MHASH_SHA256, 'abc', '');
    var_dump($plain === hash('sha256', 'abc', true));
    var_dump($emptyKey === hash_hmac('sha256', 'abc', '', true));
    var_dump($plain === $emptyKey);
    var_dump(mhash(-1, 'abc'));
    try { mhash(MHASH_CRC32, 'abc', 'demo'); }
    catch (ValueError $error) { echo "Алгоритм не подходит для HMAC\n"; }
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

bool(true)
bool(true)
bool(false)
bool(false)
Алгоритм не подходит для HMAC
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $found = false;
    for ($id = 0; $id <= mhash_count(); ++$id) {
        $name = mhash_get_hash_name($id);
        if ($name === 'SHA256') { $found = true; echo 'Найден старый формат: ', $name, " → hash('sha256', данные, true)\n"; }
    }
    if (!$found) { echo "Формат SHA256 отсутствует: импорт остановлен.\n"; }
} finally { restore_error_handler(); }
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

Найден старый формат: SHA256 → hash('sha256', данные, true)
Устаревший API: да

Обработчик предупреждений временно собирает только ожидаемые deprecation Mhash; finally восстанавливает обычную обработку. Все mhash-функции устарели с8.1, MHASH-константы с8.5. Этот код нужен для изучения/переноса существующих данных, новые проекты используют Hash/password API. Сбой чтения или чужое предупреждение не маскируются.

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $lastId = mhash_count();
    $names = [];
    $gaps = [];
    for ($id = 0; $id <= $lastId; ++$id) {
        $name = mhash_get_hash_name($id);
        if ($name === false) { $gaps[] = $id; continue; }
        $names[$id] = $name;
    }
    echo count($names), "\n";
    echo implode(',', $gaps), "\n";
    echo in_array('sha256', hash_algos(), true) ? "SHA-256 доступен в Hash\n" : "Нет SHA-256\n";
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

39
4,6,26
SHA-256 доступен в Hash
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $size = mhash_get_block_size(MHASH_SHA256);
    if ($size === false) { throw new RuntimeException('Алгоритм неизвестен'); }
    $full = mhash(MHASH_SHA256, 'invoice=42');
    $short = substr($full, 0, -1);
    echo strlen($full) === $size ? "Полный пакет: поле SHA256 можно читать.\n" : "Полный пакет: ошибка.\n";
    echo strlen($short) === $size ? "Короткий пакет принят.\n" : "Короткий пакет: импорт остановлен, не хватает байта.\n";
} finally { restore_error_handler(); }
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

Полный пакет: поле SHA256 можно читать.
Короткий пакет: импорт остановлен, не хватает байта.
Устаревший API: да

Обработчик предупреждений временно собирает только ожидаемые deprecation Mhash; finally восстанавливает обычную обработку. Все mhash-функции устарели с8.1, MHASH-константы с8.5. Этот код нужен для изучения/переноса существующих данных, новые проекты используют Hash/password API. Сбой чтения или чужое предупреждение не маскируются.

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $expectedBytes = mhash_get_block_size(MHASH_SHA256);
    if ($expectedBytes === false) { throw new RuntimeException('Unknown format algorithm'); }
    $raw = mhash(MHASH_SHA256, 'record=42');
    $short = substr($raw, 0, -1);
    echo strlen($raw) === $expectedBytes ? "Поле полное\n" : "Поле обрезано\n";
    echo strlen($short) === $expectedBytes ? "Поле полное\n" : "Поле обрезано\n";
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

Поле полное
Поле обрезано
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $legacyName = mhash_get_hash_name(MHASH_SHA256);
    if ($legacyName !== 'SHA256') { throw new RuntimeException('Неизвестный формат'); }
    echo $legacyName, " → sha256\n";
    echo 'Отпечаток invoice=42: ', hash('sha256', 'invoice=42'), "\n";
} finally { restore_error_handler(); }
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

SHA256 → sha256
Отпечаток invoice=42: 75bc7941966514f9788ff7c2126ee3384aeb0039bd7934b543aa7d3dc58875b7
Устаревший API: да

Обработчик предупреждений временно собирает только ожидаемые deprecation Mhash; finally восстанавливает обычную обработку. Все mhash-функции устарели с8.1, MHASH-константы с8.5. Этот код нужен для изучения/переноса существующих данных, новые проекты используют Hash/password API. Сбой чтения или чужое предупреждение не маскируются.

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $variants = [[MHASH_TIGER, 'tiger192,3'], [MHASH_HAVAL256, 'haval256,3']];
    foreach ($variants as [$oldId, $newName]) {
        $oldResult = mhash($oldId, 'demo fixture');
        echo mhash_get_hash_name($oldId), ' -> ', $newName, ': ';
        echo $oldResult === hash($newName, 'demo fixture', true) ? "совпало\n" : "различается\n";
    }
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

TIGER -> tiger192,3: совпало
HAVAL256 -> haval256,3: совпало
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $key = mhash_keygen_s2k(MHASH_SHA256, 'legacy phrase', '12345678', 16);
    if ($key === false) { throw new RuntimeException('Старый ключ не получен'); }
    echo 'Учебный S2K: ', bin2hex($key), "\n";
    $different = hash_pbkdf2('sha256', 'legacy phrase', '12345678', 2, 16, true);
    echo hash_equals($key, $different) ? "Можно заменить без смены формата.\n" : "PBKDF2 даёт другой ключ; нужна миграция формата.\n";
} finally { restore_error_handler(); }
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

Учебный S2K: 98c2114895f7b2d04475053341fb14f9
PBKDF2 даёт другой ключ; нужна миграция формата.
Устаревший API: да

Обработчик предупреждений временно собирает только ожидаемые deprecation Mhash; finally восстанавливает обычную обработку. Все mhash-функции устарели с8.1, MHASH-константы с8.5. Этот код нужен для изучения/переноса существующих данных, новые проекты используют Hash/password API. Сбой чтения или чужое предупреждение не маскируются.

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $base = mhash_keygen_s2k(MHASH_SHA256, 'demo', '12345678', 16);
    $long = mhash_keygen_s2k(MHASH_SHA256, 'demo', '12345678EXTRA', 16);
    $short = mhash_keygen_s2k(MHASH_SHA256, 'demo', 'abc', 16);
    $padded = mhash_keygen_s2k(MHASH_SHA256, 'demo', "abc\0\0\0\0\0", 16);
    var_dump(hash_equals($base, $long));
    var_dump(hash_equals($short, $padded));
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

bool(true)
bool(true)
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    $salt = '12345678';
    $password = 'demo legacy phrase';
    $legacy = mhash_keygen_s2k(MHASH_SHA1, $password, $salt, 40);
    $firstBlock = hash('sha1', $salt . $password, true);
    $secondBlock = hash('sha1', "\0" . $salt . $password, true);
    var_dump(hash_equals($legacy, $firstBlock . $secondBlock));
    $different = hash_pbkdf2('sha1', $password, $salt, 1, 40, true);
    var_dump(hash_equals($legacy, $different));
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

bool(true)
bool(false)
Устаревший API: да

<?php
declare(strict_types=1);

$legacyNotice = false;
set_error_handler(function (int $level, string $message) use (&$legacyNotice): bool {
    if ($level === E_DEPRECATED
        && (str_starts_with($message, 'Function mhash') || str_starts_with($message, 'Constant MHASH_'))) {
        $legacyNotice = true;
        return true;
    }
    return false;
});
try {
    var_dump(mhash_keygen_s2k(-1, 'demo', '12345678', 16));
    foreach ([0, -1] as $length) {
        try { mhash_keygen_s2k(MHASH_SHA256, 'demo', '12345678', $length); }
        catch (ValueError $error) { echo "Неверная длина\n"; }
    }
} finally {
    restore_error_handler();
}
echo $legacyNotice ? "Устаревший API: да\n" : "Устаревший API: нет\n";

bool(false)
Неверная длина
Неверная длина
Устаревший API: да