PHPackages                             florianeckerstorfer/passwordplease-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. florianeckerstorfer/passwordplease-php

ActiveLibrary[Authentication & Authorization](/categories/authentication)

florianeckerstorfer/passwordplease-php
======================================

v0.2(11y ago)316MITPHP

Since Sep 3Pushed 11y ago1 watchersCompare

[ Source](https://github.com/florianeckerstorfer/passwordplease-php)[ Packagist](https://packagist.org/packages/florianeckerstorfer/passwordplease-php)[ RSS](/packages/florianeckerstorfer-passwordplease-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (2)Dependencies (5)Versions (5)Used By (0)

[![Password Please](https://camo.githubusercontent.com/73a420d6553686f81793c60ede17a2650f6ee158a20f618317f5cd2072d53096/68747470733a2f2f666c6f7269616e2e65632f696d672f70617373776f72642d706c656173652f6c6f676f2e706e67)](https://camo.githubusercontent.com/73a420d6553686f81793c60ede17a2650f6ee158a20f618317f5cd2072d53096/68747470733a2f2f666c6f7269616e2e65632f696d672f70617373776f72642d706c656173652f6c6f676f2e706e67)

================= > **Password, Please!** generates secure passwords in PHP. You can use it as a command line application or as a library in your code.

[![Build Status](https://camo.githubusercontent.com/e5a6eae0005fafef774d4e3359da1e39a001e93286939deac35a9264fd4b2bc5/68747470733a2f2f7472617669732d63692e6f72672f666c6f7269616e65636b657273746f726665722f70617373776f7264706c656173652d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/florianeckerstorfer/passwordplease-php)

Command Line Application
------------------------

[](#command-line-application)

Downloading the PHAR archive from the [releases page](https://github.com/florianeckerstorfer/passwordplease-php/releases) page is the easiest way to get the command line application. The other way is to clone this repository and execute the `bin/password-please.php` file.

```
$ git clone https://github.com/florianeckerstorfer/passwordplease-php
$ cd password-please-php
$ php bin/password-please.php gen
```

### Usage

[](#usage)

If you call the binary without any arguments you will get a password of length 20 with lower and upper case letters, numbers and special characters. You can change both the length and the complexity.

```
$ php password-please.phar gen --length=30 --complexity=3
```

The length must be greather than `0` and complexity must be a value between `1` (very high complexity) and `4`(low complexity). If you're a hasty person, you can use the shorter aliases for the options:

```
$ php password-please.phar gen -l 30 -c 3
```

Instead of using the numeric identifier for the complexity, you can also use a high-level string description of the complexity. The following table details the available complexities, the characters used in it and the high-level names:

   Complexity Level Alias Characters     `VERY_HIGH` `1` `veryhigh`, `harder` `a-zA-Z0-9,;.:-_+*#!()=?%&@$"'`   `HIGH` `2` `high`, `hard` `a-zA-Z0-9`   `MEDIUM` `3` `medium`, `normal` `a-zA-Z`   `LOW` `4` `low`, `easy` `a-z`  Library
-------

[](#library)

If you want to use **Password, Please!** in your code you can add the library to your dependencies using [Composer](http://getcomposer.org).

```
$ composer require florianeckerstorfer/passwordplease-php:@stable
```

*Tip: You should replace `@stable` with a specific version from the [releases](https://github.com/florianeckerstorfer/passwordplease-php/releases) page.*

### Usage

[](#usage-1)

**Password, Please!** depends on [ircmaxell/random-lib](https://github.com/ircmaxell/RandomLib) to generate passwords and you need to pass an instance of `\RandomLib\Generator` to the constructor.

```
use Fe\PasswordPlease\PasswordPlease;

$factory = new \RandomLib\Factory;
$generator = $factory->getGenerator(new \SecurityLib\Strength(\SecurityLib\Strength::MEDIUM));

$pp = new PasswordPlease($generator);
$password = $pp->generatePassword(30, PasswordPlease::COMPLEXITY_HIGH);
```

Change Log
----------

[](#change-log)

### Version 0.2 (4 October 2014)

[](#version-02-4-october-2014)

- Add string alias for complexities
- Change order of complexities, `1` is now very high and `4` is low

### Version 0.1 (3 September 2014)

[](#version-01-3-september-2014)

- Initial release

Author
------

[](#author)

Developed by [Florian Eckerstorfer](https://florian.ec) in Vienna, Europe.

License
-------

[](#license)

The MIT license applies to `florianeckerstorfer/passwordplease-php`. For the full copyright and license information, please view the `LICENSE` file distributed with this source code.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Total

4

Last Release

4242d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a80f9fc61cd3a7d7779e8f120b458ca4d18fdd885d719bb77d3379b96bf714d9?d=identicon)[florianeckerstorfer](/maintainers/florianeckerstorfer)

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/florianeckerstorfer-passwordplease-php/health.svg)

```
[![Health](https://phpackages.com/badges/florianeckerstorfer-passwordplease-php/health.svg)](https://phpackages.com/packages/florianeckerstorfer-passwordplease-php)
```

###  Alternatives

[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[dflydev/hawk

Hawk

672.0M12](/packages/dflydev-hawk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)