pbms_put_data
Description
string pbms_put_data ( string $data [,string $table [,string $md5_digest [,resource $pbms]]]] )
Sends data to the PBMS BLOB streaming server returning a BLOB reference. The BLOB reference can then be inserted into a longblob column of a PBMS enabled table inplace of the actual BLOB data.
Parameters
$data
The BLOB data to be sent to the PBMS server.
$table
The table into which the blob reference will eventually be inserted. If not supplied no table will be associated with the new BLOB until the reference is inserted into a table. Providing the table name here make the BLOB handling on the server a bit more efficient.
$md5_digest
A raw 16 byte MD5 digest of the BLOB being sent. If provided it will be used to verify that the data has been received correctly by the server.
$pbms
A valid PBMS connection resource. If $pbms is not specified, the last link opened by pbms_connect() is assumed. If no such link is found, it will try to create one as if pbms_connect() was called with no arguments. If by chance no connection is found or established, an E_WARNING level error is generated.
Return Values

Returns the PBMS BLOB reference for the BLOB data sent on success.

Returns FALSE on failure. Use pbms_errno() and pbms_error() to retrieve error details.

Example
<?php 
	pbms_connect();

	//-----------
	// Create a BLOB and insert it into a table.
	// Assume that the table exists.
	$blob_ref = pbms_put_data("A tiny BLOB for a table", "bobtest" );
	
	query =  sprintf("insert into bobtest(id, name) Values(1, \"%s\")", $blob_ref);
	mysql_query($query);
	
	// Fetch the BLOB back again.
	$result =mysql_query("select name from bobtest where id = 1");
			
	$row = mysql_fetch_row($result);
	printf("NOTE: blob ref stored in table: \"%s\" is not the same as what was inserted \"%s\" \n", $row[0], $blob_ref)
	printf("The BLOB \"%s\"\n", pbms_get_data($row[0]));

	pbms_close();
?>
		
Related functions
pbms_get_data() pbms_read_stream() pbms_write_stream()