strukt/key

Cryptography

v1.1.0-alpha 2025-04-21 14:43 UTC

Requires

• php: ^8.1
• ext-openssl: *
• firebase/php-jwt: ^6.10
• strukt/commons: v1.1.2-alpha
• strukt/console: 1.0.0

MIT

• Moderator

README

Installation

Composer

Create composer.json script with contents below then run composer update

{
    "require":{

        "strukt/key":"v1.1.0-alpha"
    },
    "minimum-stability":"dev"
}

Hashing

Bcrypt

$hash = bcry("p@55w0rd")->encode();
$success = bcry("p@55w0rd")->verify($hash);

Sha256 (Doubled)

$hash = sha256dbl('p@55w0rd');

Public & Private Keys

Auto generate keys

// $k = Strukt\Ssl\All::makeKeys();
$ks = ssl()->getKeys();
$ks->getPrivateKey()->getPem();//get Private Key
$ks->getPublicKey()->getPem();//get Public Key
$c = $ks->useCipher();
$enc = $c->encrypt("p@55w0rd");
$dec = $c->decrypt($enc);

Use existing key

You can generate your key via ssh-keygen if you wantta.

$file = "file:///home/churchill/.ssh/id_rsa"
// $k = Strukt\Ssl\All::keyPath($file)
$k = ssl($file);

Encrypt message with Public Key

$message = "Hi! My name is (what?)
My name is (who?)
My name is
Slim Shady
Hi! My name is (huh?)
My name is (what?)
My name is
Slim Shady";

$file = "file:///home/churchill/.ssh/id_rsa.pub"

// $p = new Strukt\Ssl\KeyPair();//No Private Key
// $p->setPublicKey($file);
// $p = keypair()->setPublicKey($file); //No Private Key
// $p = pubkey(local("strukt.pub")); //No Private Key
$p = pubkey($file);

// $enc = Strukt\Ssl\All::useKeys($p)->toSend($message);
$enc = ssl($p)->toSend($message);

Encrypt with password

// $p = new Strukt\Ssl\KeyPair($path, "p@55w0rd");
// $p->getPublicKey(); // Trigger public key extraction from private key
$p = keypair($path, "p@55w0rd");
$p->getPublicKey(); // Trigger public key extraction from private key

// $k = Strukt\Ssl\All::useKeys($p)
$k = ssl($p);

Certificate Signing Request (CSR)

Sign & verify certificate

$kpath = "file:///home/churchill/.ssh/id_rsa"
$cpath = "file:///home/churchill/.ssh/cacert.pem"

// $oCsr = Strukt\Ssl\All::keyPath($kpath)->withCert($cpath);
$oCsr = ssl($kpath)->withCert($cpath);
$cert = $oCsr->sign();
$success = $oCsr->verify($cert);

Note

For local keys in your project or project root. Example:

├── strukt     # Private Key
└── strukt.pub # Public Key

You can use helper local to localize your path to url:

$k = ssl(local("strukt"));
// $p = keypair()->setPublicKey(local("strukt.pub"));