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

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$type = exif_imagetype(__DIR__ . '/lesson.jpg');
echo $type === IMAGETYPE_JPEG ? "JPEG\n" : "Другой формат\n";

JPEG

Смысл числа лучше выражать именем константы: IMAGETYPE_JPEG понятнее магического 2.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
copy(__DIR__ . '/lesson.jpg', __DIR__ . '/renamed.dat');
$type = exif_imagetype(__DIR__ . '/renamed.dat');
echo image_type_to_mime_type($type), "\n";

image/jpeg

Копия называется .dat, но внутри JPEG. В прикладном коде перед image_type_to_mime_type проверяют type!==false; здесь файл — известная учебная заготовка.

<?php
declare(strict_types=1);

file_put_contents(__DIR__ . '/empty.bin', '');
$diagnostics = [];
set_error_handler(static function (int $severity, string $message) use (&$diagnostics): bool {
    $diagnostics[] = $message;
    return true;
}, E_WARNING | E_NOTICE);
try { $type = exif_imagetype(__DIR__ . '/empty.bin'); }
finally { restore_error_handler(); }
var_dump($type);
echo $diagnostics !== [] ? "Есть диагностическое сообщение\n" : "Без диагностики\n";

bool(false)
Есть диагностическое сообщение

Здесь локально перехватывается ожидаемая диагностика ровно одного вызова. error_reporting(0) на всём сайте скрыл бы посторонние проблемы. Пустой файл не становится изображением.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg');
if ($metadata === false) throw new RuntimeException('Не прочитаны метаданные');
echo $metadata['Model'] ?? 'Модель не указана', "\n";

Model A

?? даёт запасную подпись, когда ключа нет. Проверка false отделяет неудачу чтения от успешно прочитанного файла без конкретного поля.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg', null, true);
if ($metadata === false) throw new RuntimeException('Ошибка чтения');
echo $metadata['IFD0']['Model'], "\n";
echo $metadata['COMPUTED']['Width'], '×', $metadata['COMPUTED']['Height'], "\n";
echo $metadata['EXIF']['DateTimeOriginal'], "\n";

Model A
32×20
2026:10:13 12:00:00

Третий аргумент true создаёт секции-массивы. У нашей заготовки поля известны; для фотографий посетителей каждое необязательное поле проверяют. COMPUTED.Width/Height отражают вычисленные сведения о файле.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg', 'IFD0,GPS', true);
var_dump($metadata !== false);
var_dump(isset($metadata['EXIF']));
var_dump(exif_read_data(__DIR__ . '/lesson.jpg', 'GPS', true));

bool(true)
bool(true)
bool(false)

IFD0 найдена, поэтому список IFD0,GPS принят даже без GPS. EXIF тоже вернулась: список не отфильтровал её. Отдельное требование отсутствующей GPS дало false.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$stream = fopen(__DIR__ . '/lesson.jpg', 'rb');
if ($stream === false) throw new RuntimeException('Не открыт файл');
try {
    fseek($stream, 10);
    $metadata = exif_read_data($stream, null, true);
    echo $metadata['IFD0']['Make'], "\n";
    echo ftell($stream), "\n";
} finally { fclose($stream); }

Learning Camera
10

Начиная с PHP 7.2 можно передать ресурс потока. Он должен поддерживать перемещение позиции. Чтение заголовков возвращает исходную позицию; закрывает поток его владелец.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$bytes = file_get_contents(__DIR__ . '/lesson.jpg');
if ($bytes === false) throw new RuntimeException('Нет байтов');
$stream = fopen('php://temp', 'w+b');
if ($stream === false) throw new RuntimeException('Нет временного потока');
try {
    if (fwrite($stream, $bytes) !== strlen($bytes)) throw new RuntimeException('Неполная запись');
    rewind($stream);
    $metadata = exif_read_data($stream, null, true);
    echo $metadata['IFD0']['Orientation'], "\n";
} finally { fclose($stream); }

6

Функция не принимает сырые JPEG-байты вместо имени файла. Seekable php://temp связывает полученную от хранилища строку с API чтения. В production ограничивают размер загружаемых байтов; temp может перейти из памяти на диск.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg', null, true);
$computed = $metadata['COMPUTED'];
echo $computed['UserComment'], "\n";
echo $computed['UserCommentEncoding'], "\n";
echo $computed['Copyright.Photographer'], ' / ', $computed['Copyright.Editor'], "\n";

Learning sample
ASCII
Author / Editor

Сырые теги могут содержать маркер кодировки и NUL-разделитель. COMPUTED предоставляет разобранные поля. Они не обязаны присутствовать в каждой фотографии и не доказывают авторство.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg', null, true, true);
$bytes = $metadata['THUMBNAIL']['THUMBNAIL'] ?? null;
echo is_string($bytes) && strlen($bytes) > 0 ? "Миниатюра прочитана\n" : "Нет миниатюры\n";
echo $metadata['COMPUTED']['Thumbnail.Width'], '×', $metadata['COMPUTED']['Thumbnail.Height'], "\n";

Миниатюра прочитана
4×3

Четвёртый true добавил двоичные данные. Их нельзя бездумно отправлять через json_encode как UTF-8 текст. Если нужна только миниатюра, exif_thumbnail выразит цель прямо.

<?php
declare(strict_types=1);

echo exif_tagname(0x0112), "\n";
echo exif_tagname(0x010F), "\n";

Orientation
Make

0x означает шестнадцатеричную запись числа. 0x0112 — тот же int, что 274. Функция знает название, но не знает ориентацию какого-либо вашего файла.

<?php
declare(strict_types=1);

foreach ([0x0112, 0xEEEE] as $tagId) {
    $name = exif_tagname($tagId);
    echo sprintf('0x%04X', $tagId), ': ', $name === false ? 'Неизвестный тег' : $name, "\n";
}

0x0112: Orientation
0xEEEE: Неизвестный тег

sprintf лишь форматирует номер. Проверка ===false сохраняет различие между отсутствующим именем и строковым значением. Каталог PHP не обязан знать каждый закрытый MakerNote производителя.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$thumbnail = exif_thumbnail(__DIR__ . '/lesson.jpg', $width, $height, $type);
if ($thumbnail === false) throw new RuntimeException('Нет встроенного превью');
echo $width, '×', $height, "\n";
echo image_type_to_mime_type($type), "\n";
echo strlen($thumbnail) > 0 ? "Есть двоичные байты\n" : "Пусто\n";

4×3
image/jpeg
Есть двоичные байты

width, height и type передаются по ссылке: функция записывает результаты в ваши переменные. Отдельный return содержит байты JPEG, а не имя файла.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$bytes = exif_thumbnail(__DIR__ . '/lesson.jpg', $width, $height, $type);
if ($bytes === false || $type !== IMAGETYPE_JPEG) throw new RuntimeException('Нет ожидаемого JPEG-превью');
$saved = file_put_contents(__DIR__ . '/preview.jpg', $bytes);
if ($saved !== strlen($bytes)) throw new RuntimeException('Неполная запись');
$size = getimagesize(__DIR__ . '/preview.jpg');
echo $size[0], '×', $size[1], "\n";

4×3

Имя preview.jpg выбрано приложением в учебной директории. Реальный сервис сохраняет файлы в контролируемом хранилище и не перезаписывает произвольный путь посетителя.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$bytes = exif_thumbnail(__DIR__ . '/base.jpg', $width, $height, $type);
echo $bytes === false ? "Нужна генерация миниатюры\n" : "Превью найдено\n";

Нужна генерация миниатюры

Отсутствие миниатюры нормально и не означает, что основной JPEG повреждён. Генерацию выполняет библиотека обработки изображений с отдельными лимитами.

<?php
declare(strict_types=1);

// Контекст: web handler, $photoPath выбран приложением после проверки доступа.
$bytes = exif_thumbnail($photoPath, $width, $height, $type);
if ($bytes === false) {
    http_response_code(404);
    exit;
}
header('Content-Type: ' . image_type_to_mime_type($type));
header('X-Content-Type-Options: nosniff');
header('Content-Length: ' . strlen($bytes));
echo $bytes;

Это контекстный HTTP-обработчик, проверенный синтаксически. До header нельзя выводить текст или BOM. Требования доступа/хранилища, лимиты и политика кеширования задаются приложением; bytes не пропускают через htmlspecialchars.

<?php
declare(strict_types=1);

var_dump(function_exists('read_exif_data'));
var_dump(function_exists('exif_read_data'));

bool(false)
bool(true)

Ожидаемый вывод относится к PHP 8 с включённым exif. Это не повод добавлять старое имя обратно в глобальное пространство приложения.

<?php
declare(strict_types=1);

require __DIR__ . '/exif-lab.php';
$metadata = exif_read_data(__DIR__ . '/lesson.jpg', null, true);
if ($metadata === false) throw new RuntimeException('Не прочитано');
echo $metadata['IFD0']['Model'] ?? 'Нет модели', "\n";

Model A

В старом проекте меняют имя функции, затем проверяют режим массива и путь к ключам. Если раньше не было as_arrays=true, Model находилась на верхнем уровне; механически менять доступ нельзя.