Class: Crypt_RSA_KeyPair

Source Location: /Crypt_RSA-1.0.0/RSA/KeyPair.php

Class Overview

Crypt_RSA_ErrorHandler
   |
   --Crypt_RSA_KeyPair

Crypt_RSA_KeyPair class, derived from Crypt_RSA_ErrorHandler

Author(s):

Alexander Valyalkin <valyala at gmail.com>

Version:

@package_version@

Copyright:

2005 Alexander Valyalkin

Inherited Variables

Inherited Methods

Class: Crypt_RSA_ErrorHandler

Crypt_RSA_ErrorHandler::getErrorHandler(): returns name of current error handler, or null if there is no error handler
Crypt_RSA_ErrorHandler::getErrorList(): Returns list of all errors, pushed to error list by $this->pushError()
Crypt_RSA_ErrorHandler::getLastError(): Returns last error from errors list or false, if list is empty
Crypt_RSA_ErrorHandler::isError(): Returns true if list of errors is not empty, else returns false
Crypt_RSA_ErrorHandler::pushError(): pushes error object $error to the error list
Crypt_RSA_ErrorHandler::setErrorHandler(): sets error handler to function with name $func_name.

Class Details

[line 109]
Crypt_RSA_KeyPair class, derived from Crypt_RSA_ErrorHandler

Provides the following functions:

generate($key) - generates new key pair
getPublicKey() - returns public key
getPrivateKey() - returns private key
getKeyLength() - returns bit key length
setRandomGenerator($func_name) - sets random generator to $func_name

Example usage: // create new 1024-bit key pair $key_pair = new Crypt_RSA_KeyPair(1024);

// error check if ($key_pair->isError()) { echo "error while initializing Crypt_RSA_KeyPair object:\n"; $erorr = $key_pair->getLastError(); echo $error->getMessage(), "\n"; }

// get public key $public_key = $key_pair->getPublicKey();

// get private key $private_key = $key_pair->getPrivateKey();

// generate new 512-bit key pair $key_pair->generate(512);

// error check if ($key_pair->isError()) { echo "error while generating key pair:\n"; $erorr = $key_pair->getLastError(); echo $error->getMessage(), "\n"; }

// get key pair length $length = $key_pair->getKeyLength();

// set random generator to $func_name, where $func_name // consists name of random generator function. See comments // befor setRandomGenerator() method for details $key_pair->setRandomGenerator($func_name);

// error check if ($key_pair->isError()) { echo "error while changing random generator:\n"; $erorr = $key_pair->getLastError(); echo $error->getMessage(), "\n"; }

// using factory() method instead of constructor (it returns PEAR_Error object on failure) $rsa_obj = &Crypt_RSA_KeyPair::factory($key_len); if (PEAR::isError($rsa_obj)) { echo "error: ", $rsa_obj->getMessage(), "\n"; }

Author: Alexander Valyalkin <valyala@gmail.com>
Version: @package_version@
Copyright: 2005 Alexander Valyalkin
Link: http://pear.php.net/package/Crypt_RSA
Access: public
License: PHP License 3.0

[ Top ]

Method Detail

Crypt_RSA_KeyPair (Constructor) [line 166]

Crypt_RSA_KeyPair Crypt_RSA_KeyPair(
int
$key_len, [string
$wrapper_name = 'default'], [string
$error_handler = ''])

Crypt_RSA_KeyPair constructor.

Access: public

Parameters:

int	`$key_len`	—	bit length of key pair, which will be generated in constructor
string	`$wrapper_name`	—	Name of math wrapper, which will be used to perform different operations with big integers. See contents of Crypt/RSA/Math folder for examples of wrappers. Read docs/Crypt_RSA/docs/math_wrappers.txt for details.
string	`$error_handler`	—	name of error handler function

[ Top ]

factory [line 205]

object new &factory(
int
$key_len, [string
$wrapper_name = 'default'])

Crypt_RSA_KeyPair factory.

Return: Crypt_RSA_KeyPair object on success or PEAR_Error object on failure
Access: public

Parameters:

int	`$key_len`	—	bit length of key pair, which will be generated in constructor
string	`$wrapper_name`	—	Name of math wrapper, which will be used to perform different operations with big integers. See contents of Crypt/RSA/Math folder for examples of wrappers. Read docs/Crypt_RSA/docs/math_wrappers.txt for details.

[ Top ]

generate [line 224]

bool generate(
[int
$key_len = null])

Generates new Crypt_RSA key pair with length $key_len.

If $key_len is missed, use an old key length from $this->_key_len

Return: true on success or false on error
Access: public

Parameters:

int $key_len — bit length of key pair, which will be generated

[ Top ]

getKeyLength [line 371]

int getKeyLength(
)

Returns length of each key in the key pair

Return: bit length of each key in key pair
Access: public

[ Top ]

getPrivateKey [line 328]

object private getPrivateKey(
)

Returns private key from the pair

Return: key object of class Crypt_RSA_Key
Access: public

[ Top ]

getPublicKey [line 317]

object public getPublicKey(
)

Returns public key from the pair

Return: key object of class Crypt_RSA_Key
Access: public

[ Top ]

setRandomGenerator [line 344]

bool setRandomGenerator(
[string
$random_generator = null])

Sets name of random generator function for key generation.

If parameter is skipped, then sets to default random generator.

Random generator function must return integer with at least 8 lower significant bits, which will be used as random values.

Return: true on success or false on error
Access: public

Parameters:

string $random_generator — name of random generator function

[ Top ]