1. class
  2. Dagger
  3. \
  4. Client

Client

class Client extends AbstractClient implements IdAble, Node

The root of the DAG.

Properties

protected AbstractClient $client from  AbstractClient
protected Client $graphQlClient from  AbstractClient

Methods

__construct(Client $clientOrConnection, QueryBuilderChain $queryBuilderChain = new QueryBuilderChain())

No description

from  AbstractClient
Results
runQuery(Query $query)

No description

from  AbstractClient
null|array|string|int|float|bool
queryLeaf(Query $query, string $leafKey)

No description

from  AbstractClient
object
loadObjectFromId(string $className, Id $id, string|null $graphQLTypeName = null)

Load an object by its ID using node(id:) with an inline fragment.

from  AbstractClient
Address
address(string $value)

initialize an address to load directories, containers, secrets or other object types.

File
blob(string $name, Bytes $contents, int|null $permissions = 420)

Creates a file from arbitrary binary contents.

CacheVolume
cacheVolume(string $key, Directory|null $source = null, CacheSharingMode|null $sharing = null, string|null $owner = '')

Constructs a cache volume for a given cache key.

Changeset
changeset()

Creates an empty changeset

Cloud
cloud()

Dagger Cloud configuration and state

GeneratedCode
codegen(ModuleSource $modSource, File $introspectionJson)

No description

Container
codegenBase(ModuleSource $modSource, File $introspectionJson)

No description

Container
container(Platform|null $platform = null)

Creates a scratch container, with no image or metadata.

FunctionCall
currentFunctionCall()

The FunctionCall context that the SDK caller is currently executing in.

CurrentModule
currentModule()

The module currently being served in the session, if any.

Node
currentNode()

The object that received the current module function call, as a Node. Errors when there is no current call, or the call is top-level (e.g. a module constructor).

array
currentTypeDefs(bool|null $returnAllTypes = false, bool|null $hideCore = null)

The TypeDef representations of the objects currently being served in the session.

Workspace
currentWorkspace()

Detect and return the current workspace.

Platform
defaultPlatform()

The default platform of the engine.

Directory
directory()

Creates an empty directory.

Engine
engine()

The Dagger engine container configuration and state

Volume
engineVolume(string $name, string|null $subdir = null)

Constructs an engine-managed volume backed by operator-provided storage beneath the configured engine state root.

EnvFile
envFile(bool|null $expand = null)

Initialize an environment file

Error
error(string $message)

Create a new error.

File
file(string $name, string $contents, int|null $permissions = 420)

Creates a file with the specified contents.

Function_
function(string $name, TypeDef $returnType)

Creates a function.

GeneratedCode
generatedCode(Directory $code)

Create a code generation result, given a directory containing the generated code.

GitRepository
git(string $url, bool|null $keepGitDir = true, string|null $sshKnownHosts = '', Socket|null $sshAuthSocket = null, string|null $httpAuthUsername = '', Secret|null $httpAuthToken = null, Secret|null $httpAuthHeader = null, Service|null $experimentalServiceHost = null)

Queries a Git repository.

Host
host()

Queries the host environment.

File
http(string $url, string|null $name = null, int|null $permissions = null, string|null $checksum = null, Secret|null $authHeader = null, Service|null $experimentalServiceHost = null)

Returns a file containing an http remote url content.

Id
id()

A unique identifier for this Query.

JsonValue
json()

Initialize a JSON value

LLM
llm(string|null $model = null, string|null $provider = null)

Initialize a new LLM conversation.

Module
module()

Create a new module.

Container
moduleRuntime(ModuleSource $modSource, File $introspectionJson)

No description

ModuleSource
moduleSource(string $refString, string|null $refPin = '', bool|null $disableFindUp = false, bool|null $allowNotExists = false, ModuleSourceKind|null $requireKind = null)

Create a new module source instance from a source ref string

Node|null
node(Id $id)

Load any object by its ID.

Schema
schema(Json $json)

Load a GraphQL introspection schema for merging.

Secret
secret(string $uri, string|null $cacheKey = null)

Creates a new secret.

Secret
setSecret(string $name, string $plaintext)

Sets a secret given a user defined name to its plaintext and returns the secret.

Directory
sourceDir()

No description

SourceMap
sourceMap(string $filename, int $line, int $column)

Creates source map metadata.

Volume
sshfsVolume(string $endpoint, Secret $privateKey, Secret|null $knownHosts = null, string|null $cacheKey = null, bool|null $insecureSkipHostKeyCheck = false, Service|null $experimentalServiceHost = null)

Constructs an SSHFS volume.

TypeDef
typeDef()

Create a new TypeDef.

string
version()

Get the current Dagger Engine version.

Client
with(Directory|null $sdkSourceDir = null)

Configure the php-sdk constructor arguments.

Details

in AbstractClient at line 22
__construct(Client $clientOrConnection, QueryBuilderChain $queryBuilderChain = new QueryBuilderChain())

No description

Parameters

Client $clientOrConnection
QueryBuilderChain $queryBuilderChain

in AbstractClient at line 35
Results runQuery(Query $query)

No description

Parameters

Query $query

Return Value

Results

in AbstractClient at line 40
null|array|string|int|float|bool queryLeaf(Query $query, string $leafKey)

No description

Parameters

Query $query
string $leafKey

Return Value

null|array|string|int|float|bool

in AbstractClient at line 67
object loadObjectFromId(string $className, Id $id, string|null $graphQLTypeName = null)

Load an object by its ID using node(id:) with an inline fragment.

Parameters

string $className

Fully-qualified PHP class name (e.g. \Dagger\Container)
Id $id

The object's ID
string|null $graphQLTypeName

GraphQL type name when it differs from the PHP class name

Return Value

object

at line 19
Address address(string $value)

initialize an address to load directories, containers, secrets or other object types.

Parameters

string $value

Return Value

Address

at line 29
File blob(string $name, Bytes $contents, int|null $permissions = 420)

Creates a file from arbitrary binary contents.

Parameters

string $name
Bytes $contents
int|null $permissions

Return Value

File

at line 43
CacheVolume cacheVolume(string $key, Directory|null $source = null, CacheSharingMode|null $sharing = null, string|null $owner = '')

Constructs a cache volume for a given cache key.

Parameters

string $key
Directory|null $source
CacheSharingMode|null $sharing
string|null $owner

Return Value

CacheVolume

at line 66
Changeset changeset()

Creates an empty changeset

Return Value

Changeset

at line 75
Cloud cloud()

Dagger Cloud configuration and state

Return Value

Cloud

at line 81
GeneratedCode codegen(ModuleSource $modSource, File $introspectionJson)

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

GeneratedCode

at line 89
Container codegenBase(ModuleSource $modSource, File $introspectionJson)

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

Container

at line 102
Container container(Platform|null $platform = null)

Creates a scratch container, with no image or metadata.

To pull an image, follow up with the "from" function.

Parameters

Platform|null $platform

Return Value

Container

at line 116
FunctionCall currentFunctionCall()

The FunctionCall context that the SDK caller is currently executing in.

If the caller is not currently executing in a function, this will return an error.

Return Value

FunctionCall

at line 125
CurrentModule currentModule()

The module currently being served in the session, if any.

Return Value

CurrentModule

at line 134
Node currentNode()

The object that received the current module function call, as a Node. Errors when there is no current call, or the call is top-level (e.g. a module constructor).

Return Value

Node

at line 143
array currentTypeDefs(bool|null $returnAllTypes = false, bool|null $hideCore = null)

The TypeDef representations of the objects currently being served in the session.

Parameters

bool|null $returnAllTypes
bool|null $hideCore

Return Value

array

at line 158
Workspace currentWorkspace()

Detect and return the current workspace.

Return Value

Workspace

at line 167
Platform defaultPlatform()

The default platform of the engine.

Return Value

Platform

at line 176
Directory directory()

Creates an empty directory.

Return Value

Directory

at line 185
Engine engine()

The Dagger engine container configuration and state

Return Value

Engine

at line 194
Volume engineVolume(string $name, string|null $subdir = null)

Constructs an engine-managed volume backed by operator-provided storage beneath the configured engine state root.

Parameters

string $name
string|null $subdir

Return Value

Volume

at line 207
EnvFile envFile(bool|null $expand = null)

Initialize an environment file

Parameters

bool|null $expand

Return Value

EnvFile

at line 219
Error error(string $message)

Create a new error.

Parameters

string $message

Return Value

Error

at line 229
File file(string $name, string $contents, int|null $permissions = 420)

Creates a file with the specified contents.

Parameters

string $name
string $contents
int|null $permissions

Return Value

File

at line 243
Function_ function(string $name, TypeDef $returnType)

Creates a function.

Parameters

string $name
TypeDef $returnType

Return Value

Function_

at line 254
GeneratedCode generatedCode(Directory $code)

Create a code generation result, given a directory containing the generated code.

Parameters

Directory $code

Return Value

GeneratedCode

at line 264
GitRepository git(string $url, bool|null $keepGitDir = true, string|null $sshKnownHosts = '', Socket|null $sshAuthSocket = null, string|null $httpAuthUsername = '', Secret|null $httpAuthToken = null, Secret|null $httpAuthHeader = null, Service|null $experimentalServiceHost = null)

Queries a Git repository.

Parameters

string $url
bool|null $keepGitDir
string|null $sshKnownHosts
Socket|null $sshAuthSocket
string|null $httpAuthUsername
Secret|null $httpAuthToken
Secret|null $httpAuthHeader
Service|null $experimentalServiceHost

Return Value

GitRepository

at line 303
Host host()

Queries the host environment.

Return Value

Host

at line 312
File http(string $url, string|null $name = null, int|null $permissions = null, string|null $checksum = null, Secret|null $authHeader = null, Service|null $experimentalServiceHost = null)

Returns a file containing an http remote url content.

Parameters

string $url
string|null $name
int|null $permissions
string|null $checksum
Secret|null $authHeader
Service|null $experimentalServiceHost

Return Value

File

at line 343
Id id()

A unique identifier for this Query.

Return Value

Id

at line 352
JsonValue json()

Initialize a JSON value

Return Value

JsonValue

at line 361
LLM llm(string|null $model = null, string|null $provider = null)

Initialize a new LLM conversation.

Parameters

string|null $model
string|null $provider

Return Value

LLM

at line 376
Module module()

Create a new module.

Return Value

Module

at line 382
Container moduleRuntime(ModuleSource $modSource, File $introspectionJson)

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

Container

at line 393
ModuleSource moduleSource(string $refString, string|null $refPin = '', bool|null $disableFindUp = false, bool|null $allowNotExists = false, ModuleSourceKind|null $requireKind = null)

Create a new module source instance from a source ref string

Parameters

string $refString
string|null $refPin
bool|null $disableFindUp
bool|null $allowNotExists
ModuleSourceKind|null $requireKind

Return Value

ModuleSource

at line 420
Node|null node(Id $id)

Load any object by its ID.

Parameters

Id $id

Return Value

Node|null

at line 435
Schema schema(Json $json)

Load a GraphQL introspection schema for merging.

Parameters

Json $json

Return Value

Schema

at line 445
Secret secret(string $uri, string|null $cacheKey = null)

Creates a new secret.

Parameters

string $uri
string|null $cacheKey

Return Value

Secret

at line 460
Secret setSecret(string $name, string $plaintext)

Sets a secret given a user defined name to its plaintext and returns the secret.

The plaintext value is limited to a size of 128000 bytes.

Parameters

string $name
string $plaintext

Return Value

Secret

at line 468
Directory sourceDir()

No description

Return Value

Directory

at line 477
SourceMap sourceMap(string $filename, int $line, int $column)

Creates source map metadata.

Parameters

string $filename
int $line
int $column

Return Value

SourceMap

at line 489
Volume sshfsVolume(string $endpoint, Secret $privateKey, Secret|null $knownHosts = null, string|null $cacheKey = null, bool|null $insecureSkipHostKeyCheck = false, Service|null $experimentalServiceHost = null)

Constructs an SSHFS volume.

Parameters

string $endpoint
Secret $privateKey
Secret|null $knownHosts
string|null $cacheKey
bool|null $insecureSkipHostKeyCheck
Service|null $experimentalServiceHost

Return Value

Volume

at line 518
TypeDef typeDef()

Create a new TypeDef.

Return Value

TypeDef

at line 527
string version()

Get the current Dagger Engine version.

Return Value

string

at line 536
Client with(Directory|null $sdkSourceDir = null)

Configure the php-sdk constructor arguments.

Parameters

Directory|null $sdkSourceDir

Return Value

Client