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)

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.

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.

Env
currentEnv()

Returns the current environment

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(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

Env
env(bool|null $privileged = false, bool|null $writable = false)

Initializes a new environment

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, int|null $maxAPICalls = null)

Initialize a Large Language Model (LLM)

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
node(Id $id)

Load any object by its ID.

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.

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 66
object loadObjectFromId(string $className, Id $id)

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

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
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 52
Changeset changeset()

Creates an empty changeset

Return Value

Changeset

at line 61
Cloud cloud()

Dagger Cloud configuration and state

Return Value

Cloud

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

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

GeneratedCode

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

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

Container

at line 88
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 104
Env currentEnv()

Returns the current environment

When called from a function invoked via an LLM tool call, this will be the LLM's current environment, including any modifications made through calling tools. Env values returned by functions become the new environment for subsequent calls, and Changeset values returned by functions are applied to the environment's workspace.

When called from a module function outside of an LLM, this returns an Env with the current module installed, and with the current module's source directory as its workspace.

Return Value

Env

at line 115
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 124
CurrentModule currentModule()

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

Return Value

CurrentModule

at line 133
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 148
Workspace currentWorkspace()

Detect and return the current workspace.

Return Value

Workspace

at line 157
Platform defaultPlatform()

The default platform of the engine.

Return Value

Platform

at line 166
Directory directory()

Creates an empty directory.

Return Value

Directory

at line 175
Engine engine()

The Dagger engine container configuration and state

Return Value

Engine

at line 184
Env env(bool|null $privileged = false, bool|null $writable = false)

Initializes a new environment

Parameters

bool|null $privileged
bool|null $writable

Return Value

Env

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

Initialize an environment file

Parameters

bool|null $expand

Return Value

EnvFile

at line 211
Error error(string $message)

Create a new error.

Parameters

string $message

Return Value

Error

at line 221
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 235
Function_ function(string $name, TypeDef $returnType)

Creates a function.

Parameters

string $name
TypeDef $returnType

Return Value

Function_

at line 246
GeneratedCode generatedCode(Directory $code)

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

Parameters

Directory $code

Return Value

GeneratedCode

at line 256
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 295
Host host()

Queries the host environment.

Return Value

Host

at line 304
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 335
Id id()

A unique identifier for this Query.

Return Value

Id

at line 344
JsonValue json()

Initialize a JSON value

Return Value

JsonValue

at line 353
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 368
Module module()

Create a new module.

Return Value

Module

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

No description

Parameters

ModuleSource $modSource
File $introspectionJson

Return Value

Container

at line 385
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 412
Node node(Id $id)

Load any object by its ID.

Parameters

Id $id

Return Value

Node

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

Creates a new secret.

Parameters

string $uri
string|null $cacheKey

Return Value

Secret

at line 437
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 445
Directory sourceDir()

No description

Return Value

Directory

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

Creates source map metadata.

Parameters

string $filename
int $line
int $column

Return Value

SourceMap

at line 466
TypeDef typeDef()

Create a new TypeDef.

Return Value

TypeDef

at line 475
string version()

Get the current Dagger Engine version.

Return Value

string

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

Configure the php-sdk constructor arguments.

Parameters

Directory|null $sdkSourceDir

Return Value

Client