mirror of
https://github.com/danog/phpseclib.git
synced 2024-12-02 09:38:06 +01:00
98 lines
3.3 KiB
Markdown
98 lines
3.3 KiB
Markdown
# phpseclib - PHP Secure Communications Library
|
|
|
|
[![CI Status](https://github.com/phpseclib/phpseclib/actions/workflows/ci.yml/badge.svg?branch=3.0&event=push "CI Status")](https://github.com/phpseclib/phpseclib)
|
|
|
|
## Supporting phpseclib
|
|
|
|
- [Become a backer or sponsor on Patreon](https://www.patreon.com/phpseclib)
|
|
- [One-time donation via PayPal or crypto-currencies](http://sourceforge.net/donate/index.php?group_id=198487)
|
|
- [Subscribe to Tidelift](https://tidelift.com/subscription/pkg/packagist-phpseclib-phpseclib?utm_source=packagist-phpseclib-phpseclib&utm_medium=referral&utm_campaign=readme)
|
|
|
|
## Introduction
|
|
|
|
MIT-licensed pure-PHP implementations of the following:
|
|
|
|
SSH-2, SFTP, X.509, an arbitrary-precision integer arithmetic library, Ed25519 / Ed449 / Curve25519 / Curve449, ECDSA / ECDH (with support for 66 curves), RSA (PKCS#1 v2.2 compliant), DSA / DH, DES / 3DES / RC4 / Rijndael / AES / Blowfish / Twofish / Salsa20 / ChaCha20, GCM / Poly1305
|
|
|
|
* [Browse Git](https://github.com/phpseclib/phpseclib)
|
|
|
|
## Documentation
|
|
|
|
* [Documentation / Manual](https://phpseclib.com/)
|
|
* [API Documentation](https://api.phpseclib.com/3.0/) (generated by Doctum)
|
|
|
|
## Branches
|
|
|
|
### master
|
|
|
|
* Development Branch
|
|
* Unstable API
|
|
* Do not use in production
|
|
|
|
### 3.0
|
|
|
|
* Long term support (LTS) release
|
|
* Major expansion of cryptographic primitives
|
|
* Minimum PHP version: 5.6.1
|
|
* PSR-4 autoloading with namespace rooted at `\phpseclib3`
|
|
* Install via Composer: `composer require phpseclib/phpseclib:~3.0`
|
|
|
|
### 2.0
|
|
|
|
* Long term support (LTS) release
|
|
* Modernized version of 1.0
|
|
* Minimum PHP version: 5.3.3
|
|
* PSR-4 autoloading with namespace rooted at `\phpseclib`
|
|
* Install via Composer: `composer require phpseclib/phpseclib:~2.0`
|
|
|
|
### 1.0
|
|
|
|
* Long term support (LTS) release
|
|
* PHP4 compatible
|
|
* Composer compatible (PSR-0 autoloading)
|
|
* Install using Composer: `composer require phpseclib/phpseclib:~1.0`
|
|
* [Download 1.0.21 as ZIP](http://sourceforge.net/projects/phpseclib/files/phpseclib1.0.21.zip/download)
|
|
|
|
## Security contact information
|
|
|
|
To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure.
|
|
|
|
## Support
|
|
|
|
Need Support?
|
|
|
|
* [Checkout Questions and Answers on Stack Overflow](http://stackoverflow.com/questions/tagged/phpseclib)
|
|
* [Create a Support Ticket on GitHub](https://github.com/phpseclib/phpseclib/issues/new)
|
|
* [Browse the Support Forum](http://www.frostjedi.com/phpbb/viewforum.php?f=46) (no longer in use)
|
|
|
|
## Special Thanks
|
|
|
|
Special Thanks to our $50+ sponsors!:
|
|
|
|
- Allan Simon
|
|
- [ChargeOver](https://chargeover.com/)
|
|
|
|
## Contributing
|
|
|
|
1. Fork the Project
|
|
|
|
2. Ensure you have Composer installed (see [Composer Download Instructions](https://getcomposer.org/download/))
|
|
|
|
3. Install Development Dependencies
|
|
```sh
|
|
composer install
|
|
```
|
|
|
|
4. Create a Feature Branch
|
|
|
|
5. Run continuous integration checks:
|
|
```sh
|
|
composer global require php:^8.1 squizlabs/php_codesniffer friendsofphp/php-cs-fixer vimeo/psalm
|
|
phpcs --standard=build/php_codesniffer.xml
|
|
php-cs-fixer fix --config=build/php-cs-fixer.php --diff --dry-run --using-cache=no
|
|
psalm --config=build/psalm.xml --no-cache --long-progress --report-show-info=false --output-format=text
|
|
vendor/bin/phpunit --verbose --configuration tests/phpunit.xml
|
|
```
|
|
|
|
6. Send us a Pull Request
|