Как управлять Docker из PHP: от exec до Docker SDK

Расширенные примеры выполнения команд Docker из PHP

Пример 1: Управление контейнерами через Docker PHP SDK

Полный пример: создание контейнера из образа, запуск, ожидание и получение логов.

use Docker\DockerClient;
use Docker\API\Exception\ContainerCreateConflictException;

$client = DockerClient::createUnixSocketClient();

// 1. Скачиваем образ, если его нет
$images = $client->images();
try {
    $images->pull('busybox', 'latest');
} catch (\Exception $e) {
    echo "Образ уже есть или не удалось скачать: " . $e->getMessage() . "\n";
}

// 2. Создаем контейнер
$config = [
    'Image' => 'busybox',
    'Cmd' => ['/bin/sh', '-c', 'for i in 1 2 3; do echo "Line $i"; sleep 1; done']
];
$container = $client->containers()->create($config);
$containerId = $container->getId();
echo "Создан контейнер $containerId\n";

// 3. Запускаем
$container->start();
echo "Контейнер запущен\n";

// 4. Ждем завершения
$container->wait();

// 5. Получаем логи
$logs = $container->logs()->getContents();
echo "Логи:\n" . $logs . "\n";

// 6. Удаляем контейнер
$container->remove(['force' => true]);

Создан контейнер abc123def
Контейнер запущен
Логи:
Line 1
Line 2
Line 3

Пример 2: Запуск docker-compose через exec с обработкой ошибок

Предположим, есть файл docker-compose.yml. Запускаем сборку и получаем вывод.

$projectDir = '/var/www/app';
$command = "docker-compose -f {$projectDir}/docker-compose.yml up -d 2>&1";
$output = [];
$retCode = 0;
exec($command, $output, $retCode);

if ($retCode !== 0) {
    echo "Ошибка выполнения docker-compose:\n" . implode("\n", $output);
} else {
    echo "Сервисы запущены:\n" . implode("\n", $output);
}

Сервисы запущены:
Container nginx  Started
Container php-fpm  Started

Важно: использование 2>&1 для перенаправления stderr в stdout, иначе ошибки не отобразятся.

Пример 3: Асинхронный запуск нескольких контейнеров через proc_open

Запускаем два контейнера параллельно и собираем их выводы.

$commands = [
    'docker run alpine echo "First"',
    'docker run alpine echo "Second"'
];
$processes = [];
foreach ($commands as $index => $cmd) {
    $descriptors = [
        0 => ['pipe', 'r'],
        1 => ['pipe', 'w'],
        2 => ['pipe', 'w']
    ];
    $process = proc_open($cmd, $descriptors, $pipes);
    $processes[] = ['process' => $process, 'pipes' => $pipes, 'index' => $index];
}

// Закрываем stdin для всех процессов
foreach ($processes as &$p) {
    fclose($p['pipes'][0]);
    // Неблокирующее чтение
    stream_set_blocking($p['pipes'][1], false);
    stream_set_blocking($p['pipes'][2], false);
}

// Собираем вывод
$outputs = [];
$errors = [];
foreach ($processes as &$p) {
    $out = stream_get_contents($p['pipes'][1]);
    $err = stream_get_contents($p['pipes'][2]);
    fclose($p['pipes'][1]);
    fclose($p['pipes'][2]);
    proc_close($p['process']);
    $outputs[] = $out;
    $errors[] = $err;
}

foreach ($outputs as $i => $o) {
    echo "Вывод процесса $i: $o\n";
}
foreach ($errors as $i => $e) {
    if ($e) echo "Ошибка процесса $i: $e\n";
}

Вывод процесса 0: First

Вывод процесса 1: Second

Обратите внимание: вывод включает перевод строки. При неблокирующем чтении данные могут быть неполными, если процесс ещё не завершился. В реальных сценариях необходимо ожидание завершения через proc_get_status().

Пример 4: Получение информации о контейнерах через REST API Docker с помощью cURL

Запрос списка всех контейнеров (включая остановленные) и форматированный вывод.

$socketPath = '/var/run/docker.sock';
$url = 'http://localhost/containers/json?all=true';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_UNIX_SOCKET_PATH, $socketPath);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

if ($response === false) {
    echo "cURL error: " . curl_error($ch) . "\n";
} else {
    $containers = json_decode($response, true);
    foreach ($containers as $ct) {
        echo "ID: " . substr($ct['Id'], 0, 12) . "\n";
        echo "Image: " . $ct['Image'] . "\n";
        echo "State: " . $ct['State'] . "\n";
        echo "Names: " . implode(', ', $ct['Names']) . "\n";
        echo str_repeat('-', 30) . "\n";
    }
}

ID: abc123def456
Image: nginx:latest
State: running
Names: /webserver
------------------------------
ID: 789012345678
Image: redis:alpine
State: exited
Names: /cache
------------------------------

Этот подход даёт максимум гибкости, но требует знания Docker REST API и обработки потоковых ответов.