class UploadOptions extends Options

Additional options for the Upload operation

Traits

Selects what to do if the file already exists. The default for this union is add.
If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.
The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified
Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.

Constants

DATETIME_FORMAT

A Dropbox-friendly timestamp wrapper

Methods

__construct( array $defaults = array())

Options constructor.

from Options
boolean
offsetExists( string $offset)

Whether a offset exists

from Options
mixed
offsetGet( string $offset)

Offset to retrieve

from Options
offsetSet( string $offset, mixed $value)

Offset to set

from Options
offsetUnset( string $offset)

Offset to unset

from Options
static  Options
merge( array $options)

Create an Options object from a combination of configuration arrays and other option objects

from Options
array
toArray()

Return the generated options

from Options
setWriteMode( WriteMode $set)

Selects what to do if the file already exists. The default for this union is add.

setAutoRename( bool $set)

If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.

setClientModified( DateTimeInterface $set)

The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified.

setMute( bool $set)

Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.

from MuteTrait

Details

in Options at line line 41
__construct( array $defaults = array())

Options constructor.

Parameters

array $defaults Default options

in Options at line line 56
boolean offsetExists( string $offset)

Whether a offset exists

Parameters

string $offset An offset to check for.

Return Value

boolean true on success or false on failure. The return value will be casted to boolean if non-boolean was returned.

See also

http://php.net/manual/en/arrayaccess.offsetexists.php

in Options at line line 70
mixed offsetGet( string $offset)

Offset to retrieve

Parameters

string $offset The offset to retrieve.

Return Value

mixed Can return all value types.

See also

http://php.net/manual/en/arrayaccess.offsetget.php

in Options at line line 83
offsetSet( string $offset, mixed $value)

Offset to set

Parameters

string $offset The offset to assign the value to.
mixed $value The value to set.

See also

http://php.net/manual/en/arrayaccess.offsetset.php

in Options at line line 95
offsetUnset( string $offset)

Offset to unset

Parameters

string $offset The offset to unset.

See also

http://php.net/manual/en/arrayaccess.offsetunset.php

in Options at line line 108
static Options merge( array $options)

Create an Options object from a combination of configuration arrays and other option objects

Parameters

array $options The items to merge

Return Value

Options

in Options at line line 128
array toArray()

Return the generated options

Return Value

array

in WriteModeTrait at line line 52
WriteModeTrait setWriteMode( WriteMode $set)

Selects what to do if the file already exists. The default for this union is add.



Your intent when writing a file to some path. This is used to determine what constitutes a conflict and what the autorename strategy is.

In some situations, the conflict behavior is identical:

  1. If the target path doesn't contain anything, the file is always written; no conflict.
  2. If the target path contains a folder, it's always a conflict.
  3. If the target path contains a file with identical contents, nothing gets written; no conflict

The conflict checking differs in the case where there's a file at the target path with contents different from the contents you're trying to write

Parameters

WriteMode $set The write mode

Return Value

WriteModeTrait

in AutoRenameTrait at line line 29
AutoRenameTrait setAutoRename( bool $set)

If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.

Parameters

bool $set The setting

Return Value

AutoRenameTrait

in ClientModifiedTrait at line line 33
ClientModifiedTrait setClientModified( DateTimeInterface $set)

The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified.

Parameters

DateTimeInterface $set The setting

Return Value

ClientModifiedTrait

in MuteTrait at line line 31
MuteTrait setMute( bool $set)

Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.

Parameters

bool $set The setting

Return Value

MuteTrait