Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/defuse/php-encryption

Simple Encryption in PHP.
https://github.com/defuse/php-encryption

Last synced: about 2 months ago
JSON representation

Simple Encryption in PHP.

Lists

README 

        
php-encryption

===============



![Build Status](https://app.travis-ci.com/defuse/php-encryption.svg?branch=master)

[![codecov](https://codecov.io/gh/defuse/php-encryption/branch/master/graph/badge.svg)](https://codecov.io/gh/defuse/php-encryption)

[![Latest Stable Version](https://poser.pugx.org/defuse/php-encryption/v/stable)](https://packagist.org/packages/defuse/php-encryption)

[![License](https://poser.pugx.org/defuse/php-encryption/license)](https://packagist.org/packages/defuse/php-encryption)

[![Downloads](https://img.shields.io/packagist/dt/defuse/php-encryption.svg)](https://packagist.org/packages/defuse/php-encryption)



```terminal

composer require defuse/php-encryption

```



This is a library for encrypting data with a key or password in PHP. **It

requires PHP 5.6 or newer and OpenSSL 1.0.1 or newer.** We recommend using a

version of PHP that [still has security

support](https://www.php.net/supported-versions.php), which at the time of

writing means PHP 8.0 or later. Using this library with an unsupported

version of PHP could lead to security vulnerabilities.



The current version of `php-encryption` is v2.4.0. This library is expected to

remain stable and supported by its authors with security and bugfixes until at

least January 1st, 2024.



The library is a joint effort between [Taylor Hornby](https://defuse.ca/) and

[Scott Arciszewski](https://paragonie.com/blog/author/scott-arcizewski) as well

as numerous open-source contributors.



What separates this library from other PHP encryption libraries is, firstly,

that it is secure. The authors used to encounter insecure PHP encryption code on

a daily basis, so they created this library to bring more security to the

ecosystem. Secondly, this library is "difficult to misuse." Like

[libsodium](https://github.com/jedisct1/libsodium), its API is designed to be

easy to use in a secure way and hard to use in an insecure way.



Dependencies

------------



This library requires no special dependencies except for PHP 5.6 or newer with

the OpenSSL extensions (version 1.0.1 or later) enabled (this is the default).

It uses [random\_compat](https://github.com/paragonie/random_compat), which is

bundled in with this library so that your users will not need to follow any

special installation steps.



Getting Started

----------------



Start with the [**Tutorial**](docs/Tutorial.md). You can find instructions for

obtaining this library's code securely in the [Installing and

Verifying](docs/InstallingAndVerifying.md) documentation.



After you've read the tutorial and got the code, refer to the formal

documentation for each of the classes this library provides:



- [Crypto](docs/classes/Crypto.md)

- [File](docs/classes/File.md)

- [Key](docs/classes/Key.md)

- [KeyProtectedByPassword](docs/classes/KeyProtectedByPassword.md)



If you encounter difficulties, see the [FAQ](docs/FAQ.md) answers. The fixes to

the most commonly-reported problems are explained there.



If you're a cryptographer and want to understand the nitty-gritty details of how

this library works, look at the [Cryptography Details](docs/CryptoDetails.md)

documentation.



If you're interested in contributing to this library, see the [Internal

Developer Documentation](docs/InternalDeveloperDocs.md).



Other Language Support

----------------------



This library is intended for server-side PHP software that needs to encrypt data at rest.

If you are building software that needs to encrypt client-side, or building a system that

requires cross-platform encryption/decryption support, we strongly recommend using

[libsodium](https://download.libsodium.org/doc/bindings_for_other_languages) instead.



Examples

---------



If the documentation is not enough for you to understand how to use this

library, then you can look at an example project that uses this library:



- [encutil](https://github.com/defuse/encutil)

- [fileencrypt](https://github.com/tsusanka/fileencrypt)



Security Audit Status

---------------------



This code has not been subjected to a formal, paid, security audit. However, it

has received lots of review from members of the PHP security community, and the

authors are experienced with cryptography. In all likelihood, you are safer

using this library than almost any other encryption library for PHP.



If you use this library as a part of your business and would like to help fund

a formal audit, please [contact Taylor Hornby](https://defuse.ca/contact.htm).



Public Keys

------------



The GnuPG public key used to sign the current and new releases is available in

[dist/signingkey-new.asc](https://github.com/defuse/php-encryption/raw/master/dist/signingkey-new.asc). Its fingerprint is:



```

6DD6 E677 0281 5846 FC85  25A3 DD2E 507F 7BDB 1669

```



You can verify it against Taylor Hornby's [contact

page](https://defuse.ca/contact.htm) and

[twitter](https://twitter.com/DefuseSec/status/1670840796743081984).



Older releases were signed with a (now-expired) available in

[dist/signingkey-old.asc](https://github.com/defuse/php-encryption/raw/master/dist/signingkey-old.asc). The old key's fingerprint is:



```

2FA6 1D8D 99B9 2658 6BAC  3D53 385E E055 A129 1538

```



The old key's fingerprint can be verified against Taylor Hornby's [contact page](https://defuse.ca/contact.htm) and

[twitter](https://twitter.com/DefuseSec/status/723741424253059074).



A signature of this new key by the old key is available in

[dist/signingkey-new.asc.sig](https://github.com/defuse/php-encryption/raw/master/dist/signingkey-new.asc.sig).