Description: ------------ The current encrypt method accepts data as a string. It would be nice to have an encryptFile (or a similar idea) method that would encrypt a whole file based on the fullpath passed to the method.

Is this a convenience request or a memory-usage request? You can already encrypt files using $gpg->encrypt(file_get_contents('filename')). Memory use of file-based encryption could be improved with a dedicated file method. The biggest problem I have with file-based encryption is what to do with the output. Returning a string doesn't do much to improve the memory use problem, but specifying an output filename argument makes all method signatures more complicated. Specifying an output file also makes the actual method return value either the encrypted string or null. Do you have any API suggestions on how best to approach these problems?

I was thinking about memory usage problems. The best would be to have an output file. I would do something like $gpg = new Crypt_GPG('tmp' => '/tmp'); $result = $gpg->encryptFile($filepath); $result would be true if the encryption succeeds. I suppose an exception if the something goes really wrong, otherwise storing the message and offering a way to retrieve it. It is only viable for big files though as it does make things more complex. It could be the object of a new driver.

What do you think of this proposed API? * array importKeyFile($filename) * void exportKeyFile($key_id, $output) * void encryptFile($key_id, $filename, $output[, $armor]) * void decryptFile($filename, $output[, $passphrase]) * boolean signFile($key_id, $filename, $output[, $passphrase[, $mode[, $armor]]]) * Crypt_GPG_Signature verifyFile($filename[, $signature]) If files are not readable or writeable an exception would be thrown. I think the memory problem can be cleanly handled internally using PHP streams rather than the specifying filenames and --output in the GPG command itself.

This bug has been fixed in CVS. If this was a documentation problem, the fix will appear on pear.php.net by the end of next Sunday (CET). If this was a problem with the pear.php.net website, the change should be live shortly. Otherwise, the fix will appear in the package's next release. Thank you for the report and for helping us make PEAR better. New methods in CVS are: * array importKeyFile($filename) * void|string encryptFile($filename, $encryptedFile = null, $armor = true) * void|string decryptFile($encryptedFile, $decryptedFile = null) * void|string signFile($filename, $signedFile = null, $mode = 'normal', $armor = true) * Crypt_GPG_Signature verifyFile($filename, $detachedSignature = null) Expect a new release soon!

This feature is in the new release now.