2012-06-10 11:27:23 +02:00
# phpseclib - PHP Secure Communications Library
2016-04-30 23:23:35 +02:00
[![Build Status ](https://travis-ci.org/phpseclib/phpseclib.svg?branch=master )](https://travis-ci.org/phpseclib/phpseclib)
2012-06-11 10:30:46 +02:00
2019-07-02 14:03:46 +02:00
## 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
2012-06-10 11:27:23 +02:00
MIT-licensed pure-PHP implementations of an arbitrary-precision integer
arithmetic library, fully PKCS#1 (v2.1) compliant RSA, DES, 3DES, RC4, Rijndael,
2013-06-10 16:55:41 +02:00
AES, Blowfish, Twofish, SSH-1, SSH-2, SFTP, and X.509
2012-06-10 11:27:23 +02:00
* [Browse Git ](https://github.com/phpseclib/phpseclib )
2014-04-12 20:15:34 +02:00
2014-08-01 17:57:06 +02:00
## Documentation
* [Documentation / Manual ](http://phpseclib.sourceforge.net/ )
2016-12-25 03:06:51 +01:00
* [API Documentation ](https://api.phpseclib.org/master/ ) (generated by Sami)
2014-08-01 17:57:06 +02:00
2016-12-18 11:02:41 +01:00
## Branches
### master
* Development Branch
* Unstable API
* Do not use in production
### 2.0
2018-11-14 21:41:55 +01:00
* Long term support (LTS) release
2016-12-18 11:02:41 +01:00
* Modernized version of 1.0
* Minimum PHP version: 5.3.3
* PSR-4 autoloading with namespace rooted at `\phpseclib`
2018-05-10 15:51:30 +02:00
* Install via Composer: `composer require phpseclib/phpseclib:~2.0`
2016-12-18 11:02:41 +01:00
### 1.0
* Long term support (LTS) release
* PHP4 compatible
* Composer compatible (PSR-0 autoloading)
2018-05-10 15:51:30 +02:00
* Install using Composer: `composer require phpseclib/phpseclib:~1.0`
2016-12-25 16:09:17 +01:00
* Install using PEAR: See [phpseclib PEAR Channel Documentation ](http://phpseclib.sourceforge.net/pear.htm )
2019-09-17 06:11:10 +02:00
* [Download 1.0.18 as ZIP ](http://sourceforge.net/projects/phpseclib/files/phpseclib1.0.18.zip/download )
2014-08-01 17:57:06 +02:00
2019-07-02 14:03:46 +02:00
## 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.
2014-07-14 20:20:18 +02:00
## 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)
2016-12-18 10:40:24 +01:00
## Contributing
2014-04-12 20:15:34 +02:00
2016-12-18 10:40:24 +01:00
1. Fork the Project
2014-04-12 20:15:34 +02:00
2016-12-18 10:40:24 +01:00
2. Ensure you have Composer installed (see [Composer Download Instructions ](https://getcomposer.org/download/ ))
2014-04-12 20:15:34 +02:00
2016-12-18 10:40:24 +01:00
3. Install Development Dependencies
2014-04-12 20:15:34 +02:00
``` sh
2016-12-18 10:38:28 +01:00
composer install
2014-04-12 20:15:34 +02:00
```
2014-04-12 20:26:27 +02:00
2016-12-18 10:40:24 +01:00
4. Create a Feature Branch
2014-04-12 20:26:27 +02:00
2016-12-18 10:40:24 +01:00
5. (Recommended) Run the Test Suite
2014-04-12 20:26:27 +02:00
``` sh
vendor/bin/phpunit
```
2016-12-18 10:40:24 +01:00
6. (Recommended) Check whether your code conforms to our Coding Standards by running
2014-04-12 20:26:27 +02:00
``` sh
vendor/bin/phing -f build/build.xml sniff
```
2016-12-18 10:40:24 +01:00
7. Send us a Pull Request