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

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_add_doc_javascript($fdf, 'validateOrder', 'app.alert(\"Проверьте заказ\")');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_add_doc_javascript показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_add_doc_javascript($fdf, 'warnOnImport', 'app.alert(\"Проверьте адрес доставки\")');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$snapshot = fdf_save_string($fdf);
if (!is_string($snapshot) || !str_starts_with($snapshot, '%FDF-')) { throw new RuntimeException('FDF-снимок не создан'); }
echo 'snapshot-bytes=', strlen($snapshot), PHP_EOL;
fdf_close($fdf);

fdf_add_doc_javascript показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Изменённый документ сериализован и проверен по FDF-сигнатуре.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$templatePath = __DIR__ . '/fixtures/invoice.pdf';
if (!is_file($templatePath)) { throw new RuntimeException('Нужен PDF-шаблон fixture'); }

$result = fdf_add_template($fdf, 1, $templatePath, 'Invoice', 1);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_add_template показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$templatePath = __DIR__ . '/fixtures/delivery.pdf';
if (!is_file($templatePath)) { throw new RuntimeException('Нужен PDF-шаблон fixture'); }

$result = fdf_add_template($fdf, 2, $templatePath, 'Delivery', 0);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$snapshot = fdf_save_string($fdf);
if (!is_string($snapshot) || !str_starts_with($snapshot, '%FDF-')) { throw new RuntimeException('FDF-снимок не создан'); }
echo 'snapshot-bytes=', strlen($snapshot), PHP_EOL;
fdf_close($fdf);

fdf_add_template показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Изменённый документ сериализован и проверен по FDF-сигнатуре.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_close($fdf);
echo 'Операция завершена без возвращаемого значения', PHP_EOL;

fdf_close показана в контексте минимального вызова; официальный тип возврата — void. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Операция завершена без возвращаемого значения

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'order_id', '73');
// Закрытие выполняется после последней операции с документом.
fdf_close($fdf);
echo 'Операция завершена без возвращаемого значения', PHP_EOL;

fdf_close показана в контексте интеграции заказа; официальный тип возврата — void. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Операция завершена без возвращаемого значения

<?php
declare(strict_types=1);

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

$result = fdf_create();
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
fdf_close($result);

fdf_create показана в контексте минимального вызова; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс

<?php
declare(strict_types=1);

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

$result = fdf_create();
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
fdf_set_value($result, 'order_id', '73');
$bytes = fdf_save_string($result);
echo 'bytes=', strlen($bytes), PHP_EOL;
fdf_close($result);

fdf_create показана в контексте интеграции заказа; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$visitor = static function (string $field, mixed $value, mixed $context): void {
    printf("%s=%s source=%s\n", $field, (string) $value, $context['source']);
};

$result = fdf_enum_values($fdf, $visitor, ['source' => 'minimal']);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_enum_values показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

$visitor = static function (string $field, mixed $value, mixed $context): void {
    printf("%s=%s source=%s\n", $field, (string) $value, $context['source']);
};

$result = fdf_enum_values($fdf, $visitor, ['source' => 'incoming-order']);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$snapshot = fdf_save_string($fdf);
if (!is_string($snapshot) || !str_starts_with($snapshot, '%FDF-')) { throw new RuntimeException('FDF-снимок не создан'); }
echo 'snapshot-bytes=', strlen($snapshot), PHP_EOL;
fdf_close($fdf);

fdf_enum_values показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Изменённый документ сериализован и проверен по FDF-сигнатуре.

<?php
declare(strict_types=1);

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

$result = fdf_errno();
echo $result, PHP_EOL;

fdf_errno показана в контексте минимального вызова; официальный тип возврата — int. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Целое значение по договору функции; для fdf_errno() 0 означает отсутствие ошибки.

<?php
declare(strict_types=1);

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

$result = fdf_errno();
echo $result, PHP_EOL;
echo fdf_error($result), PHP_EOL;

fdf_errno показана в контексте интеграции заказа; официальный тип возврата — int. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Целое значение по договору функции; для fdf_errno() 0 означает отсутствие ошибки.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_error(fdf_errno());
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_error показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_error(17);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_error показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fixturePath = __DIR__ . '/fixtures/appearances.fdf';
if (!is_file($fixturePath)) { throw new RuntimeException('Нужен учебный FDF fixture'); }
$fdf = fdf_open($fixturePath);
if ($fdf === false) { throw new RuntimeException('Учебный FDF не открыт'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$outputDir = __DIR__ . '/exports';
if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
    throw new RuntimeException('Не создан каталог exports');
}

$result = fdf_get_ap($fdf, 'customer_signature', FDFNormalAP, __DIR__ . '/exports/customer-email.ap');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_get_ap показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fixturePath = __DIR__ . '/fixtures/appearances.fdf';
if (!is_file($fixturePath)) { throw new RuntimeException('Нужен FDF с appearance-потоком'); }
$outputDir = __DIR__ . '/quarantine';
if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
    throw new RuntimeException('Не создан карантинный каталог');
}
$fdf = fdf_open($fixturePath);
if ($fdf === false) { throw new RuntimeException('FDF fixture не открыт'); }
$appearancePath = $outputDir . '/delivery-signature.ap';
$result = fdf_get_ap($fdf, 'delivery_signature', FDFNormalAP, $appearancePath);
fdf_close($fdf);
if ($result !== true || !is_file($appearancePath) || filesize($appearancePath) === 0) {
    throw new RuntimeException('Appearance не извлечён');
}
echo 'appearance-bytes=', filesize($appearancePath), PHP_EOL;
echo 'sha256=', hash_file('sha256', $appearancePath), PHP_EOL;

fdf_get_ap: Appearance извлекается в отдельный карантинный файл и проверяется по размеру и хешу до дальнейшей обработки. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: appearance-bytes=<положительное число> sha256=<64 hex-символа>

<?php
declare(strict_types=1);

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

$fixturePath = __DIR__ . '/fixtures/attachments.fdf';
if (!is_file($fixturePath)) { throw new RuntimeException('Нужен учебный FDF fixture'); }
$fdf = fdf_open($fixturePath);
if ($fdf === false) { throw new RuntimeException('Учебный FDF не открыт'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$attachmentDir = __DIR__ . '/exports';
if (!is_dir($attachmentDir) && !mkdir($attachmentDir, 0775, true) && !is_dir($attachmentDir)) {
    throw new RuntimeException('Не создан каталог для вложения');
}

$result = fdf_get_attachment($fdf, 'invoice_attachment', $attachmentDir);
if (!is_array($result)) { throw new RuntimeException('Вложение не извлечено'); }
printf("path=%s size=%d type=%s\n", $result['path'], $result['size'], $result['type'] ?? 'unknown');
fdf_close($fdf);

fdf_get_attachment показана в контексте минимального вызова; официальный тип возврата — array. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: path=<путь сохранённого вложения> size=<байты> type=<MIME или unknown>

<?php
declare(strict_types=1);

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

$fixturePath = __DIR__ . '/fixtures/attachments.fdf';
if (!is_file($fixturePath)) { throw new RuntimeException('Нужен учебный FDF fixture'); }
$fdf = fdf_open($fixturePath);
if ($fdf === false) { throw new RuntimeException('Учебный FDF не открыт'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

$attachmentDir = __DIR__ . '/quarantine';
if (!is_dir($attachmentDir) && !mkdir($attachmentDir, 0775, true) && !is_dir($attachmentDir)) {
    throw new RuntimeException('Не создан каталог для вложения');
}

$result = fdf_get_attachment($fdf, 'signed_contract', $attachmentDir);
if (!is_array($result)) { throw new RuntimeException('Вложение не извлечено'); }
printf("path=%s size=%d type=%s\n", $result['path'], $result['size'], $result['type'] ?? 'unknown');
if (!isset($result['path']) || !is_file($result['path'])) { throw new RuntimeException('Файл вложения не найден'); }
echo 'sha256=', hash_file('sha256', $result['path']), PHP_EOL;
fdf_close($fdf);

fdf_get_attachment показана в контексте интеграции заказа; официальный тип возврата — array. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: path=<путь сохранённого вложения> size=<байты> type=<MIME или unknown> Извлечённый файл существует и получает контрольную сумму.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_encoding($fdf, 'Unicode');
$result = fdf_get_encoding($fdf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_get_encoding показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

fdf_set_encoding($fdf, 'Shift-JIS');
$result = fdf_get_encoding($fdf);
echo $result, PHP_EOL;
if (!is_string($result) || $result === '') { throw new RuntimeException('Ожидалась непустая строка'); }
echo 'validated=', $result, PHP_EOL;
fdf_close($fdf);

fdf_get_encoding показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Полученная строка проверена перед дальнейшим использованием.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_file($fdf, 'invoice.pdf');
$result = fdf_get_file($fdf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_get_file показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

fdf_set_file($fdf, 'delivery.pdf');
$result = fdf_get_file($fdf);
echo $result, PHP_EOL;
if (!is_string($result) || $result === '') { throw new RuntimeException('Ожидалась непустая строка'); }
echo 'validated=', $result, PHP_EOL;
fdf_close($fdf);

fdf_get_file показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Полученная строка проверена перед дальнейшим использованием.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_flags($fdf, 'delivery_city', FDFSetFf, 2);
$result = fdf_get_flags($fdf, 'customer_email', FDFSetFf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_get_flags показана в контексте минимального вызова; официальный тип возврата — int. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Целое значение по договору функции; для fdf_errno() 0 означает отсутствие ошибки.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'order_id', '73');
if (!fdf_set_flags($fdf, 'order_id', FDFSetFf, 2)) { fdf_close($fdf); throw new RuntimeException('Тестовый флаг не задан'); }
$result = fdf_get_flags($fdf, 'order_id', FDFSetFf);
fdf_close($fdf);
if ($result !== 2) { throw new RuntimeException('Ожидался тот же набор FDFSetFf'); }
echo 'order_id-set-flags=', $result, PHP_EOL;

fdf_get_flags: Пример сначала задаёт известный набор FDFSetFf, затем читает ту же группу флагов того же поля и сравнивает точное значение. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: order_id-set-flags=2

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_opt($fdf, 'delivery_city', 0, 'Коломна', 'kolomna');
$result = fdf_get_opt($fdf, 'delivery_city', 0);
var_export($result);
echo PHP_EOL;
fdf_close($fdf);

fdf_get_opt показана в контексте минимального вызова; официальный тип возврата — mixed. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Фактическое значение выбранного поля или элемента списка.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

fdf_set_opt($fdf, 'delivery_method', 1, 'Курьер', 'courier');
$result = fdf_get_opt($fdf, 'delivery_method', 1);
var_export($result);
echo PHP_EOL;
if (!is_scalar($result) && $result !== null) { throw new RuntimeException('Неожиданный тип варианта поля'); }
echo 'selected-option=', (string) $result, PHP_EOL;
fdf_close($fdf);

fdf_get_opt показана в контексте интеграции заказа; официальный тип возврата — mixed. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Фактическое значение выбранного поля или элемента списка. Выбранный вариант нормализован для прикладной модели формы.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_status($fdf, 'Черновик');
$result = fdf_get_status($fdf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_get_status показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

fdf_set_status($fdf, 'Проверено оператором');
$result = fdf_get_status($fdf);
echo $result, PHP_EOL;
if (!is_string($result) || $result === '') { throw new RuntimeException('Ожидалась непустая строка'); }
echo 'validated=', $result, PHP_EOL;
fdf_close($fdf);

fdf_get_status показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Полученная строка проверена перед дальнейшим использованием.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$result = fdf_get_value($fdf, 'customer_email', -1);
var_export($result);
echo PHP_EOL;
fdf_close($fdf);

fdf_get_value показана в контексте минимального вызова; официальный тип возврата — mixed. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Фактическое значение выбранного поля или элемента списка.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'customer_email', ' BUYER@EXAMPLE.TEST ');
$result = fdf_get_value($fdf, 'customer_email');
fdf_close($fdf);
if (!is_string($result)) { throw new RuntimeException('Email должен быть строкой'); }
$email = filter_var(strtolower(trim($result)), FILTER_VALIDATE_EMAIL);
if ($email === false) { throw new RuntimeException('В PDF-форме некорректный email'); }
echo 'normalized-email=', $email, PHP_EOL;

fdf_get_value: Значение из PDF-формы нормализуется и валидируется перед передачей в модель заказа; это отдельная задача, а не замена имени поля в минимальном чтении. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: normalized-email=buyer@example.test

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

fdf_set_version($fdf, '1.3');
$result = fdf_get_version($fdf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_get_version показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

fdf_set_version($fdf, '1.4');
$result = fdf_get_version($fdf);
echo $result, PHP_EOL;
if (!is_string($result) || $result === '') { throw new RuntimeException('Ожидалась непустая строка'); }
echo 'validated=', $result, PHP_EOL;
fdf_close($fdf);

fdf_get_version показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Полученная строка проверена перед дальнейшим использованием.

<?php
declare(strict_types=1);

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

if (headers_sent($source, $line)) { throw new RuntimeException("Заголовки уже отправлены: {$source}:{$line}"); }
fdf_header();
// Функция не создаёт тело ответа: сериализованные FDF-байты отправляются отдельно.

fdf_header не возвращает и не генерирует FDF-документ — она только выставляет заголовок до начала вывода.
Что должно получиться в совместимом окружении: Установлен HTTP Content-Type application/vnd.fdf; тело ответа этим вызовом не создаётся.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'order_id', '73');
fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF-ответ не сериализован'); }
if (headers_sent($source, $line)) { throw new RuntimeException("Заголовки уже отправлены: {$source}:{$line}"); }
fdf_header();
header('Content-Disposition: attachment; filename=order-73.fdf');
header('Content-Length: ' . strlen($bytes));
echo $bytes;

fdf_header устанавливает только FDF Content-Type. Пример отдельно создаёт настоящие FDF-байты и отправляет их без диагностического текста; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: HTTP Content-Type application/vnd.fdf; тело начинается с %FDF- и содержит сериализованный документ.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$result = fdf_next_field_name($fdf, 'customer_email');
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_next_field_name показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

$result = fdf_next_field_name($fdf, 'delivery_city');
echo $result, PHP_EOL;
$next = fdf_next_field_name($fdf, $result);
echo 'next-field=', $next === '' ? '<конец>' : $next, PHP_EOL;
fdf_close($fdf);

fdf_next_field_name показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Второй вызов показывает переход к следующему имени либо конец списка.

<?php
declare(strict_types=1);

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

$path = __DIR__ . '/fixtures/order.fdf';
if (!is_file($path)) { throw new RuntimeException('Нужен учебный FDF-файл'); }

$result = fdf_open(__DIR__ . '/fixtures/order.fdf');
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
fdf_close($result);

fdf_open показана в контексте минимального вызова; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс

<?php
declare(strict_types=1);

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

$path = __DIR__ . '/fixtures/incoming-delivery.fdf';
if (!is_file($path)) { throw new RuntimeException('Нужен учебный FDF-файл'); }

$result = fdf_open(__DIR__ . '/fixtures/incoming-delivery.fdf');
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
$version = fdf_get_version($result);
echo 'opened-version=', $version !== '' ? $version : '<не указана>', PHP_EOL;
fdf_close($result);

fdf_open показана в контексте интеграции заказа; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс Открытый документ дополнительно прочитан через fdf_get_version().

<?php
declare(strict_types=1);

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

$fdfData = file_get_contents(__DIR__ . '/fixtures/order.fdf');
if (!is_string($fdfData) || $fdfData === '') { throw new RuntimeException('FDF не прочитан'); }

$result = fdf_open_string($fdfData);
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
fdf_close($result);

fdf_open_string показана в контексте минимального вызова; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс

<?php
declare(strict_types=1);

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

$fdfData = file_get_contents(__DIR__ . '/fixtures/incoming-delivery.fdf');
if (!is_string($fdfData) || $fdfData === '') { throw new RuntimeException('FDF не прочитан'); }

$result = fdf_open_string($fdfData);
if ($result === false) { throw new RuntimeException('Ресурс не получен'); }
echo 'Получен открытый FDF-ресурс', PHP_EOL;
$version = fdf_get_version($result);
echo 'opened-version=', $version !== '' ? $version : '<не указана>', PHP_EOL;
fdf_close($result);

fdf_open_string показана в контексте интеграции заказа; официальный тип возврата — resource. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Получен открытый FDF-ресурс Открытый документ дополнительно прочитан через fdf_get_version().

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'buyer@example.test');
fdf_set_value($fdf, 'delivery_city', 'Kolomna');

$result = fdf_remove_item($fdf, 'customer_email', FDFValue);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_remove_item показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'customer_email', 'warehouse@example.test');
fdf_set_value($fdf, 'delivery_city', 'Tula');

$result = fdf_remove_item($fdf, 'delivery_city', FDFValue);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$afterRemoval = fdf_get_value($fdf, 'delivery_city');
if ($afterRemoval !== false && $afterRemoval !== null && $afterRemoval !== '') { throw new RuntimeException('Значение осталось после удаления'); }
$snapshot = fdf_save_string($fdf);
if (!is_string($snapshot) || !str_starts_with($snapshot, '%FDF-')) { throw new RuntimeException('FDF после удаления не сериализован'); }
echo 'item=removed snapshot-bytes=', strlen($snapshot), PHP_EOL;
fdf_close($fdf);

fdf_remove_item показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Удаление подтверждено чтением поля и сериализацией изменённого FDF.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$outputDir = __DIR__ . '/exports';
if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
    throw new RuntimeException('Не создан каталог exports');
}

$result = fdf_save($fdf, __DIR__ . '/exports/order-42.fdf');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_save показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$outputDir = __DIR__ . '/exports';
if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
    throw new RuntimeException('Не создан каталог exports');
}

$result = fdf_save($fdf, __DIR__ . '/exports/delivery-73.fdf');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$savedPath = __DIR__ . '/exports/delivery-73.fdf';
if (!is_file($savedPath) || filesize($savedPath) === 0) { throw new RuntimeException('FDF-файл не появился'); }
echo 'saved-bytes=', filesize($savedPath), PHP_EOL;
fdf_close($fdf);

fdf_save показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) После сохранения проверены существование и ненулевой размер файла.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'order_id', '42');
$result = fdf_save_string($fdf);
echo $result, PHP_EOL;
fdf_close($fdf);

fdf_save_string показана в контексте минимального вызова; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

fdf_set_value($fdf, 'order_id', '73');
$result = fdf_save_string($fdf);
echo $result, PHP_EOL;
if (!str_starts_with($result, '%FDF-')) { throw new RuntimeException('Нет FDF-сигнатуры'); }
echo 'fdf-bytes=', strlen($result), PHP_EOL;
fdf_close($fdf);

fdf_save_string показана в контексте интеграции заказа; официальный тип возврата — string. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: Строка по договору функции; пустая строка может быть допустимым значением только там, где это прямо указано. Бинарная строка проверена по сигнатуре и размеру.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$appearancePath = __DIR__ . '/fixtures/customer-email.ap';
if (!is_file($appearancePath)) { throw new RuntimeException('Нужен appearance fixture'); }

$result = fdf_set_ap($fdf, 'customer_signature', FDFNormalAP, $appearancePath, 1);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_ap показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$appearancePath = __DIR__ . '/fixtures/delivery-signature.ap';
if (!is_file($appearancePath) || filesize($appearancePath) === 0) { throw new RuntimeException('Нужен непустой appearance fixture'); }
$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'delivery_signature', 'Подпись получателя');
$result = fdf_set_ap($fdf, 'delivery_signature', FDFNormalAP, $appearancePath, 1);
if ($result !== true) { fdf_close($fdf); throw new RuntimeException('Appearance не назначен'); }
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF не сериализован'); }
echo 'appearance-source-sha256=', hash_file('sha256', $appearancePath), PHP_EOL;
echo 'fdf-bytes=', strlen($bytes), PHP_EOL;

fdf_set_ap: Внешний appearance проверяется как fixture, назначается конкретному полю и странице, а изменённый FDF сериализуется. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: appearance-source-sha256=<64 hex-символа> fdf-bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_encoding($fdf, 'Unicode');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_encoding показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_encoding($fdf, 'Shift-JIS');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_encoding($fdf);
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_encoding показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_file($fdf, 'invoice.pdf', '_self');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_file показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_file($fdf, 'delivery.pdf', '_blank');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_file($fdf);
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_file показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_flags($fdf, 'customer_email', FDFSetFf, 1);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_flags показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'order_id', '73');
$result = fdf_set_flags($fdf, 'order_id', FDFSetFf, 2);
if ($result !== true) { fdf_close($fdf); throw new RuntimeException('Флаг поля не задан'); }
$storedFlags = fdf_get_flags($fdf, 'order_id', FDFSetFf);
if ($storedFlags !== 2) { fdf_close($fdf); throw new RuntimeException('Флаг не прочитался обратно'); }
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF не сериализован'); }
echo 'set-flags=', $storedFlags, ' fdf-bytes=', strlen($bytes), PHP_EOL;

fdf_set_flags: Записанный набор флагов читается обратно из того же поля и только затем документ сериализуется. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: set-flags=2 fdf-bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_javascript_action($fdf, 'submit_order', FDFEnter, 'app.alert(\"Готово\")');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_javascript_action показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'delivery_city', '');
$script = 'if (event.value === "") { app.alert("Укажите город"); }';
$result = fdf_set_javascript_action($fdf, 'delivery_city', FDFExit, $script);
if ($result !== true) { fdf_close($fdf); throw new RuntimeException('JavaScript-action не задан'); }
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF не сериализован'); }
echo 'trigger=FDFExit script-bytes=', strlen($script), PHP_EOL;
echo 'fdf-bytes=', strlen($bytes), PHP_EOL;

fdf_set_javascript_action: Поле проверяется при выходе из него; действие сохраняется в реальный FDF-снимок, а не подтверждается одним bool(true). Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: trigger=FDFExit script-bytes=<положительное число> fdf-bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_on_import_javascript($fdf, 'app.alert(\"Готово\")', true);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_on_import_javascript показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'order_id', '73');
$script = 'this.getField("order_id").readonly = true;';
$result = fdf_set_on_import_javascript($fdf, $script, true);
if ($result !== true) { fdf_close($fdf); throw new RuntimeException('Import-script не задан'); }
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF не сериализован'); }
$directory = __DIR__ . '/exports';
if (!is_dir($directory) && !mkdir($directory, 0775, true) && !is_dir($directory)) { throw new RuntimeException('Не создан каталог exports'); }
$path = $directory . '/locked-order-73.fdf';
if (file_put_contents($path, $bytes, LOCK_EX) === false) { throw new RuntimeException('FDF не сохранён'); }
echo basename($path), ' bytes=', filesize($path), PHP_EOL;

fdf_set_on_import_javascript: Скрипт выполняется до импорта данных и блокирует идентификатор заказа; итоговый FDF сохраняется как проверяемый артефакт. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: locked-order-73.fdf bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_opt($fdf, 'delivery_city', 0, 'Самовывоз', 'pickup');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_opt показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_opt($fdf, 'delivery_method', 1, 'Курьер', 'courier');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_opt($fdf, 'delivery_method', 1);
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_opt показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_status($fdf, 'Черновик');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_status показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_status($fdf, 'Проверено оператором');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_status($fdf);
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_status показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_submit_form_action($fdf, 'submit_order', FDFEnter, 'app.alert(\"Готово\")', 0);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_submit_form_action показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }
fdf_set_value($fdf, 'confirm_delivery', 'Отправить подтверждение');
$endpoint = 'https://example.test/fdf/delivery/73';
$result = fdf_set_submit_form_action($fdf, 'confirm_delivery', FDFEnter, $endpoint, 0);
if ($result !== true) { fdf_close($fdf); throw new RuntimeException('Submit-action не задан'); }
$bytes = fdf_save_string($fdf);
fdf_close($fdf);
if (!is_string($bytes) || !str_starts_with($bytes, '%FDF-')) { throw new RuntimeException('FDF не сериализован'); }
echo 'submit-host=', parse_url($endpoint, PHP_URL_HOST), PHP_EOL;
echo 'fdf-bytes=', strlen($bytes), PHP_EOL;

fdf_set_submit_form_action: Кнопке подтверждения назначается HTTPS endpoint, после чего изменённый документ сериализуется и проверяется по FDF-сигнатуре. Runtime требует ext/fdf и FDF Toolkit; локально выполнен только PHP lint.
Что должно получиться в совместимом окружении: submit-host=example.test fdf-bytes=<положительное число>

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_target_frame($fdf, '_self');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_target_frame показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_target_frame($fdf, 'result-frame');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$snapshot = fdf_save_string($fdf);
if (!is_string($snapshot) || !str_starts_with($snapshot, '%FDF-')) { throw new RuntimeException('FDF-снимок не создан'); }
echo 'snapshot-bytes=', strlen($snapshot), PHP_EOL;
fdf_close($fdf);

fdf_set_target_frame показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Изменённый документ сериализован и проверен по FDF-сигнатуре.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_value($fdf, 'customer_email', 'buyer@example.test', 0);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_value показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_value($fdf, 'delivery_city', 'Коломна', 1);
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_value($fdf, 'delivery_city');
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_value показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_version($fdf, '1.3');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
fdf_close($fdf);

fdf_set_version показана в контексте минимального вызова; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Перед вызовом показано только необходимое состояние ресурса.
Что должно получиться в совместимом окружении: bool(true)

<?php
declare(strict_types=1);

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

$fdf = fdf_create();
if ($fdf === false) { throw new RuntimeException('FDF не создан'); }

$result = fdf_set_version($fdf, '1.4');
if ($result !== true) { throw new RuntimeException('Операция FDF отклонена'); }
var_dump($result);
$roundTrip = fdf_get_version($fdf);
if ($roundTrip === false || $roundTrip === null || $roundTrip === '') { throw new RuntimeException('Записанное значение не прочиталось обратно'); }
echo 'round-trip=', is_scalar($roundTrip) ? (string) $roundTrip : get_debug_type($roundTrip), PHP_EOL;
fdf_close($fdf);

fdf_set_version показана в контексте интеграции заказа; официальный тип возврата — bool. Код проходит синтаксическую проверку; фактический FDF-результат требует ext/fdf, FDF Toolkit и указанные fixtures. Второй вариант меняет данные и проверяет реальный тип/артефакт, а не печатает заранее подготовленную строку.
Что должно получиться в совместимом окружении: bool(true) Записанное значение прочитано обратно из того же FDF-ресурса.