Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
|
Public Member Functions | |
__construct ($server='', $user='', $pass='', $auth=false, $socket='', $oauthtoken='') | |
#- More... | |
__set ($key, $value) | |
check_webdav () | |
Check's if server is a webdav compliant server. More... | |
close () | |
Closes an open socket. | |
copy_coll ($src_path, $dst_path, $overwrite) | |
Public method copy_coll. More... | |
copy_file ($src_path, $dst_path, $overwrite) | |
Public method copy_file. More... | |
delete ($path) | |
Public method delete. More... | |
get ($path, &$buffer, $fp=null) | |
Public method get. More... | |
get_file ($srcpath, $localpath) | |
Public method get_file. More... | |
gpi ($path) | |
Public method gpi. More... | |
is_dir ($path) | |
Public method is_dir. More... | |
is_file ($path) | |
Public method is_file. More... | |
lock ($path) | |
Public method lock. More... | |
ls ($path) | |
Public method ls. More... | |
mget ($filelist) | |
Public method mget. More... | |
mkcol ($path) | |
Public method mkcol. More... | |
move ($src_path, $dst_path, $overwrite) | |
Public method move. More... | |
mput ($filelist) | |
Public method mput. More... | |
open () | |
Open's a socket to a webdav server. More... | |
options () | |
Get options from webdav server. More... | |
put ($path, $data) | |
Public method put. More... | |
put_file ($path, $filename) | |
Public method put_file. More... | |
set_protocol ($version) | |
Set which HTTP protocol will be used. More... | |
unlock ($path, $locktoken) | |
Public method unlock. More... | |
webdav_client::__construct | ( | $server = '' , |
|
$user = '' , |
|||
$pass = '' , |
|||
$auth = false , |
|||
$socket = '' , |
|||
$oauthtoken = '' |
|||
) |
#-
Constructor - Initialise class variables
string | $server | Hostname of the server to connect to |
string | $user | Username (for basic/digest auth, see $auth) |
string | $pass | Password (for basic/digest auth, see $auth) |
bool | $auth | Authentication type; one of ['basic', 'digest', 'bearer'] |
string | $socket | Used protocol for fsockopen, usually: '' (empty) or 'ssl://' |
string | $oauthtoken | OAuth 2 bearer token (for bearer auth, see $auth) |
webdav_client::check_webdav | ( | ) |
Check's if server is a webdav compliant server.
True if server returns a DAV Element in Header and when schema 1,2 is supported.
bool | true if server is webdav server. Otherwise false. |
webdav_client::copy_coll | ( | $src_path, | |
$dst_path, | |||
$overwrite | |||
) |
Public method copy_coll.
Copies a collection on a webdav server
Duplicates a collection on the webdav server (serverside). All work is done on the webdav server. If you set param overwrite as true, the target will be overwritten.
string | src_path, string dest_path, bool overwrite |
int | status code (look at rfc 2518). false on error. |
webdav_client::copy_file | ( | $src_path, | |
$dst_path, | |||
$overwrite | |||
) |
Public method copy_file.
Copies a file on a webdav server
Duplicates a file on the webdav server (serverside). All work is done on the webdav server. If you set param overwrite as true, the target will be overwritten.
string | src_path, string dest_path, bool overwrite |
int | status code (look at rfc 2518). false on error. |
webdav_client::delete | ( | $path | ) |
Public method delete.
deletes a collection/directory on a webdav server
string | path |
int | status code (look at rfc 2518). false on error. |
webdav_client::get | ( | $path, | |
& | $buffer, | ||
$fp = null |
|||
) |
Public method get.
Gets a file from a webdav collection.
string | $path | the path to the file on the webdav server |
string | &$buffer | the buffer to store the data in |
resource | $fp | optional if included, the data is written directly to this resource and not to the buffer |
string|bool | status code and &$buffer (by reference) with response data from server on success. False on error. |
webdav_client::get_file | ( | $srcpath, | |
$localpath | |||
) |
Public method get_file.
Gets a file from a collection into local filesystem.
fopen() is used.
string | $srcpath | |
string | $localpath |
bool | true on success. false on error. |
webdav_client::gpi | ( | $path | ) |
Public method gpi.
Get's path information from webdav server for one element.
string | path |
array | dirinfo. false on error |
webdav_client::is_dir | ( | $path | ) |
Public method is_dir.
Gather whether a path points to a directory
string | path return bool true or false |
webdav_client::is_file | ( | $path | ) |
Public method is_file.
Gathers whether a path points to a file or not.
string | path |
bool | true or false |
webdav_client::lock | ( | $path | ) |
Public method lock.
Locks a file or collection.
Lock uses this->_user as lock owner.
string | path |
int | status code (look at rfc 2518). false on error. |
webdav_client::ls | ( | $path | ) |
Public method ls.
Get's directory information from webdav server into flat a array using PROPFIND
All filenames are UTF-8 encoded. Have a look at _propfind_startElement what keys are used in array returned.
string | path |
array | dirinfo, false on error |
webdav_client::mget | ( | $filelist | ) |
Public method mget.
Gets multiple files and directories.
FileList must be in format array("remotepath" => "localpath"). Filenames are UTF-8 encoded.
array | filelist |
bool | true on succes, other int status code on error |
webdav_client::mkcol | ( | $path | ) |
Public method mkcol.
Creates a new collection/directory on a webdav server
string | path |
int | status code received as response from webdav server (see rfc 2518) |
webdav_client::move | ( | $src_path, | |
$dst_path, | |||
$overwrite | |||
) |
Public method move.
Moves a file or collection on webdav server (serverside)
If you set param overwrite as true, the target will be overwritten.
string | src_path, string dest_path, bool overwrite |
int | status code (look at rfc 2518). false on error. |
webdav_client::mput | ( | $filelist | ) |
Public method mput.
Puts multiple files and/or directories onto a webdav server.
Filenames should be allready UTF-8 encoded. Param fileList must be in format array("localpath" => "destpath").
array | filelist |
bool | true on success. otherwise int status code on error |
webdav_client::open | ( | ) |
Open's a socket to a webdav server.
bool | true on success. Otherwise false. |
webdav_client::options | ( | ) |
Get options from webdav server.
array | with all header fields returned from webdav server. false if server does not speak http. |
webdav_client::put | ( | $path, | |
$data | |||
) |
Public method put.
Puts a file into a collection. Data is putted as one chunk!
string | path, string data |
int | status-code read from webdavserver. False on error. |
webdav_client::put_file | ( | $path, | |
$filename | |||
) |
Public method put_file.
Read a file as stream and puts it chunk by chunk into webdav server collection.
Look at php documenation for legal filenames with fopen(); The filename will be translated into utf-8 if not allready in utf-8.
string | targetpath, string filename |
int | status code. False on error. |
webdav_client::set_protocol | ( | $version | ) |
Set which HTTP protocol will be used.
Value 1 defines that HTTP/1.1 should be used (Keeps Connection to webdav server alive). Otherwise HTTP/1.0 will be used.
int | version |
webdav_client::unlock | ( | $path, | |
$locktoken | |||
) |
Public method unlock.
Unlocks a file or collection.
string | path, string locktoken |
int | status code (look at rfc 2518). false on error. |