Отправка изображений через POST на сервер PHP

Раздел: Обработка изображений в PHP -> Загрузка изображений

Основные способы отправки изображений через POST в PHP

Как загрузить изображение через стандартную HTML-форму и обработать на сервере?

Наиболее распространенный и эффективный способ отправки изображений на сервер использует HTML-форму с атрибутом enctype="multipart/form-data" и метод POST. На стороне PHP файл принимается через глобальный массив $_FILES. После проверок файл перемещается в нужную директорию функцией move_uploaded_file().

<form action="upload.php" method="POST" enctype="multipart/form-data">
    <input type="file" name="image" accept="image/*">
    <button type="submit">Загрузить</button>
</form>

Post php images (отправка изображений через post в php)

// upload.php
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
$maxSize = 2 * 1024 * 1024; // 2MB

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['image'])) {
    $file = $_FILES['image'];
    if ($file['error'] !== UPLOAD_ERR_OK) {
        // обработка ошибки
        die('Ошибка загрузки: ' . $file['error']);
    }
    if (!in_array(mime_content_type($file['tmp_name']), $allowedTypes)) {
        die('Недопустимый тип файла');
    }
    if ($file['size'] > $maxSize) {
        die('Файл слишком большой');
    }
    $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
    $newName = uniqid() . '.' . $ext;
    $destination = __DIR__ . '/uploads/' . $newName;
    if (move_uploaded_file($file['tmp_name'], $destination)) {
        echo 'Файл сохранён: ' . $newName;
    }
}

Типичные проблемы и решения:

  • Превышение upload_max_filesize или post_max_size в php.ini. Решение - увеличить значения или проверять размер до загрузки.
  • Проверка только по расширению файла небезопасна. Используйте mime_content_type() или finfo.
  • Имена файлов должны быть уникальными, чтобы избежать перезаписи. Генерация через uniqid() или md5.

Цель варианта:

Используется при разработке собственных сайтов для загрузки аватаров, фотографий в галереи, документов. Без дополнительных библиотек, только нативными средствами PHP.

Как отправить изображение на внешний сервер через cURL?

Для отправки файла на удаленный API (например, облачное хранилище или сервис распознавания) применяется библиотека cURL. Файл передаётся с помощью класса CURLFile.

$url = 'https://api.example.com/upload';
$filePath = '/tmp/test.jpg';
$cfile = new CURLFile($filePath, 'image/jpeg', 'photo.jpg');

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => $cfile]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Проблемы: отсутствие расширения cURL, неверный MIME-тип, ограничения на стороне сервера. Решение - проверять наличие расширения, явно указывать MIME, использовать CURLOPT_TIMEOUT.

Как отправить изображение в виде base64 в теле запроса (JSON/XML)?

Иногда API требует передавать файл в виде строки base64 внутри JSON. Файл кодируется функцией base64_encode() и отправляется обычным POST-запросом.

$imageData = file_get_contents('photo.jpg');
$base64 = base64_encode($imageData);
$payload = json_encode(['image' => $base64, 'filename' => 'photo.jpg']);

$ch = curl_init('https://api.example.com/upload-json');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Проблемы: увеличение размера данных на 33%, ограничения по размеру POST-запроса. Решение - использовать только для небольших файлов.

Как использовать HTTP-клиент Guzzle для отправки изображений?

Библиотека Guzzle упрощает работу с HTTP-запросами. Для multipart-запросов используется метод MultipartStream или передача массива с ключом 'contents'.

use GuzzleHttp\Client;
$client = new Client();

$response = $client->post('https://api.example.com/upload', [
    'multipart' => [
        [
            'name'     => 'image',
            'contents' => fopen('photo.jpg', 'r'),
            'filename' => 'photo.jpg'
        ]
    ]
]);
echo $response->getBody();

Ошибки: отсутствие Guzzle в проекте (необходимо composer require guzzlehttp/guzzle), неверный путь к файлу.

Расширенные примеры отправки и обработки изображений

Пример 1. Полный скрипт загрузки с валидацией и генерацией имени

Пример 
<?php
// upload_image.php
$uploadDir = __DIR__ . '/uploads/';
$allowedMimes = ['image/jpeg' => 'jpg', 'image/png' => 'png', 'image/gif' => 'gif'];
$maxSize = 5 * 1024 * 1024; // 5MB

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $file = $_FILES['file'];
    if ($file['error'] !== UPLOAD_ERR_OK) {
        die('Ошибка: ' . $file['error']);
    }
    $tmpPath = $file['tmp_name'];
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $tmpPath);
    finfo_close($finfo);
    if (!array_key_exists($mime, $allowedMimes)) {
        die('Недопустимый MIME-тип');
    }
    if ($file['size'] > $maxSize) {
        die('Превышен максимальный размер');
    }
    $ext = $allowedMimes[$mime];
    $newName = md5_file($tmpPath) . '.' . $ext;
    $destination = $uploadDir . $newName;
    if (move_uploaded_file($tmpPath, $destination)) {
        echo 'Файл сохранён как ' . $newName;
    } else {
        die('Не удалось переместить файл');
    }
} else {
    echo 'Отправьте файл через POST.';
}
Файл сохранён как d41d8cd98f00b204e9800998ecf8427e.jpg

Пример 2. Отправка изображения на API с авторизацией через cURL

Пример 
<?php
$apiUrl = 'https://api.imgbb.com/1/upload';
$apiKey = 'your_api_key';
$filePath = '/path/to/image.png';

$cfile = new CURLFile($filePath, 'image/png', 'image.png');
$postData = [
    'key'   => $apiKey,
    'image' => $cfile
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
if (curl_error($ch)) {
    die('cURL error: ' . curl_error($ch));
}
curl_close($ch);
echo $response;
{
    "status": 200,
    "data": {
        "url": "https://i.imgur.com/abc123.png"
    }
}

Пример 3. Прием и обработка изображения в формате base64 из POST-запроса

Пример 
<?php
$data = file_get_contents('php://input');
$json = json_decode($data, true);
if (!$json || !isset($json['image'])) {
    die('Нет изображения');
}
$base64 = $json['image'];
// Отделяем префикс data:image/...;base64, если пришёл data URI
if (preg_match('/^data:image\/([a-z]+);base64,/', $base64, $matches)) {
    $ext = $matches[1];
    $base64 = substr($base64, strpos($base64, ',') + 1);
} else {
    $ext = 'png'; // по умолчанию
}
$binaryData = base64_decode($base64, true);
if ($binaryData === false) {
    die('Некорректная base64 строка');
}
$newName = uniqid() . '.' . $ext;
file_put_contents(__DIR__ . '/uploads/' . $newName, $binaryData);
echo 'Сохранено: ' . $newName;
Сохранено: 6453f2c1a2b3.png

Пример 4. Использование Guzzle для массовой отправки нескольких изображений

Пример 
<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Utils;

$client = new Client();
$files = [
    'file1' => Utils::tryFopen('img1.jpg', 'r'),
    'file2' => Utils::tryFopen('img2.jpg', 'r'),
];

$response = $client->post('https://example.com/upload-multiple', [
    'multipart' => [
        ['name' => 'photos[]', 'contents' => $files['file1'], 'filename' => 'img1.jpg'],
        ['name' => 'photos[]', 'contents' => $files['file2'], 'filename' => 'img2.jpg']
    ]
]);
echo $response->getStatusCode(); // 200
200

Пример 5. Обработка ошибок загрузки и логирование

Пример 
<?php
$errors = [];
if ($_FILES['file']['error'] === UPLOAD_ERR_INI_SIZE) {
    $errors[] = 'Файл превышает upload_max_filesize';
} elseif ($_FILES['file']['error'] === UPLOAD_ERR_FORM_SIZE) {
    $errors[] = 'Файл превышает MAX_FILE_SIZE в форме';
} elseif ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    $errors[] = 'Неизвестная ошибка с кодом ' . $_FILES['file']['error'];
}
if (!empty($errors)) {
    error_log(implode(', ', $errors) . ' - ' . date('Y-m-d H:i:s'));
    die(implode('<br>', $errors));
}
// далее обработка файла
Файл превышает upload_max_filesize

Отправка изображений через POST в PHP - comments

En
Post php images (php)