KerogsPHP

Installation

composer require kerogs/kerogs-php

How to use

To use the package, you first need to import the autoload.php file from the vendor folder.

Once you've done that, you can use only what you're interested in.

require_once '/vendor/autoload.php';

use Kerogs\KerogsPhp\[name];

Note

Replace [name] with the name of what you want to use. You can refer to the list below.

List

Note

All requested encryption keys are in AES-256-CBC format

Kerogs\KerogsPhp\Key

The Key() class is used to generate unique keys.

Example of use

require_once '/vendor/autoload.php';

use Kerogs\KerogsPhp\Key;
$key = new Key(1);

echo $key->keyGeneration(16);

When initializing a key, you must specify the type of character string you will use. This will be represented by a number.

    private static $keyTypes = [
        1 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-( )'!@#$%^&*",
        2 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-( )'!",
        3 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-( )",
        4 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-",
        5 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
        6 => "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
        7 => "abcdefghijklmnopqrstuvwxyz",
        8 => "0123456789",
        9 => "abcdefghijklmnopqrstuvwxyz0123456789"
    ];

Function list

function	description
keyGeneration(int $length): string	Generates a random key based on the character set associated with the type of key.
getCharacterSet(): string	Gets the character set for the given type of key.

Kerogs\KerogsPhp\Logs

You can easily create your own logs and, if required, encrypt them.

Example of use

require_once '/vendor/autoload.php';

use Kerogs\KerogsPhp\Logs;

const LogsKey = 'abcd-efgh-ijkl-mnop';
$logs = new Logs(LogsKey, true);

$logs->addLog(null, "User successfully logged in", 200, "INFO", false, true);

In the example, we initialize the class by specifying a key (this key will be used to encrypt and decrypt the contents of the logs if required). We then indicate via a true that we wish to encrypt the log file.

Then we simply add the logs.

Important

The log key must be in 16-byte format, as in.

If we specify no path for the logs by indicating null for the addLog() function, then a file will automatically be created at the server root and named kp_server.log.

Also worth knowing:

• When the file is encrypted, it will appear under the name [fileName].log.kpc.
• When the file is decrypted, it will appear as [fileName].log.

Function list

addLog()

Add a log entry to the file.

addLog(
    string $pathLogs = null,
    string $message = "-",
    int $statusCode = 200,
    string $logType = "INFO",
    bool $logIp = false,
    bool $logRequestData = false
):

encryptDecryptFile()

Encrypt or decrypt a log file.

encryptDecryptFile(string $filePath, bool $encrypt): void

Kerogs\KerogsPhp\Sendmail

You can send your e-mails directly without rewriting the code.

Example of us

require_once __DIR__.'/vendor/autoload.php';

use Kerogs\KerogsPhp\Sendmail;

const from = "froms@example.com";
const to = "to@example.com";

$sendmail = new Sendmail(from);

if($sendmail->sendMail(to, "Subject test", "hello world")))
    echo "Email sent successfully";
else
    echo "Email not sent";

The default content type is text/HTML