README

By Alex Weissman and Louis Charette

UserFrosting is a secure, modern user management system written in PHP and built on top of the Slim Microframework, Twig templating engine, and Eloquent ORM.

This Core Sprinkle provides most of the "heavy lifting" PHP code. It provides all the necessary services for database, templating, error handling, mail support, request throttling, and more.

Installation in your UserFrosting project

To use this sprinkle in your UserFrosting project, follow theses instructions (N.B.: This sprinkle is enabled by default when using the base app template).

Require in your UserFrosting project :

composer require userfrosting/sprinkle-core

Add the Sprinkle to your Sprinkle Recipe :

public function getSprinkles(): array
{
    return [
        \UserFrosting\Sprinkle\Core\Core::class,
    ];
}

Bake
```
php bakery bake
```

Install locally and run tests

You can also install this sprinkle locally. This can be useful to debug or contribute to this sprinkle.

Clone repo :

git clone https://github.com/userfrosting/sprinkle-core.git

Change directory
```
cd sprinkle-core
```
Install dependencies :
```
composer install
```
Run bake command :
```
php bakery bake
```

From this point, you can use the same command as with any other sprinkle.

Tests can be run using the bundled PHPUnit :

vendor/bin/phpunit

Same for PHPStan, for code quality :

vendor/bin/phpstan analyse app/src/

Documentation

See main UserFrosting Documentation for more information.

Contributing

This project exists thanks to all the people who contribute. If you're interested in contributing to the UserFrosting codebase, please see our contributing guidelines as well as our style guidelines.

userfrosting / sprinkle-core

Maintainers

Details