Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | List of all members
boxnet_client Class Reference

Box.net client class. More...

Inheritance diagram for boxnet_client:
oauth2_client curl

Public Member Functions

 build_post_data ($params)
 Given an array of name value pairs - build a valid HTTP POST application/x-www-form-urlencoded string. More...
 
 cleanopt ()
 Reset http method.
 
 create_folder ($foldername, $parentid=0)
 Create a folder. More...
 
 delete ($url, $param=array(), $options=array())
 HTTP DELETE method. More...
 
 download ($requests, $options=array())
 Download multiple files in parallel. More...
 
 download_file ($fileid, $path)
 Download the file. More...
 
 download_one ($url, $params, $options=array())
 Downloads one file and writes it to the specified file handler. More...
 
 get ($url, $params=array(), $options=array())
 HTTP GET method. More...
 
 get_accesstoken ()
 Get access token. More...
 
 get_additional_login_parameters ()
 An additional array of url params to pass with a login request. More...
 
 get_clientid ()
 Get the client ID. More...
 
 get_clientsecret ()
 Get the client secret. More...
 
 get_errno ()
 Get curl error code. More...
 
 get_file_info ($fileid)
 Get info of a file. More...
 
 get_folder_items ($folderid=0)
 Get a folder content. More...
 
 get_info ()
 Get curl information. More...
 
 get_login_url ()
 Returns the login link for this oauth request. More...
 
 get_raw_response ()
 Get raw HTTP Response Headers. More...
 
 get_refresh_token ()
 Get a refresh token!!! More...
 
 get_security ()
 Returns the current curl security helper. More...
 
 getResponse ()
 Get HTTP Response Headers. More...
 
 head ($url, $options=array())
 HTTP HEAD method. More...
 
 is_logged_in ()
 Is the user logged in? Note that if this is called after the first part of the authorisation flow the token is upgraded to an accesstoken. More...
 
 log_out ()
 Log out. More...
 
 options ($url, $options=array())
 HTTP OPTIONS method. More...
 
 patch ($url, $params='', $options=array())
 HTTP PATCH method. More...
 
 post ($url, $params='', $options=array())
 HTTP POST method. More...
 
 put ($url, $params=array(), $options=array())
 HTTP PUT method. More...
 
 rename_file ($fileid, $newname)
 Rename a file. More...
 
 reset_state ()
 Resets curl for multiple requests. More...
 
 resetcookie ()
 Reset Cookie.
 
 resetHeader ()
 Resets the HTTP Request headers (to prepare for the new request)
 
 resetopt ()
 Resets the CURL options that have already been set.
 
 search ($query)
 Search. More...
 
 set_security ($securityobject)
 Sets the curl security helper. More...
 
 setHeader ($header)
 Set HTTP Request Header. More...
 
 setopt ($options=array())
 Set curl options. More...
 
 share_file ($fileid, $businesscheck=true)
 Share a file and return the link to it. More...
 
 trace ($url, $options=array())
 HTTP TRACE method. More...
 
 upgrade_token ($code)
 Upgrade a authorization token from oauth 2.0 to an access token. More...
 
 upload_file (stored_file $storedfile, $parentid=0)
 Upload a file. More...
 

Static Public Member Functions

static callback_url ()
 Callback url where the request is returned to. More...
 
static get_cacert ()
 Get the location of ca certificates. More...
 
static mock_response ($response)
 For use only in unit tests - we can pre-set the next curl response. More...
 
static strip_double_headers ($input)
 When using a proxy, an additional HTTP response code may appear at the start of the header. More...
 

Public Attributes

bool $cache = false
 Caches http request contents.
 
bool $emulateredirects = null
 Perform redirects at PHP level instead of relying on native cURL functionality. More...
 
int $errno
 error code
 
string $error
 error
 
array $header = array()
 http header
 
string $info
 cURL information
 
bool $proxy = null
 Uses proxy, null means automatic based on URL.
 
array $rawresponse = array()
 Raw response headers, needed for BC in download_file_content().
 
array $response = array()
 http's response
 
string $version = '0.4 dev'
 library version
 
const API = 'https://api.box.com/2.0'
 @const API URL
 
const UPLOAD_API = 'https://upload.box.com/api/2.0'
 @const UPLOAD_API URL
 

Protected Member Functions

 auth_url ()
 Return authorize URL. More...
 
 get_stored_token ()
 Retrieve a token stored. More...
 
 get_tokenname ()
 Returns the tokenname for the access_token to be stored through multiple requests. More...
 
 make_url ($uri, $params=array(), $uploadapi=false)
 Build a request URL. More...
 
 multi ($requests, $options=array())
 Multiple HTTP Requests This function could run multi-requests in parallel. More...
 
 request ($url, $options=array())
 Single HTTP Request. More...
 
 request ($url, $options=array(), $acceptheader='application/json')
 Make a HTTP request, adding the access token we have. More...
 
 reset_request_state_vars ()
 Helper function to reset the request state vars. More...
 
 revoke_url ()
 Return the revoke URL. More...
 
 store_token ($token)
 Store a token between requests. More...
 
 token_url ()
 Return token URL. More...
 
 use_http_get ()
 Should HTTP GET be used instead of POST? Some APIs do not support POST and want oauth to use GET instead (with the auth_token passed as a GET param). More...
 

Protected Attributes

stdClass $accesstoken = null
 $accesstoken access token object
 
bool $basicauth = false
 basicauth
 
string $refreshtoken = ''
 $refreshtoken refresh token string
 
string $scope = ''
 $scope of the authentication request
 

Detailed Description

Box.net client class.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ auth_url()

boxnet_client::auth_url ( )
protected

Return authorize URL.

Return values
string

Reimplemented from oauth2_client.

◆ build_post_data()

oauth2_client::build_post_data (   $params)
inherited

Given an array of name value pairs - build a valid HTTP POST application/x-www-form-urlencoded string.

Parameters
array$paramsName / value pairs.
Return values
stringPOST data.

◆ callback_url()

static oauth2_client::callback_url ( )
staticinherited

Callback url where the request is returned to.

Return values
moodle_urlurl of callback

Reimplemented in core_badges\oauth2\client.

◆ create_folder()

boxnet_client::create_folder (   $foldername,
  $parentid = 0 
)

Create a folder.

Parameters
string$foldernameThe folder name.
int$parentidThe ID of the parent folder.
Return values
arrayInformation about the new folder.

◆ delete()

curl::delete (   $url,
  $param = array(),
  $options = array() 
)
inherited

HTTP DELETE method.

Parameters
string$url
array$param
array$options
Return values
bool

◆ download()

curl::download (   $requests,
  $options = array() 
)
inherited

Download multiple files in parallel.

Calls multi() with specific download headers

$c = new curl(); $file1 = fopen('a', 'wb'); $file2 = fopen('b', 'wb'); $c->download(array( array('url'=>'http://localhost/', 'file'=>$file1), array('url'=>'http://localhost/20/', 'file'=>$file2) )); fclose($file1); fclose($file2);

or

$c = new curl(); $c->download(array( array('url'=>'http://localhost/', 'filepath'=>'/tmp/file1.tmp'), array('url'=>'http://localhost/20/', 'filepath'=>'/tmp/file2.tmp') ));

Parameters
array$requestsAn array of files to request { url => url to download the file [required] file => file handler, or filepath => file path } If 'file' and 'filepath' parameters are both specified in one request, the open file handle in the 'file' parameter will take precedence and 'filepath' will be ignored.
array$optionsAn array of options to set
Return values
arrayAn array of results

◆ download_file()

boxnet_client::download_file (   $fileid,
  $path 
)

Download the file.

Parameters
int$fileidFile ID.
string$pathPath to download the file to.
Return values
boolSuccess or not.

◆ download_one()

curl::download_one (   $url,
  $params,
  $options = array() 
)
inherited

Downloads one file and writes it to the specified file handler.

$c = new curl(); $file = fopen('savepath', 'w'); $result = $c->download_one('http://localhost/', null, array('file' => $file, 'timeout' => 5, 'followlocation' => true, 'maxredirs' => 3)); fclose($file); $download_info = $c->get_info(); if ($result === true) { // file downloaded successfully } else { $error_text = $result; $error_code = $c->get_errno(); }

$c = new curl(); $result = $c->download_one('http://localhost/', null, array('filepath' => 'savepath', 'timeout' => 5, 'followlocation' => true, 'maxredirs' => 3)); // ... see above, no need to close handle and remove file if unsuccessful

Parameters
string$url
array | null$paramskey-value pairs to be added to $url as query string
array$optionsrequest options. Must include either 'file' or 'filepath'
Return values
bool|stringtrue on success or error string on failure

◆ get()

curl::get (   $url,
  $params = array(),
  $options = array() 
)
inherited

HTTP GET method.

Parameters
string$url
array$params
array$options
Return values
bool

◆ get_accesstoken()

oauth2_client::get_accesstoken ( )
inherited

Get access token.

This is just a getter to read the private property.

Return values
string

◆ get_additional_login_parameters()

oauth2_client::get_additional_login_parameters ( )
inherited

An additional array of url params to pass with a login request.

Return values
arrayof name value pairs.

Reimplemented in core\oauth2\client.

◆ get_cacert()

static curl::get_cacert ( )
staticinherited

Get the location of ca certificates.

Return values
stringabsolute file path or empty if default used

◆ get_clientid()

oauth2_client::get_clientid ( )
inherited

Get the client ID.

This is just a getter to read the private property.

Return values
string

◆ get_clientsecret()

oauth2_client::get_clientsecret ( )
inherited

Get the client secret.

This is just a getter to read the private property.

Return values
string

◆ get_errno()

curl::get_errno ( )
inherited

Get curl error code.

Return values
int

◆ get_file_info()

boxnet_client::get_file_info (   $fileid)

Get info of a file.

Parameters
int$fileidFile ID.
Return values
object

◆ get_folder_items()

boxnet_client::get_folder_items (   $folderid = 0)

Get a folder content.

Parameters
int$folderidFolder ID.
Return values
object

◆ get_info()

curl::get_info ( )
inherited

Get curl information.

Return values
string

◆ get_login_url()

oauth2_client::get_login_url ( )
inherited

Returns the login link for this oauth request.

Return values
moodle_urllogin url

Reimplemented in core_badges\oauth2\client.

◆ get_raw_response()

curl::get_raw_response ( )
inherited

Get raw HTTP Response Headers.

Return values
arrayof strings

◆ get_refresh_token()

oauth2_client::get_refresh_token ( )
inherited

Get a refresh token!!!

Return values
string

◆ get_security()

curl::get_security ( )
inherited

Returns the current curl security helper.

Return values
core::files::curl_security_helperinstance.

◆ get_stored_token()

oauth2_client::get_stored_token ( )
protectedinherited

Retrieve a token stored.

Return values
stdClass|nulltoken object

Reimplemented in core_badges\oauth2\client, and core\oauth2\client.

◆ get_tokenname()

oauth2_client::get_tokenname ( )
protectedinherited

Returns the tokenname for the access_token to be stored through multiple requests.

The default implentation is to use the classname combiend with the scope.

Return values
stringtokenname for prefernce storage

Reimplemented in core\oauth2\client.

◆ getResponse()

curl::getResponse ( )
inherited

Get HTTP Response Headers.

Return values
arrayof arrays

◆ head()

curl::head (   $url,
  $options = array() 
)
inherited

HTTP HEAD method.

See also
request()
Parameters
string$url
array$options
Return values
bool

◆ is_logged_in()

oauth2_client::is_logged_in ( )
inherited

Is the user logged in? Note that if this is called after the first part of the authorisation flow the token is upgraded to an accesstoken.

Return values
booleantrue if logged in

Reimplemented in core_badges\oauth2\client.

◆ log_out()

boxnet_client::log_out ( )

Log out.

Return values
void

Reimplemented from oauth2_client.

◆ make_url()

boxnet_client::make_url (   $uri,
  $params = array(),
  $uploadapi = false 
)
protected

Build a request URL.

Parameters
string$uriThe URI to request.
array$paramsQuery string parameters.
bool$uploadapiWhether this works with the upload API or not.
Return values
string

◆ mock_response()

static curl::mock_response (   $response)
staticinherited

For use only in unit tests - we can pre-set the next curl response.

This is useful for unit testing APIs that call external systems.

Parameters
string$response

◆ multi()

oauth2_client::multi (   $requests,
  $options = array() 
)
protectedinherited

Multiple HTTP Requests This function could run multi-requests in parallel.

Parameters
array$requestsAn array of files to request
array$optionsAn array of options to set
Return values
arrayAn array of results

Reimplemented from curl.

◆ options()

curl::options (   $url,
  $options = array() 
)
inherited

HTTP OPTIONS method.

Parameters
string$url
array$options
Return values
bool

◆ patch()

curl::patch (   $url,
  $params = '',
  $options = array() 
)
inherited

HTTP PATCH method.

Parameters
string$url
array | string$params
array$options
Return values
bool

◆ post()

curl::post (   $url,
  $params = '',
  $options = array() 
)
inherited

HTTP POST method.

Parameters
string$url
array | string$params
array$options
Return values
bool

Reimplemented in microsoft_skydrive.

◆ put()

curl::put (   $url,
  $params = array(),
  $options = array() 
)
inherited

HTTP PUT method.

Parameters
string$url
array$params
array$options
Return values
bool

◆ rename_file()

boxnet_client::rename_file (   $fileid,
  $newname 
)

Rename a file.

Parameters
int$fileidThe file ID.
string$newnameThe new file name.
Return values
objectBox.net file object.

◆ request() [1/2]

curl::request (   $url,
  $options = array() 
)
protectedinherited

Single HTTP Request.

Parameters
string$urlThe URL to request
array$options
Return values
bool

◆ request() [2/2]

oauth2_client::request (   $url,
  $options = array(),
  $acceptheader = 'application/json' 
)
protectedinherited

Make a HTTP request, adding the access token we have.

Parameters
string$urlThe URL to request
array$options
mixed$acceptheadermimetype (as string) or false to skip sending an accept header.
Return values
bool

Reimplemented in google_oauth.

◆ reset_request_state_vars()

curl::reset_request_state_vars ( )
protectedinherited

Helper function to reset the request state vars.

Return values
void.

◆ reset_state()

boxnet_client::reset_state ( )

Resets curl for multiple requests.

Return values
void

◆ revoke_url()

boxnet_client::revoke_url ( )
protected

Return the revoke URL.

Return values
string

◆ search()

boxnet_client::search (   $query)

Search.

Return values
object

◆ set_security()

curl::set_security (   $securityobject)
inherited

Sets the curl security helper.

Parameters
core::files::curl_security_helper$securityobjectinstance/subclass of the base curl_security_helper class.
Return values
booltrue if the security helper could be set, false otherwise.

◆ setHeader()

curl::setHeader (   $header)
inherited

Set HTTP Request Header.

Parameters
array$header

◆ setopt()

curl::setopt (   $options = array())
inherited

Set curl options.

Do not use the curl constants to define the options, pass a string corresponding to that constant. Ie. to set CURLOPT_MAXREDIRS, pass array('CURLOPT_MAXREDIRS' => 10) or array('maxredirs' => 10) to this method.

Parameters
array$optionsIf array is null, this function will reset the options to default value.
Return values
void
Exceptions
coding_exceptionIf an option uses constant value instead of option name.

◆ share_file()

boxnet_client::share_file (   $fileid,
  $businesscheck = true 
)

Share a file and return the link to it.

Parameters
string$fileidThe file ID.
bool$businesscheckWhether or not to check if the user can share files, has a business account.
Return values
object

◆ store_token()

oauth2_client::store_token (   $token)
protectedinherited

Store a token between requests.

Currently uses session named by get_tokenname

Parameters
stdClass | null$tokentoken object to store or null to clear

Reimplemented in core_badges\oauth2\client, and core\oauth2\client.

◆ strip_double_headers()

static curl::strip_double_headers (   $input)
staticinherited

When using a proxy, an additional HTTP response code may appear at the start of the header.

For example, when using https over a proxy there may be 'HTTP/1.0 200 Connection Established'. Other codes are also possible and some may come with their own headers.

If using the return value containing all headers, this function can be called to remove unwanted doubles.

Note that it is not possible to distinguish this situation from valid data unless you know the actual response part (below the headers) will not be included in this string, or else will not 'look like' HTTP headers. As a result it is not safe to call this function for general data.

Parameters
string$inputInput HTTP response
Return values
stringHTTP response with additional headers stripped if any

◆ token_url()

boxnet_client::token_url ( )
protected

Return token URL.

Return values
string

Reimplemented from oauth2_client.

◆ trace()

curl::trace (   $url,
  $options = array() 
)
inherited

HTTP TRACE method.

Parameters
string$url
array$options
Return values
bool

◆ upgrade_token()

oauth2_client::upgrade_token (   $code)
inherited

Upgrade a authorization token from oauth 2.0 to an access token.

Parameters
string$codethe code returned from the oauth authenticaiton
Return values
booleantrue if token is upgraded succesfully

◆ upload_file()

boxnet_client::upload_file ( stored_file  $storedfile,
  $parentid = 0 
)

Upload a file.

Please note that the file is named on Box.net using the path we are providing, and so the file has the name of the stored_file hash.

Parameters
stored_file$storedfileA stored_file.
integer$parentidThe ID of the parent folder.
Return values
objectBox.net file object.

◆ use_http_get()

oauth2_client::use_http_get ( )
protectedinherited

Should HTTP GET be used instead of POST? Some APIs do not support POST and want oauth to use GET instead (with the auth_token passed as a GET param).

Return values
booltrue if GET should be used

Member Data Documentation

◆ $emulateredirects

bool curl::$emulateredirects = null
inherited

Perform redirects at PHP level instead of relying on native cURL functionality.

Always true now.


The documentation for this class was generated from the following file: