Note: The publickey subsystem
is used for managing publickeys on a server to which the client is
already authenticated. To authenticate to a remote system
using publickey authentication, use the ssh2_auth_pubkey_file()
function instead.
If the specified key already exists, should it be overwritten?
attributes
Associative array of attributes to assign to this public key.
Refer to ietf-secsh-publickey-subsystem for a list of supported attributes.
To mark an attribute as mandatory, precede its name with an asterisk.
If the server is unable to support an attribute marked mandatory,
it will abort the add process.
Return Values
Returns TRUE on success or FALSE on failure.
Examples
Example 1. Adding a publickey with ssh2_publickey_add()