@@ -79,6 +79,10 @@ $build->wait();
 Do not pre-URL-encode the JSON options. Declare `ARG APP_MODE` in the Dockerfile
 if the build uses it. Build arguments are not a safe channel for secrets.
 
+To apply several tags, pass a list to `t`, for example
+`'t' => ['docker-php-example:latest', 'docker-php-example:1.0']`. Docker PHP
+sends one `t` parameter per tag. Lists require client `3.3.0` or later.
+
 A streamed context is consumed by the first request. The original tar process
 is not rewindable. Keep the context alive until the request has
 finished, and do not assume a process-backed stream has a known byte length.
 
@@ -131,6 +131,34 @@ public function execStartInteractive(string $id, ?ExecIdStartPostBody $requestBo
     /**
      * {@inheritdoc}
      *
+     * @param array{
+     *    "dockerfile"?: string,
+     *    "t"?: string|list<string>,
+     *    "extrahosts"?: string,
+     *    "remote"?: string,
+     *    "q"?: bool,
+     *    "nocache"?: bool,
+     *    "cachefrom"?: string,
+     *    "pull"?: string,
+     *    "rm"?: bool,
+     *    "forcerm"?: bool,
+     *    "memory"?: int,
+     *    "memswap"?: int,
+     *    "cpushares"?: int,
+     *    "cpusetcpus"?: string,
+     *    "cpuperiod"?: int,
+     *    "cpuquota"?: int,
+     *    "buildargs"?: string,
+     *    "shmsize"?: int,
+     *    "squash"?: bool,
+     *    "labels"?: string,
+     *    "networkmode"?: string,
+     *    "platform"?: string,
+     *    "target"?: string,
+     *    "outputs"?: string,
+     *    "version"?: string,
+     * } $queryParameters
+     *
      * @return ($fetch is 'object' ? BuildStream|null : ResponseInterface)
      */
     public function imageBuild($requestBody = null, array $queryParameters = [], array $headerParameters = [], string $fetch = self::FETCH_OBJECT)
 
@@ -9,6 +9,8 @@
 use Docker\Stream\TarStream;
 use Nyholm\Psr7\Stream;
 use Psr\Http\Message\ResponseInterface;
+use Symfony\Component\OptionsResolver\Options;
+use Symfony\Component\OptionsResolver\OptionsResolver;
 use Symfony\Component\Serializer\SerializerInterface;
 
 class ImageBuild extends BaseEndpoint
@@ -24,6 +26,21 @@ public function getBody(SerializerInterface $serializer, $streamFactory = null):
         return [['Content-Type' => ['application/octet-stream']], $body];
     }
 
+    protected function getQueryOptionsResolver(): OptionsResolver
+    {
+        $optionsResolver = parent::getQueryOptionsResolver();
+        // Docker applies each repeated `t` parameter as a separate tag.
+        $optionsResolver->setAllowedTypes('t', ['string', 'string[]']);
+        $optionsResolver->setNormalizer('t', static fn (Options $options, $value) => \is_array($value) ? array_values($value) : $value);
+
+        return $optionsResolver;
+    }
+
+    protected function getQueryStyles(): array
+    {
+        return ['t' => ['style' => 'form', 'explode' => true]] + parent::getQueryStyles();
+    }
+
     protected function transformResponseBody(ResponseInterface $response, SerializerInterface $serializer, ?string $contentType = null)
     {
         if (200 === $response->getStatusCode()) {
 
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Docker\Tests\Endpoint;
+
+use Docker\Endpoint\ImageBuild;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\OptionsResolver\Exception\InvalidOptionsException;
+
+class ImageBuildTest extends TestCase
+{
+    public static function tagProvider(): iterable
+    {
+        yield 'single tag' => ['app:latest', ['t=app%3Alatest']];
+        yield 'several tags' => [['app:latest', 'app:1.0'], ['t=app%3Alatest', 't=app%3A1.0']];
+        yield 'keyed tags' => [['a' => 'app:latest', 'b' => 'app:1.0'], ['t=app%3Alatest', 't=app%3A1.0']];
+        yield 'no tags' => [[], []];
+    }
+
+    #[DataProvider('tagProvider')]
+    public function testRepeatsTagParameter(string|array $tags, array $expected): void
+    {
+        $query = (new ImageBuild(null, ['t' => $tags]))->getQueryString();
+        $parameters = explode('&', $query);
+
+        $this->assertSame($expected, array_values(array_filter($parameters, static fn (string $pair): bool => str_starts_with($pair, 't='))));
+        $this->assertContains('dockerfile=Dockerfile', $parameters);
+    }
+
+    public function testRejectsNonStringTags(): void
+    {
+        $this->expectException(InvalidOptionsException::class);
+
+        (new ImageBuild(null, ['t' => ['app:latest', 1]]))->getQueryString();
+    }
+}
@@ -40,6 +40,28 @@ public function testBuild(): void
         $this->assertStringContainsString('Successfully', $lastMessage);
     }
 
+    public function testBuildAppliesSeveralTags(): void
+    {
+        $contextBuilder = new ContextBuilder();
+        $contextBuilder->from('busybox:latest');
+        $contextBuilder->add('/test', 'test file content');
+        $context = $contextBuilder->getContext();
+        $tags = ['docker-php-test-tags:one', 'docker-php-test-tags:two'];
+
+        $buildStream = $this->getManager()->imageBuild($context->read(), ['t' => $tags]);
+        $buildStream->wait();
+
+        try {
+            $repoTags = $this->getManager()->imageInspect($tags[0])->getRepoTags();
+            sort($repoTags);
+            $this->assertSame($tags, $repoTags);
+        } finally {
+            foreach ($tags as $tag) {
+                $this->getManager()->imageDelete($tag);
+            }
+        }
+    }
+
     public function testCreate(): void
     {
         $createImageStream = $this->getManager()->imageCreate('', [
 
@@ -16,6 +16,7 @@ function dockerReturnTypes(Docker $docker): void
     assertType('Docker\Stream\DockerRawStream|null', $docker->containerLogs('id'));
     assertType('Docker\Stream\DockerRawStream|null', $docker->execStart('id'));
     assertType('Docker\Stream\BuildStream|null', $docker->imageBuild());
+    assertType('Docker\Stream\BuildStream|null', $docker->imageBuild(null, ['t' => ['app:latest', 'app:1.0']]));
     assertType('Docker\Stream\CreateImageStream|null', $docker->imageCreate());
     assertType('Docker\Stream\PushStream|null', $docker->imagePush('name'));
     assertType('Docker\Stream\EventStream|null', $docker->systemEvents());