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

Client

class Client extends AbstractClient

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
CacheVolume
cacheVolume(string $key, string|null $namespace = '')

Constructs a cache volume for a given cache key.

Container
container(Platform|null $platform = null)

Creates a scratch container.

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.

array
currentTypeDefs()

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

Platform
defaultPlatform()

The default platform of the engine.

Directory
directory()

Creates an empty directory.

Engine
engine()

The Dagger engine container configuration and state

Env
env()

Initialize a new environment

Error
error(string $message)

Create a new error.

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, Service|null $experimentalServiceHost = null, string|null $sshKnownHosts = '', Socket|null $sshAuthSocket = null)

Queries a Git repository.

Host
host()

Queries the host environment.

File
http(string $url, Service|null $experimentalServiceHost = null)

Returns a file containing an http remote url content.

LLM
llm(string|null $model = null, int|null $maxAPICalls = null)

Initialize a Large Language Model (LLM)

Binding
loadBindingFromID(Binding $id)

Load a Binding from its ID.

CacheVolume
loadCacheVolumeFromID(CacheVolume $id)

Load a CacheVolume from its ID.

Container
loadContainerFromID(Container $id)

Load a Container from its ID.

CurrentModule
loadCurrentModuleFromID(CurrentModule $id)

Load a CurrentModule from its ID.

Directory
loadDirectoryFromID(Directory $id)

Load a Directory from its ID.

EngineCacheEntry
loadEngineCacheEntryFromID(EngineCacheEntry $id)

Load a EngineCacheEntry from its ID.

EngineCacheEntrySet
loadEngineCacheEntrySetFromID(EngineCacheEntrySet $id)

Load a EngineCacheEntrySet from its ID.

EngineCache
loadEngineCacheFromID(EngineCache $id)

Load a EngineCache from its ID.

Engine
loadEngineFromID(Engine $id)

Load a Engine from its ID.

EnumTypeDef
loadEnumTypeDefFromID(EnumTypeDef $id)

Load a EnumTypeDef from its ID.

EnumValueTypeDef
loadEnumValueTypeDefFromID(EnumValueTypeDef $id)

Load a EnumValueTypeDef from its ID.

Env
loadEnvFromID(Env $id)

Load a Env from its ID.

EnvVariable
loadEnvVariableFromID(EnvVariable $id)

Load a EnvVariable from its ID.

Error
loadErrorFromID(Error $id)

Load a Error from its ID.

ErrorValue
loadErrorValueFromID(ErrorValue $id)

Load a ErrorValue from its ID.

FieldTypeDef
loadFieldTypeDefFromID(FieldTypeDef $id)

Load a FieldTypeDef from its ID.

File
loadFileFromID(File $id)

Load a File from its ID.

FunctionArg
loadFunctionArgFromID(FunctionArg $id)

Load a FunctionArg from its ID.

FunctionCallArgValue
loadFunctionCallArgValueFromID(FunctionCallArgValue $id)

Load a FunctionCallArgValue from its ID.

FunctionCall
loadFunctionCallFromID(FunctionCall $id)

Load a FunctionCall from its ID.

Function_
loadFunctionFromID(Function_ $id)

Load a Function from its ID.

GeneratedCode
loadGeneratedCodeFromID(GeneratedCode $id)

Load a GeneratedCode from its ID.

GitRef
loadGitRefFromID(GitRef $id)

Load a GitRef from its ID.

GitRepository
loadGitRepositoryFromID(GitRepository $id)

Load a GitRepository from its ID.

Host
loadHostFromID(Host $id)

Load a Host from its ID.

InputTypeDef
loadInputTypeDefFromID(InputTypeDef $id)

Load a InputTypeDef from its ID.

InterfaceTypeDef
loadInterfaceTypeDefFromID(InterfaceTypeDef $id)

Load a InterfaceTypeDef from its ID.

LLM
loadLLMFromID(LLM $id)

Load a LLM from its ID.

LLMTokenUsage
loadLLMTokenUsageFromID(LLMTokenUsage $id)

Load a LLMTokenUsage from its ID.

Label
loadLabelFromID(Label $id)

Load a Label from its ID.

ListTypeDef
loadListTypeDefFromID(ListTypeDef $id)

Load a ListTypeDef from its ID.

ModuleConfigClient
loadModuleConfigClientFromID(ModuleConfigClient $id)

Load a ModuleConfigClient from its ID.

Module
loadModuleFromID(Module $id)

Load a Module from its ID.

ModuleSource
loadModuleSourceFromID(ModuleSource $id)

Load a ModuleSource from its ID.

ObjectTypeDef
loadObjectTypeDefFromID(ObjectTypeDef $id)

Load a ObjectTypeDef from its ID.

PhpSdk
loadPhpSdkFromID(PhpSdk $id)

Load a PhpSdk from its ID.

Port
loadPortFromID(Port $id)

Load a Port from its ID.

SDKConfig
loadSDKConfigFromID(SDKConfig $id)

Load a SDKConfig from its ID.

ScalarTypeDef
loadScalarTypeDefFromID(ScalarTypeDef $id)

Load a ScalarTypeDef from its ID.

Secret
loadSecretFromID(Secret $id)

Load a Secret from its ID.

Secret
loadSecretFromName(string $name, string|null $accessor = null)

Load a Secret from its Name.

Service
loadServiceFromID(Service $id)

Load a Service from its ID.

Socket
loadSocketFromID(Socket $id)

Load a Socket from its ID.

SourceMap
loadSourceMapFromID(SourceMap $id)

Load a SourceMap from its ID.

Terminal
loadTerminalFromID(Terminal $id)

Load a Terminal from its ID.

TypeDef
loadTypeDefFromID(TypeDef $id)

Load a TypeDef from its ID.

Module
module()

Create a new module.

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

PhpSdk
phpSdk(Directory|null $sdkSourceDir = null)

No description

Secret
secret(string $uri)

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.

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

Creates source map metadata.

TypeDef
typeDef()

Create a new TypeDef.

string
version()

Get the current Dagger Engine version.

Details

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

No description

Parameters

Client $clientOrConnection
QueryBuilderChain $queryBuilderChain

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

No description

Parameters

Query $query

Return Value

Results

in AbstractClient at line 38
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

at line 19
CacheVolume cacheVolume(string $key, string|null $namespace = '')

Constructs a cache volume for a given cache key.

Parameters

string $key
string|null $namespace

Return Value

CacheVolume

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

Creates a scratch container.

Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.

Parameters

Platform|null $platform

Return Value

Container

at line 48
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 57
CurrentModule currentModule()

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

Return Value

CurrentModule

at line 66
array currentTypeDefs()

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

Return Value

array

at line 75
Platform defaultPlatform()

The default platform of the engine.

Return Value

Platform

at line 84
Directory directory()

Creates an empty directory.

Return Value

Directory

at line 93
Engine engine()

The Dagger engine container configuration and state

Return Value

Engine

at line 102
Env env()

Initialize a new environment

Return Value

Env

at line 111
Error error(string $message)

Create a new error.

Parameters

string $message

Return Value

Error

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

Creates a function.

Parameters

string $name
TypeDef $returnType

Return Value

Function_

at line 132
GeneratedCode generatedCode(Directory $code)

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

Parameters

Directory $code

Return Value

GeneratedCode

at line 142
GitRepository git(string $url, bool|null $keepGitDir = true, Service|null $experimentalServiceHost = null, string|null $sshKnownHosts = '', Socket|null $sshAuthSocket = null)

Queries a Git repository.

Parameters

string $url
bool|null $keepGitDir
Service|null $experimentalServiceHost
string|null $sshKnownHosts
Socket|null $sshAuthSocket

Return Value

GitRepository

at line 169
Host host()

Queries the host environment.

Return Value

Host

at line 178
File http(string $url, Service|null $experimentalServiceHost = null)

Returns a file containing an http remote url content.

Parameters

string $url
Service|null $experimentalServiceHost

Return Value

File

at line 191
LLM llm(string|null $model = null, int|null $maxAPICalls = null)

Initialize a Large Language Model (LLM)

Parameters

string|null $model
int|null $maxAPICalls

Return Value

LLM

at line 206
Binding loadBindingFromID(Binding $id)

Load a Binding from its ID.

Parameters

Binding $id

Return Value

Binding

at line 216
CacheVolume loadCacheVolumeFromID(CacheVolume $id)

Load a CacheVolume from its ID.

Parameters

CacheVolume $id

Return Value

CacheVolume

at line 226
Container loadContainerFromID(Container $id)

Load a Container from its ID.

Parameters

Container $id

Return Value

Container

at line 236
CurrentModule loadCurrentModuleFromID(CurrentModule $id)

Load a CurrentModule from its ID.

Parameters

CurrentModule $id

Return Value

CurrentModule

at line 246
Directory loadDirectoryFromID(Directory $id)

Load a Directory from its ID.

Parameters

Directory $id

Return Value

Directory

at line 256
EngineCacheEntry loadEngineCacheEntryFromID(EngineCacheEntry $id)

Load a EngineCacheEntry from its ID.

Parameters

EngineCacheEntry $id

Return Value

EngineCacheEntry

at line 266
EngineCacheEntrySet loadEngineCacheEntrySetFromID(EngineCacheEntrySet $id)

Load a EngineCacheEntrySet from its ID.

Parameters

EngineCacheEntrySet $id

Return Value

EngineCacheEntrySet

at line 276
EngineCache loadEngineCacheFromID(EngineCache $id)

Load a EngineCache from its ID.

Parameters

EngineCache $id

Return Value

EngineCache

at line 286
Engine loadEngineFromID(Engine $id)

Load a Engine from its ID.

Parameters

Engine $id

Return Value

Engine

at line 296
EnumTypeDef loadEnumTypeDefFromID(EnumTypeDef $id)

Load a EnumTypeDef from its ID.

Parameters

EnumTypeDef $id

Return Value

EnumTypeDef

at line 306
EnumValueTypeDef loadEnumValueTypeDefFromID(EnumValueTypeDef $id)

Load a EnumValueTypeDef from its ID.

Parameters

EnumValueTypeDef $id

Return Value

EnumValueTypeDef

at line 316
Env loadEnvFromID(Env $id)

Load a Env from its ID.

Parameters

Env $id

Return Value

Env

at line 326
EnvVariable loadEnvVariableFromID(EnvVariable $id)

Load a EnvVariable from its ID.

Parameters

EnvVariable $id

Return Value

EnvVariable

at line 336
Error loadErrorFromID(Error $id)

Load a Error from its ID.

Parameters

Error $id

Return Value

Error

at line 346
ErrorValue loadErrorValueFromID(ErrorValue $id)

Load a ErrorValue from its ID.

Parameters

ErrorValue $id

Return Value

ErrorValue

at line 356
FieldTypeDef loadFieldTypeDefFromID(FieldTypeDef $id)

Load a FieldTypeDef from its ID.

Parameters

FieldTypeDef $id

Return Value

FieldTypeDef

at line 366
File loadFileFromID(File $id)

Load a File from its ID.

Parameters

File $id

Return Value

File

at line 376
FunctionArg loadFunctionArgFromID(FunctionArg $id)

Load a FunctionArg from its ID.

Parameters

FunctionArg $id

Return Value

FunctionArg

at line 386
FunctionCallArgValue loadFunctionCallArgValueFromID(FunctionCallArgValue $id)

Load a FunctionCallArgValue from its ID.

Parameters

FunctionCallArgValue $id

Return Value

FunctionCallArgValue

at line 397
FunctionCall loadFunctionCallFromID(FunctionCall $id)

Load a FunctionCall from its ID.

Parameters

FunctionCall $id

Return Value

FunctionCall

at line 407
Function_ loadFunctionFromID(Function_ $id)

Load a Function from its ID.

Parameters

Function_ $id

Return Value

Function_

at line 417
GeneratedCode loadGeneratedCodeFromID(GeneratedCode $id)

Load a GeneratedCode from its ID.

Parameters

GeneratedCode $id

Return Value

GeneratedCode

at line 427
GitRef loadGitRefFromID(GitRef $id)

Load a GitRef from its ID.

Parameters

GitRef $id

Return Value

GitRef

at line 437
GitRepository loadGitRepositoryFromID(GitRepository $id)

Load a GitRepository from its ID.

Parameters

GitRepository $id

Return Value

GitRepository

at line 447
Host loadHostFromID(Host $id)

Load a Host from its ID.

Parameters

Host $id

Return Value

Host

at line 457
InputTypeDef loadInputTypeDefFromID(InputTypeDef $id)

Load a InputTypeDef from its ID.

Parameters

InputTypeDef $id

Return Value

InputTypeDef

at line 467
InterfaceTypeDef loadInterfaceTypeDefFromID(InterfaceTypeDef $id)

Load a InterfaceTypeDef from its ID.

Parameters

InterfaceTypeDef $id

Return Value

InterfaceTypeDef

at line 477
LLM loadLLMFromID(LLM $id)

Load a LLM from its ID.

Parameters

LLM $id

Return Value

LLM

at line 487
LLMTokenUsage loadLLMTokenUsageFromID(LLMTokenUsage $id)

Load a LLMTokenUsage from its ID.

Parameters

LLMTokenUsage $id

Return Value

LLMTokenUsage

at line 497
Label loadLabelFromID(Label $id)

Load a Label from its ID.

Parameters

Label $id

Return Value

Label

at line 507
ListTypeDef loadListTypeDefFromID(ListTypeDef $id)

Load a ListTypeDef from its ID.

Parameters

ListTypeDef $id

Return Value

ListTypeDef

at line 517
ModuleConfigClient loadModuleConfigClientFromID(ModuleConfigClient $id)

Load a ModuleConfigClient from its ID.

Parameters

ModuleConfigClient $id

Return Value

ModuleConfigClient

at line 527
Module loadModuleFromID(Module $id)

Load a Module from its ID.

Parameters

Module $id

Return Value

Module

at line 537
ModuleSource loadModuleSourceFromID(ModuleSource $id)

Load a ModuleSource from its ID.

Parameters

ModuleSource $id

Return Value

ModuleSource

at line 547
ObjectTypeDef loadObjectTypeDefFromID(ObjectTypeDef $id)

Load a ObjectTypeDef from its ID.

Parameters

ObjectTypeDef $id

Return Value

ObjectTypeDef

at line 557
PhpSdk loadPhpSdkFromID(PhpSdk $id)

Load a PhpSdk from its ID.

Parameters

PhpSdk $id

Return Value

PhpSdk

at line 567
Port loadPortFromID(Port $id)

Load a Port from its ID.

Parameters

Port $id

Return Value

Port

at line 577
SDKConfig loadSDKConfigFromID(SDKConfig $id)

Load a SDKConfig from its ID.

Parameters

SDKConfig $id

Return Value

SDKConfig

at line 587
ScalarTypeDef loadScalarTypeDefFromID(ScalarTypeDef $id)

Load a ScalarTypeDef from its ID.

Parameters

ScalarTypeDef $id

Return Value

ScalarTypeDef

at line 597
Secret loadSecretFromID(Secret $id)

Load a Secret from its ID.

Parameters

Secret $id

Return Value

Secret

at line 607
Secret loadSecretFromName(string $name, string|null $accessor = null)

Load a Secret from its Name.

Parameters

string $name
string|null $accessor

Return Value

Secret

at line 620
Service loadServiceFromID(Service $id)

Load a Service from its ID.

Parameters

Service $id

Return Value

Service

at line 630
Socket loadSocketFromID(Socket $id)

Load a Socket from its ID.

Parameters

Socket $id

Return Value

Socket

at line 640
SourceMap loadSourceMapFromID(SourceMap $id)

Load a SourceMap from its ID.

Parameters

SourceMap $id

Return Value

SourceMap

at line 650
Terminal loadTerminalFromID(Terminal $id)

Load a Terminal from its ID.

Parameters

Terminal $id

Return Value

Terminal

at line 660
TypeDef loadTypeDefFromID(TypeDef $id)

Load a TypeDef from its ID.

Parameters

TypeDef $id

Return Value

TypeDef

at line 670
Module module()

Create a new module.

Return Value

Module

at line 679
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 703
PhpSdk phpSdk(Directory|null $sdkSourceDir = null)

No description

Parameters

Directory|null $sdkSourceDir

Return Value

PhpSdk

at line 715
Secret secret(string $uri)

Creates a new secret.

Parameters

string $uri

Return Value

Secret

at line 727
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 738
SourceMap sourceMap(string $filename, int $line, int $column)

Creates source map metadata.

Parameters

string $filename
int $line
int $column

Return Value

SourceMap

at line 750
TypeDef typeDef()

Create a new TypeDef.

Return Value

TypeDef

at line 759
string version()

Get the current Dagger Engine version.

Return Value

string