smartinm / mega-php-client

MEGA PHP Client Library
102 stars 44 forks source link

MEGA PHP Client Library

PHP client library for the MEGA API.

Note: This library is still under development and incomplete, so the API is subject to change.

Requirements

Creating the client

Using the constructor

$mega = new MEGA();

Using a static factory method

$mega = MEGA::create_from_login($email, $password);

This is equivalent to:

$mega = new MEGA();
$mega->user_login_session($email, $password);

Changing the default MEGA API server

MEGA::set_default_server(MEGA::SERVER_EUROPE);

Working with public files

Download public files not require authentication.

Gettings file info

$mega = new MEGA();

$file_info = $mega->public_file_info($ph, $key);
var_dump($file_info);

// Print filename and size
echo 'Filename: ' . $file_info['at']['n'];
echo 'Size: ' . $file_info['s'];

Using links

$file_info = $mega->public_file_info_from_link($link);

This is equivalents to:

$info = MEGA::parse_link($link);
$file_info = $mega->public_file_info($info['ph'], $info['key']);

Downloading public files

// Save file to current directory.
$filepath = $mega->public_file_save($ph, $key);
echo 'File saved in ' . $filepath;

// Equivalent using exported link
$filepath = $mega->public_file_save_from_link($link);
echo 'File saved in ' . $filepath;

See below for more examples.

Downloading files

Using streams

// Write to file
$fp = fopen($file, 'wb');
$size = $mega->public_file_download($ph, $key, $fp);
fclose($fp);

Returning content

// Get content using temporary stream
$content = $mega->public_file_download($ph, $key);

Saving to disk

// Save file to temporary directory.
$tmp = sys_get_temp_dir();
$file = $mega->public_file_save($ph, $key, $tmp);
echo 'File saved in ' . $file;

Private files

Listing

$mega = MEGA::create_from_user($email, $password);

$files = $mega->node_list();
print_r($files);

// Get file info
$file_info = $mega->node_file_info($files['f'][5]);
print_r($file_info);

Downloading

User session

Saving session

$mega = MEGA::create_from_user($email, $password);

// ...

// Get current session as a base64 string
$session = MEGA::session_save($mega);

// Store in a safe place!
db_store_session($session);

Restoring session

// Retrive saved session
$session = db_get_session();

// Create client from previous session
$mega = MEGA::create_from_session($session);

// ...

Status

Operations that don't require user authentication

Method Description Status
public_file_info Request public file info Implemented
public_file_info_from_link Request public file info Implemented
public_file_download Download a public file Implemented
public_file_download_from_link Download a public file Implemented
public_file_save Download and save a public file to disk Implemented
public_file_save_from_link Download and save a public file to disk Implemented

Operations that require user authentication

Method Description Status
node_list Retrieve folder or user nodes Implemented
node_file_info Request file node info Implemented
node_file_download Download a file node Implemented
node_file_save Download and save a file node to disk Implemented
node_add Add/copy nodes Not implemented
node_delete Delete node Not implemented
node_move Move node Not implemented
node_update Set node attributes Not implemented
node_publish / node_unpublish Create/delete public handle Not implemented
node_share Create/modify/delete outgoing share Not implemented

Credits

Bitdeli Badge