PHPackages                             usercandy/usercandy-framework - 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 &amp; Authorization](/categories/authentication)
4. /
5. usercandy/usercandy-framework

ActiveProject[Authentication &amp; Authorization](/categories/authentication)

usercandy/usercandy-framework
=============================

User Management Framework for PHP 7.1.3+

1.0.5(6y ago)261MITPHPPHP &gt;=7.1.3

Since Dec 14Pushed 5y ago2 watchersCompare

[ Source](https://github.com/UserCandy-Framework/UserCandy)[ Packagist](https://packagist.org/packages/usercandy/usercandy-framework)[ Docs](https://github.com/UserCandy-Framework/UserCandy)[ RSS](/packages/usercandy-usercandy-framework/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (5)DependenciesVersions (9)Used By (0)

[![UserCandy](https://camo.githubusercontent.com/5254e4da29957e2871efacf8d1e2bf6943f4e2e7ddee72618691ad655a05cb67/68747470733a2f2f64656d6f2e7573657263616e64792e636f6d2f54656d706c617465732f44656661756c742f4173736574732f696d616765732f5573657243616e64794c6f676f4c47426c61636b2e706e67)](https://camo.githubusercontent.com/5254e4da29957e2871efacf8d1e2bf6943f4e2e7ddee72618691ad655a05cb67/68747470733a2f2f64656d6f2e7573657263616e64792e636f6d2f54656d706c617465732f44656661756c742f4173736574732f696d616765732f5573657243616e64794c6f676f4c47426c61636b2e706e67)

---

UC Version 1.0.0
================

[](#uc-version-100)

[![Discord](https://camo.githubusercontent.com/9efd77fc00d5389fb21abbecadc2de21e428fed2cb84f6372fababe22a69eff4/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3631353439333538303336363238323735333f6c6162656c3d446973636f726425323043686174)](https://discord.gg/XATkVce)[![Join the chat at https://gitter.im/UserCandyFramework/community](https://camo.githubusercontent.com/37b71e1ce183f4ee630f818196f982c56f4c223c1d829b4d6baa0c3a07fdcf9f/68747470733a2f2f696d672e736869656c64732e696f2f6769747465722f726f6f6d2f6e776a732f6e772e6a732e737667)](https://gitter.im/UserCandyFramework/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

---

What is UserCandy?
------------------

[](#what-is-usercandy)

UserCandy is a Free Open Source User Management PHP Framework built from the ground up to be Easy and Powerful. Easy for Beginners and Powerful for Experts.

---

Documentation
-------------

[](#documentation)

Full docs &amp; tutorials are available at [www.usercandy.com](https://www.usercandy.com/)

---

Demo Website
------------

[](#demo-website)

Check out the demo website at [demo.usercandy.com](https://demo.usercandy.com/)

---

Requirements
------------

[](#requirements)

The UserCandy server system requirements are limited.

- Apache Web Server or equivalent with mod rewrite support.
- IIS with URL Rewrite module installed -
- PHP 7.1.3 or greater is required
- fileinfo enabled (edit php.ini and uncomment php\_fileinfo.dll or use php selector within cpanel if available.) mySQL Database Server or equivalent

UserCandy has been tested on the following systems. Others may cause issues. Please report in Forums if you have tried a different setup.

- Latest versions of Xammp on Windows 10
- Latest versions of LAMP stack on Ubuntu 16.01

---

Basic Installation
==================

[](#basic-installation)

1. Download the latest version of UserCandy Framework from UserCandy Downloads.
2. Unzip the UserCandy Framework zip file into your server directory. /var/www/html/ etc
3. Open your web browser and navigate to the url for your project.  etc
4. Follow the Installation instructions to create your config file and import data to database.
5. Once you have successfully installed the UserCandy Framework be sure your the first to Register.
6. Login to your UserCany Framework project and navigate to the AdminPanel from the dropdown by your username.
7. Chance settings as needed to fit your needs.
8. Enjoy your installation. If you run into any issues please post on the UserCandy Forum. We are happy to help.

---

Install with Composer
=====================

[](#install-with-composer)

UserCandy is on packagist [https://packagist.org/packages/usercandy/usercandy-framework](https://packagist.org/packages/usercandy/uc-user-management)

Install from terminal now by using:

```
composer create-project usercandy/usercandy-framework foldername dev-master

```

The foldername is the desired folder to be created.

Once installed on your server, open the site, and it will display an install script.

---

Install with everything inside your public folder (NOT Recommended)
===================================================================

[](#install-with-everything-inside-your-public-folder-not-recommended)

Option 1 - files above document root:

1. Download the latest version of UserCandy Framework from UserCandy Downloads.
2. Move index.php and .htaccess files to the webroot folder.
3. Open index.php and change the paths from using DIR to FILE:

```
define('ROOTDIR', realpath(__DIR__).'/');
define('SYSTEMDIR', realpath(__DIR__.'/system/').'/');
define('CUSTOMDIR', realpath(__DIR__.'/custom/').'/');

```

4. Edit .htaccess set the rewritebase if running on a sub folder otherwise a single / will do.
5. Edit /system/Example-Config.php settings to connect to your database. Refer to UserCandy Docs.
6. Rename the Example-Config.php to Config.php
7. Import the database.sql to your database (Updated table PREFIX if changed in Config.php).
8. Enjoy!

---

Setting up a VirtualHost (Optional but recommended)
===================================================

[](#setting-up-a-virtualhost-optional-but-recommended)

Navigate to:

```
\apache\conf\extra\httpd-vhosts.conf

```

and uncomment:

```
NameVirtualHost *:80

```

Then add your VirtualHost to the same file at the bottom:

```

    ServerAdmin webmaster@localhost
    DocumentRoot "C:\xampp\htdocs\testproject\public"
    ServerName testproject.dev

        Options Indexes FollowSymLinks Includes ExecCGI
        AllowOverride All
        Order allow,deny
        Allow from all

```

Finally, find your hosts file and add:

```
127.0.0.1       testproject.dev

```

You should then have a virtual host set up, and in your web browser, you can navigate to testproject.dev to see what you are working on.

---

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.1% of commits — single point of failure

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 ~6 days

Total

7

Last Release

2358d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/228646f314d75306469d10fbccd4d00e213f6df9fee75d4f22f78ee2d8a65c44?d=identicon)[TheDaVaR](/maintainers/TheDaVaR)

---

Top Contributors

[![davarravad](https://avatars.githubusercontent.com/u/12216243?v=4)](https://github.com/davarravad "davarravad (135 commits)")[![UserCandy-Framework](https://avatars.githubusercontent.com/u/54963565?v=4)](https://github.com/UserCandy-Framework "UserCandy-Framework (35 commits)")[![BryanYeh](https://avatars.githubusercontent.com/u/6684813?v=4)](https://github.com/BryanYeh "BryanYeh (5 commits)")

### Embed Badge

![Health badge](/badges/usercandy-usercandy-framework/health.svg)

```
[![Health](https://phpackages.com/badges/usercandy-usercandy-framework/health.svg)](https://phpackages.com/packages/usercandy-usercandy-framework)
```

###  Alternatives

[kartik-v/yii2-password

Useful password strength validation utilities for Yii Framework 2.0

761.3M17](/packages/kartik-v-yii2-password)[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)

PHPackages © 2026

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