dreamfactory: A PHP repository from leksa

DreamFactory 2.5.0

![Gitter](https://badges.gitter.im/Join Chat.svg)

Overview

DreamFactory(™) is an open source REST API backend for mobile, web, and IoT applications. It is built on top of the Laravel framework, and as such retains the requirements of the [Laravel v5.2 framework]

Get powerful, reusable, documented APIs for SQL, NoSQL, files, email, push notifications and more in seconds.
Use server-side scripts to easily customize API behavior at any endpoint, for both API requests and API responses.
Secure every API endpoint with user management, SSO authentication, role-based access control, OAuth and Active Directory integration.

Learn more at our website.

Documentation

Documentation for the platform can be found on the DreamFactory wiki.

Required software and extensions

Check our wiki installation page for the minimum software and extensions required for your system to successfully install and run DreamFactory 2.x.

Quick Setup

These instructions allow you to quickly install DreamFactory 2.x on your system and try it out. The commands shown here are primarily for a Linux based OS, but this should also work on Windows with all the required software and extensions installed.

Note: This quick setup instruction assumes that you are familiar with composer, git and the basics of how to setup a web and database server.

Clone this repository to a directory on your system.

git clone https://github.com/dreamfactorysoftware/dreamfactory.git ~/df2

Change directory.

cd ~/df2

Install dependencies using composer.

composer install --no-dev

Run DreamFactory setup wizard. First time running this will create your system environment file (.env), generate application key, and will prompt you to configure your Database.

php artisan dreamfactory:setup

Run the above command again to complete the setup process. This time it will run the database schema migration, seed the default services, and will prompt you to create your admin user account.

php artisan dreamfactory:setup

Make sure your web server can read/write from/to storage/ (sub directories) and bootstrap/cache/ directories.

Example:

sudo chown -R {www user}:{your user group} storage/ bootstrap/cache/
sudo chmod -R 2775 storage/ bootstrap/cache/

Run the following command to try out DreamFactory 2.x without configuring a Database and Web Server.

php artisan serve

Connecting to another Database Server after initial setup

To connect to a different Database Server after initial setup...

Edit the .env file at the installation root and change the following configuration.

DB_DRIVER=mysql ## Supported drivers are sqlite (default), mysql, pgsql
DB_HOST=localhost
DB_DATABASE=dreamfactory
DB_USERNAME=username
DB_PASSWORD=secret
DB_PORT=3306

Run following command to clear system cache.

php artisan cache:clear

Run DreamFactory setup wizard.

php artisan df:setup

Make sure your web server can read/write from/to storage/ (sub directories) and bootstrap/cache/ directories.