CryptoManana

Криптоманана структура

Описание проекта

Cryptomañanana (Cryptomanana)-это криптография PHP, которая предоставляет объектно-ориентированные решения для повышения безопасности вашего проекта. Кодовая база проекта следует за принципами твердых/поцелуев/сухой и реализует несколько популярных шаблонов проектирования программного обеспечения. Программная структура предоставляет полностью функциональную модель криптографии с обширной криптографической примитивами, протоколами и услугами. Это очень полезно для безопасного хэширования, шифрования, обмена ключами, подписания данных, генерации случайных данных и даже большего. Cryptomañana здесь, чтобы сделать ваше развитие быстрее и безопаснее!

Разработчик: Тони Каравасилев

Установка проекта

 # 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 

Требования к проекту

• PHP Version : 5,5, 5,6, 7,0, 7,1, 7,2, 7,3, 7,4, 8,0, 8,1, 8,2 или 8,3;
• Расширение spl (пучки с PHP> = 5,0,0, добавленное в ядро, так как PHP> = 5.3.0);
• Расширение hash (в комплекте с PHP> = 5,1,2, добавленное в ядро, так как PHP> = 7.4.0);
• Расширение openssl (добавлено по умолчанию для PHP> = 5.0.0, нуждается в библиотеке OpenSSL);
• OpenSSL Library , установленная по умолчанию со многими операционными системами и серверами ламп;
• Composer Dependency Manager для PHP или ручной автозагрузки через src/autoload.php ;
• Дополнительные расширения: libsodium или sodium , mbstring , zend-opcache и apcu .

Проектная документация

• Руководство по структуре и документация ;
• Техническая документация API ;
• Agile программная документация .

Цитата проекта через DOI

Структура Cryptomañana - doi 10.5281/Zenodo.2604693 (в качестве концепции)

Запуск тестов локально (необязательно)

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

Примечание. Не забудьте установить местоположение sys_temp_dir или upload_tmp_dir в вашем файле конфигурации php.ini.

Включить 8-битную поддержку формата преобразования Unicode через 3-е расширение (необязательно)

• Установить и включить расширение PHP mbstring ;
• Настройте кодирование и включите криптоману использовать его:

 // 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...

ПРИМЕЧАНИЕ. Структура работает без расширения и не позволяет использовать его по умолчанию по соображениям производительности.

PHP обратная совместимость (необязательно)

По умолчанию платформа Cryptomanana обеспечивает совместимость для различных старых версий PHP (Polyfill). Вы можете отключить проверку совместимости (расположенную по адресу src/compatibility.php ) через постоянное определение. Не так много причин для отключения этого, но вы можете понадобиться вашей собственной/других полифилле логики и т. Д.

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

Примечание. В большинстве случаев вам не нужно это делать. Сценарий вызывается только один раз на HTTP -запрос (или выполнение CLI).

Советы по производительности и безопасности (необязательно)

• Всегда обновляйте свою библиотеку OpenSSL/натрия до последней версии;
• Всегда обновляйте свою операционную систему и ядро;
• Всегда обновляйте свой PHP и использовали расширения;
• Всегда обновляйте свои зависимости от композитора;
• Разделить зависимости от окружающей среды;
• Резервное копирование энергично и предпочтительно часто;
• Жить по наименее привилегии;
• Никогда не выводится технические ошибки системы;
• Никогда не разоблачайте версию своей платформы;
• Никогда не доверяйте вводу пользователей, это зло;
• Никогда не используйте ключи, соли или незвуковые струны;
• Сбор мощности Zend Opcache/JIT;
• Используйте оптимизацию Composer APCU;
• Увеличить ресурсы для PHP;
• Увеличьте кеш RealPath.