Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(PHP Extension) REST Download Bandwidth ThrottleDemonstrates how to use download bandwidth throttling with the REST API. This example will download a file from Drobox using a file stream, with a limit on the bandwidth that can be used for the transfer.
<?php // The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number. // For example, if using Chilkat v9.5.0.48, then include as shown here: include("chilkat_9_5_0.php"); // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // A Dropbox access token should have been previously obtained. // Dropbox access tokens do not expire. // See Dropbox Access Token. // To use bandwidth throttling, the connection should be made using the socket API. // This provides numerous properties to customize the connection, such as // BandwidthThrottleDown, BandwidthThrottleUp, ClientIpAddress, ClintPort, Http Proxy, // KeepAlive, PreferIpv6, RequireSslCertVerify, SoRcvBuf, SoSndBuf, SoReuseAddr, // SOCKS proxy, TcpNoSDelay, TlsPinSet, TlsCipherSuite, SslAllowedCiphers, etc. $socket = new CkSocket(); $maxWaitMs = 5000; $success = $socket->Connect('content.dropboxapi.com',443,true,$maxWaitMs); if ($success != true) { print $socket->lastErrorText() . "\n"; print 'Connect Fail Reason: ' . $socket->get_ConnectFailReason() . "\n"; exit; } // Set the download bandwidth throttle rate to 50000 bytes per second. $socket->put_BandwidthThrottleDown(50000); $rest = new CkRest(); // Tell the REST object to use the connected socket. $rest->UseConnection($socket,true); // The remainder of this example is identical to the example at: // Dropbox Download File. // Add request headers. $rest->AddHeader('Authorization','Bearer DROPBOX_ACCESS_TOKEN'); // The download "parameters" are contained in JSON passed in an HTTP request header. // This is the JSON indicating the file to be downloaded: // { // "path": "/Homework/lit/hamlet.xml", // } $json = new CkJsonObject(); $json->AppendString('path','/Homework/lit/hamlet.xml'); $rest->AddHeader('Dropbox-API-Arg',$json->emit()); // Setup a file stream for the download $fileStream = new CkStream(); $fileStream->put_SinkFile('qa_output/hamletFromDropbox.xml'); // Indicate that the call to FullRequestNoBody should send the response body // to fileStream if the response status code is 200. // If a non-success response status code is received, then nothing // is streamed to the output file and the error response is returned by FullRequestNoBody. $expectedStatus = 200; $rest->SetResponseBodyStream($expectedStatus,true,$fileStream); $responseStr = $rest->fullRequestNoBody('POST','/2/files/download'); if ($rest->get_LastMethodSuccess() != true) { print $rest->lastErrorText() . "\n"; exit; } // When successful, Dropbox responds with a 200 response code. if ($rest->get_ResponseStatusCode() != 200) { // Examine the request/response to see what happened. print 'response status code = ' . $rest->get_ResponseStatusCode() . "\n"; print 'response status text = ' . $rest->responseStatusText() . "\n"; print 'response header: ' . $rest->responseHeader() . "\n"; print 'response body (if any): ' . $responseStr . "\n"; print '---' . "\n"; print 'LastRequestStartLine: ' . $rest->lastRequestStartLine() . "\n"; print 'LastRequestHeader: ' . $rest->lastRequestHeader() . "\n"; exit; } // Information about the downloaded file is also available as JSON in a response header. // The "dropbox-api-result" response header contains the information. For example: $apiResult = $rest->responseHdrByName('dropbox-api-result'); print $apiResult . "\n"; // In this case, the pretty-formatted dropbox-api-result JSON looks like this: // { // "name": "hamlet.xml", // "path_lower": "/homework/lit/hamlet.xml", // "path_display": "/Homework/lit/hamlet.xml", // "id": "id:74FkdeNuyKAAAAAAAAAAAQ", // "client_modified": "2016-06-02T23:19:00Z", // "server_modified": "2016-06-02T23:19:00Z", // "rev": "9482db15f", // "size": 279658 // } // Load the JSON, pretty-print it, and demonstrate how to get some values... $jsonResult = new CkJsonObject(); $jsonResult->put_EmitCompact(false); $jsonResult->Load($apiResult); // Show the JSON pretty-printed... print $jsonResult->emit() . "\n"; // Sample code to get data from the JSON response: $size = $jsonResult->IntOf('size'); print 'size = ' . $size . "\n"; $rev = $jsonResult->stringOf('rev'); print 'rev = ' . $rev . "\n"; $clientModified = $jsonResult->stringOf('client_modified'); $ckdt = new CkDateTime(); $ckdt->SetFromTimestamp($clientModified); $bLocalTime = true; // dt is a CkDtObj $dt = $ckdt->GetDtObj($bLocalTime); print $dt->get_Day() . '/' . $dt->get_Month() . '/' . $dt->get_Year() . ' ' . $dt->get_Hour() . ':' . $dt->get_Minute() . "\n"; ?> |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.