CryptoManana

Kerangka kerja cryptomañana

Deskripsi proyek

Cryptomañana (Cryptomanana) adalah kerangka kerja kriptografi PHP yang menyediakan solusi berorientasi objek untuk meningkatkan keamanan proyek Anda. Basis kode proyek mengikuti prinsip solid/ciuman/kering dan mengimplementasikan beberapa pola desain perangkat lunak yang populer. Kerangka kerja perangkat lunak menyediakan model kriptografi yang berfungsi penuh dengan banyak primitif, protokol, dan layanan kriptografi. Ini sangat berguna untuk hashing aman, enkripsi, pertukaran kunci, penandatanganan data, pembuatan data acak dan bahkan lebih. Cryptomañana ada di sini untuk membuat perkembangan Anda lebih cepat dan lebih aman!

Pengembang: Tony Karavasilev

Instalasi Proyek

 # Install the package at your project via Composer
composer require karavasilev/cryptomanana

# Optionally, check if your system is well-configured
php vendor/karavasilev/cryptomanana/check.php

# Or: ./vendor/karavasilev/cryptomanana/check 

Persyaratan proyek

• PHP Version : 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2 atau 8.3;
• Ekstensi spl (bundel dengan PHP> = 5.0.0, ditambahkan ke Core karena PHP> = 5.3.0);
• Ekstensi hash (dibundel dengan php> = 5.1.2, ditambahkan ke inti karena php> = 7.4.0);
• Ekstensi openssl (ditambahkan secara default untuk PHP> = 5.0.0, membutuhkan pustaka OpenSSL);
• OpenSSL Library diinstal secara default dengan banyak sistem operasi dan server lampu;
• Composer Dependency Manager untuk PHP atau autoloading manual melalui src/autoload.php ;
• Ekstensi Opsional: libsodium atau sodium , mbstring , zend-opcache dan apcu .

Dokumentasi Proyek

• Manual dan dokumentasi kerangka kerja ;
• Dokumentasi API teknis ;
• Dokumentasi Perangkat Lunak Agile .

Kutipan proyek melalui doi

Kerangka Cryptomañana - DOI 10.5281/Zenodo.2604693 (sebagai sebuah konsep)

Menjalankan tes secara lokal (opsional)

git clone --depth=1 https://github.com/TonyKaravasilev/CryptoManana.git
cd CryptoManana && composer install --profile
vendor/bin/phpunit --testdox --no-coverage
vendor/bin/phpcs

Catatan: Jangan lupa untuk mengatur lokasi sys_temp_dir atau upload_tmp_dir di file konfigurasi php.ini Anda.

Aktifkan dukungan format transformasi unicode 8-bit melalui ekstensi pihak ke-3 (opsional)

• Menginstal dan mengaktifkan ekstensi PHP mbstring ;
• Konfigurasikan penyandian dan aktifkan Cryptomanana untuk menggunakannya:

 // Autoload packages via Composer class autoloader
require ' vendor ' . DIRECTORY_SEPARATOR . ' autoload.php ' ;

// Configure PHP internal encoding (default is `UTF-8` for PHP >= 5.6)
ini_set ( ' default_charset ' , ' UTF-8 ' );

// Configure `mbstring` to use your favourite UTF-8 encoding
mb_regex_encoding ( ' UTF-8 ' );
mb_internal_encoding ( ' UTF-8 ' );
mb_http_output ( ' UTF-8 ' );

// Enable the `mbstring` support for CryptoManana components
 CryptoManana  Core StringBuilder:: useMbString ( true );

// Start coding hard...

Catatan: Kerangka kerja berfungsi tanpa ekstensi dan tidak memungkinkan penggunaannya secara default untuk alasan kinerja.

Kompatibilitas Mundur PHP (Opsional)

Secara default, kerangka kerja Cryptomanana menyediakan kompatibilitas untuk versi PHP yang lebih lama (PolyFill). Anda dapat menonaktifkan pemeriksaan kompatibilitas (terletak di src/compatibility.php ) melalui definisi konstan. Tidak ada banyak alasan untuk menonaktifkan ini, tetapi Anda mungkin menginginkan logika polyfill Anda sendiri/orang lain, dll. Konstanta global harus ditentukan sebelum autoloading atau sebelum penggunaan kelas pertama (akses), seperti:

 define ( ' CRYPTO_MANANA_COMPATIBILITY_OFF ' , true ); // const CRYPTO_MANANA_COMPATIBILITY_OFF = 1;

Catatan: Dalam kebanyakan kasus Anda tidak perlu melakukan ini. Script hanya dipanggil sekali per permintaan HTTP (atau eksekusi CLI).

Tips Kinerja dan Keamanan (Opsional)

• Selalu perbarui pustaka openssl/natrium Anda ke versi terbaru;
• Selalu perbarui sistem operasi dan kernel Anda;
• Selalu perbarui PHP Anda dan menggunakan ekstensi;
• Selalu perbarui dependensi komposer Anda;
• Pisahkan dependensi per lingkungan;
• Cadangan dengan penuh semangat dan lebih disukai sering;
• Hidup dengan prinsip privilege paling sedikit;
• Tidak pernah keluaran kesalahan sistem teknis;
• Jangan pernah mengekspos versi platform Anda;
• Jangan pernah mempercayai masukan pengguna, itu jahat;
• Tidak pernah menggunakan kembali kunci, garam atau string nonce;
• Panen Kekuatan Zend Opcache/JIT;
• Gunakan optimasi APCU komposer;
• Meningkatkan sumber daya untuk PHP;
• Tingkatkan cache RealPath.