Choose a Docker Engine API version and how requests negotiate with the daemon.
Choose an API version
Docker PHP 4.1 works with Docker Engine API v1.45 to v1.57. Each version has its
own docker-php/docker-php-api release line with generated endpoints and
models. Without a direct API requirement, Composer installs the newest line.To use a specific version, require its line next to the client:
Pin a line if your code names generated models or calls methods that differ
between versions. Docker renames models and changes fields between API versions;
for example, API 1.48 replaced ContainersIdJsonGetResponse200 with
ContainerInspectResponse, and API 1.52 removed getError() from build, pull and
push progress frames. Check Docker’s
API version history
and the Docker Engine API reference
for the version you use.
Package versions
docker-php/docker-php follows semantic versioning.docker-php/docker-php-api uses a four-part scheme:
Jane-major.Docker-major.Docker-minor.revision. For example, 7.1.57.0 means
Docker Engine API v1.57, generated with Jane 7, revision 0. Keep a direct API
requirement within one line, as above. A constraint such as ^7.1.45.0 allows
every newer Docker specification.
Request URL version
The bundled factory negotiates the version in request URLs. Before the first
request it sends an unversioned /_ping and reads the daemon’s maximum API
version from the response. Requests then use the lower of that version and the
installed API line, as the Docker CLI does. An older daemon keeps working with a
newer API package, and requests never ask for a version the installed models do
not describe. DockerClientFactory::defaultApiVersion() returns the installed
line’s version.To skip negotiation, set the version yourself. DOCKER_API_VERSION sets it from
the environment:
DOCKER_API_VERSION=1.51 php your-script.php
The factory’s api_version option sets it in PHP and overrides the environment:
Both 1.51 and v1.51 are accepted. The fourth argument disables the generated
server plugins because the factory already adds the API path.A client you build yourself, such as Guzzle, does not negotiate.
The generated server plugins prefix requests with the installed line’s version,
so install a line your daemon supports.
Changing the URL version does not regenerate models or add newer fields and
endpoints. With an older daemon, fields added after its API version are absent
from responses and ignored in requests.
Generated code
Each line is generated from Docker’s specification for that version with Jane
7.14.4, without local patches. The API repository has one branch per line,
such as 7.1.57; see its
generation instructions.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docker PHP","description":"Documentation for the Docker PHP 3.0 client and its generated Docker Engine API models.","colors":{"primary":"#1D63ED","light":"#1D63ED","dark":"#60A5FA"},"navbar":{"links":[{"href":"https://docs.docker.com/reference/api/engine/","label":"Engine API"},{"href":"https://github.com/docker-php/docker-php/issues","label":"Issues"}],"primary":{"type":"github","href":"https://github.com/docker-php/docker-php"}},"footer":{"socials":{"github":"https://github.com/docker-php/docker-php"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docker-php","hasAudioNarration":false,"actualSubdomain":"docker-php","customDomains":[],"gitSource":{"type":"github","owner":"docker-php","repo":"docker-php","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afb191864ef06e8fe2f2de3","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Reference","count":5},{"language":"default","tag":"Get started","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-versions","slug":"/api-versions","pageMetadata":{"title":"API versions","description":"Choose a Docker Engine API version and how requests negotiate with the daemon.","href":"/api-versions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose a Docker Engine API version and how requests negotiate with the daemon.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`choose-an-api-version`,children:`Choose an API version`}),`\n`,_jsxs(_components.p,{children:[`Docker PHP 4.1 works with Docker Engine API v1.45 to v1.57. Each version has its\nown `,_jsx(_components.code,{children:`docker-php/docker-php-api`}),` release line with generated endpoints and\nmodels. Without a direct API requirement, Composer installs the newest line.`]}),`\n`,_jsx(_components.p,{children:`To use a specific version, require its line next to the client:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`composer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` require`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"docker-php/docker-php:^4.0\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"docker-php/docker-php-api:>=7.1.51.0 \u003c7.1.52.0\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Pin a line if your code names generated models or calls methods that differ\nbetween versions. Docker renames models and changes fields between API versions;\nfor example, API 1.48 replaced `,_jsx(_components.code,{children:`ContainersIdJsonGetResponse200`}),` with\n`,_jsx(_components.code,{children:`ContainerInspectResponse`}),`, and API 1.52 removed `,_jsx(_components.code,{children:`getError()`}),` from build, pull and\npush progress frames. Check Docker’s\n`,_jsx(_components.a,{href:`https://docs.docker.com/reference/api/engine/version-history/`,children:`API version history`}),`\nand the `,_jsx(_components.a,{href:`https://docs.docker.com/reference/api/engine/`,children:`Docker Engine API reference`}),`\nfor the version you use.`]}),`\n`,_jsx(Heading,{level:`2`,id:`package-versions`,children:`Package versions`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`docker-php/docker-php`}),` follows semantic versioning.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`docker-php/docker-php-api`}),` uses a four-part scheme:\n`,_jsx(_components.code,{children:`Jane-major.Docker-major.Docker-minor.revision`}),`. For example, `,_jsx(_components.code,{children:`7.1.57.0`}),` means\nDocker Engine API v1.57, generated with Jane 7, revision 0. Keep a direct API\nrequirement within one line, as above. A constraint such as `,_jsx(_components.code,{children:`^7.1.45.0`}),` allows\nevery newer Docker specification.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-url-version`,children:`Request URL version`}),`\n`,_jsxs(_components.p,{children:[`The bundled factory negotiates the version in request URLs. Before the first\nrequest it sends an unversioned `,_jsx(_components.code,{children:`/_ping`}),` and reads the daemon’s maximum API\nversion from the response. Requests then use the lower of that version and the\ninstalled API line, as the Docker CLI does. An older daemon keeps working with a\nnewer API package, and requests never ask for a version the installed models do\nnot describe. `,_jsx(_components.code,{children:`DockerClientFactory::defaultApiVersion()`}),` returns the installed\nline’s version.`]}),`\n`,_jsxs(_components.p,{children:[`To skip negotiation, set the version yourself. `,_jsx(_components.code,{children:`DOCKER_API_VERSION`}),` sets it from\nthe environment:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`DOCKER_API_VERSION`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`1.51`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` php`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your-script.php`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The factory’s `,_jsx(_components.code,{children:`api_version`}),` option sets it in PHP and overrides the environment:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`php`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`php`,children:_jsxs(_components.code,{language:`php`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c?`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`php`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`use`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` Docker\\\\`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`Docker`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`use`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` Docker\\\\`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`DockerClientFactory`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$httpClient`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` DockerClientFactory`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`::`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`([`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'remote_socket'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'unix:///var/run/docker.sock'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'api_version'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '1.51'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$docker`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` Docker`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`::`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$httpClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, [], [], `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Both `,_jsx(_components.code,{children:`1.51`}),` and `,_jsx(_components.code,{children:`v1.51`}),` are accepted. The fourth argument disables the generated\nserver plugins because the factory already adds the API path.`]}),`\n`,_jsxs(_components.p,{children:[`A client you build yourself, such as `,_jsx(_components.a,{href:`/guides/guzzle`,children:`Guzzle`}),`, does not negotiate.\nThe generated server plugins prefix requests with the installed line’s version,\nso install a line your daemon supports.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Changing the URL version does not regenerate models or add newer fields and\nendpoints. With an older daemon, fields added after its API version are absent\nfrom responses and ignored in requests.`})}),`\n`,_jsx(Heading,{level:`2`,id:`generated-code`,children:`Generated code`}),`\n`,_jsxs(_components.p,{children:[`Each line is generated from Docker’s specification for that version with Jane\n7.14.4, without local patches. The API repository has one branch per line,\nsuch as `,_jsx(_components.a,{href:`https://github.com/docker-php/docker-php-api/tree/7.1.57`,children:_jsx(_components.code,{children:`7.1.57`})}),`; see its\n`,_jsx(_components.a,{href:`https://github.com/docker-php/docker-php-api#generation`,children:`generation instructions`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"API versions","description":"Choose a Docker Engine API version and how requests negotiate with the daemon.","href":"/api-versions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Choose an API version","slug":"choose-an-api-version","depth":2,"children":[]},{"title":"Package versions","slug":"package-versions","depth":2,"children":[]},{"title":"Request URL version","slug":"request-url-version","depth":2,"children":[]},{"title":"Generated code","slug":"generated-code","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"docker-php","siteName":"Docker PHP","title":"API versions - Docker PHP","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T14:54:20.737Z","originalFileLocation":"api-versions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose a Docker Engine API version and how requests negotiate with the daemon.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Docker PHP\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/docker-php/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/docker-php/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/docker-php/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/docker-php/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"API versions - Docker PHP\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose a Docker Engine API version and how requests negotiate with the daemon.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Docker PHP\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docker-php.mintlify.app/api-versions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docker-php.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=API+versions\u0026amp;description=Choose+a+Docker+Engine+API+version+and+how+requests+negotiate+with+the+daemon.\u0026amp;theme=d133bb8ac09c75ba2f823685\u0026amp;signature=801127f4585e3f974ea741359bba612155bc066b1a400f9de0b816fecb108735\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"API versions - Docker PHP\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose a Docker Engine API version and how requests negotiate with the daemon.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docker-php.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=API+versions\u0026amp;description=Choose+a+Docker+Engine+API+version+and+how+requests+negotiate+with+the+daemon.\u0026amp;theme=d133bb8ac09c75ba2f823685\u0026amp;signature=801127f4585e3f974ea741359bba612155bc066b1a400f9de0b816fecb108735\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/docker-php/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docker PHP\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D63ED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docker-php.mintlify.app/api-versions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-versions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docker-php.mintlify.app/#organization\",\"name\":\"Docker PHP\",\"url\":\"https://docker-php.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://docker-php.mintlify.app#website\",\"name\":\"Docker PHP\",\"url\":\"https://docker-php.mintlify.app\",\"publisher\":{\"@id\":\"https://docker-php.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docker-php.mintlify.app/api-versions#webpage\",\"url\":\"https://docker-php.mintlify.app/api-versions\",\"name\":\"API versions\",\"description\":\"Choose a Docker Engine API version and how requests negotiate with the daemon.\",\"dateModified\":\"2026-11-16T14:54:20.737Z\",\"isPartOf\":{\"@id\":\"https://docker-php.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://docker-php.mintlify.app/api-versions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docker-php.mintlify.app/api-versions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docker-php.mintlify.app/reference/requests-and-responses\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API versions\",\"item\":\"https://docker-php.mintlify.app/api-versions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docker-php.mintlify.app/api-versions#article\",\"headline\":\"API versions\",\"name\":\"API versions\",\"description\":\"Choose a Docker Engine API version and how requests negotiate with the daemon.\",\"url\":\"https://docker-php.mintlify.app/api-versions\",\"mainEntityOfPage\":{\"@id\":\"https://docker-php.mintlify.app/api-versions#webpage\"},\"dateModified\":\"2026-11-16T14:54:20.737Z\",\"publisher\":{\"@id\":\"https://docker-php.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docker-php.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docker PHP\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Docker PHP\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-versions.md","siteName":"Docker PHP","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Docker PHP","href":"/index"},{"title":"Installation","href":"/installation"},{"title":"Connection settings","href":"/connection"},{"title":"Basic usage","href":"/basic"}]},{"group":"Guides","pages":[{"title":"HTTP clients","href":"/guides/guzzle"},{"title":"Run a container","href":"/cookbook/container-run"},{"title":"Configure a container","href":"/cookbook/container-config"},{"title":"Container logs","href":"/guides/logs"},{"title":"Command output","href":"/guides/exec"},{"title":"Interactive exec","href":"/guides/interactive-exec"},{"title":"Build an image","href":"/cookbook/build-image"},{"title":"Pull and push images","href":"/guides/registry"},{"title":"Copy files with tar archives","href":"/guides/archives"},{"title":"Save and load images","href":"/guides/image-transfer"},{"title":"Events and resource stats","href":"/guides/events-and-stats"}]},{"group":"Reference","pages":[{"title":"Requests and responses","href":"/reference/requests-and-responses"},{"title":"Streaming and special calls","description":"Find the calls which return streams, binary bodies, headers or untyped data.","href":"/reference/streams"},{"title":"API versions","href":"/api-versions"},{"title":"Upgrade to 4.0","description":"Migrate from the original 2.x client, the Beluga fork or 3.x.","href":"/migration"},{"title":"Contribute to the docs","href":"/contributing"}]}]},"basePath":"","title":"API versions - Docker PHP","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}