PHP HTML Other
Switch branches/tags
Clone or download
Latest commit 86128fc Sep 13, 2017
SandeeshS committed Sep 13, 2017 Removed request 'intersect' method usage to support Laravel 5.5. fixes
…#10 (Filters are not working in Laravel 5.5).
Permalink
Failed to load latest commit information.
app Removed request 'intersect' method usage to support Laravel 5.5. fixes Sep 13, 2017
bootstrap Added Laravel 5.4 source files. Apr 30, 2017
config Remove eloquent-sluggable package and create Slug class + HasSlug tra… May 12, 2017
database Updated model factories to generated unique timestamps for articles a… May 11, 2017
public Added Laravel 5.4 source files. Apr 30, 2017
resources Added Laravel 5.4 source files. Apr 30, 2017
routes Updated query filter to use reflection to detection available filter … Apr 30, 2017
storage Updated query filter to use reflection to detection available filter … Apr 30, 2017
tests Updated model factories to generated unique timestamps for articles a… May 11, 2017
.env.example Added cors support with configuration. May 1, 2017
.env.travis Added Travis CI. May 11, 2017
.gitattributes Added Laravel 5.4 source files. Apr 30, 2017
.gitignore Added barryvdh/laravel-ide-helper Apr 30, 2017
.travis.yml Added Travis CI. May 11, 2017
LICENSE Create LICENSE May 1, 2017
artisan Added Laravel 5.4 source files. Apr 30, 2017
composer.json Remove eloquent-sluggable package and create Slug class + HasSlug tra… May 12, 2017
composer.lock Composer Update. May 12, 2017
logo.png Initial commit with readme and logo Apr 30, 2017
package.json Added Laravel 5.4 source files. Apr 30, 2017
phpunit.xml Started writing feature tests for api. May 3, 2017
readme.md Updated readme.md to reflect new folder structure. May 14, 2017
server.php Added Laravel 5.4 source files. Apr 30, 2017
webpack.mix.js Added Laravel 5.4 source files. Apr 30, 2017

readme.md

Laravel Example App

Build Status Gitter GitHub stars GitHub license

Example Laravel codebase containing real world examples (CRUD, auth, advanced patterns and more) that adheres to the RealWorld spec and API.

This repo is functionality complete — PRs and issues welcome!


Getting started

Installation

Please check the official laravel installation guide for server requirements before you start. Official Documentation

Clone the repository

git clone git@github.com:gothinkster/laravel-realworld-example-app.git

Switch to the repo folder

cd laravel-realworld-example-app

Install all the dependencies using composer

composer install

Copy the example env file and make the required configuration changes in the .env file

cp .env.example .env

Generate a new application key

php artisan key:generate

Generate a new JWT authentication secret key

php artisan jwt:generate

Run the database migrations (Set the database connection in .env before migrating)

php artisan migrate

Start the local development server

php artisan serve

You can now access the server at http://localhost:8000

TL;DR command list

git clone git@github.com:gothinkster/laravel-realworld-example-app.git
cd laravel-realworld-example-app
composer install
cp .env.example .env
php artisan key:generate
php artisan jwt:generate 

Make sure you set the correct database connection information before running the migrations Environment variables

php artisan migrate
php artisan serve

Database seeding

Populate the database with seed data with relationships which includes users, articles, comments, tags, favorites and follows. This can help you to quickly start testing the api or couple a frontend and start using it with ready content.

Open the DummyDataSeeder and set the property values as per your requirement

database/seeds/DummyDataSeeder.php

Run the database seeder and you're done

php artisan db:seed

Note : It's recommended to have a clean database before seeding. You can refresh your migrations at any point to clean the database by running the following command

php artisan migrate:refresh

API Specification

This application adheres to the api specifications set by the Thinkster team. This helps mix and match any backend with any other frontend without conflicts.

Full API Spec

More information regarding the project can be found here https://github.com/gothinkster/realworld


Code overview

Dependencies

  • jwt-auth - For authentication using JSON Web Tokens
  • laravel-cors - For handling Cross-Origin Resource Sharing (CORS)

Folders

  • app - Contains all the Eloquent models
  • app/Http/Controllers/Api - Contains all the api controllers
  • app/Http/Middleware - Contains the JWT auth middleware
  • app/Http/Requests/Api - Contains all the api form requests
  • app/RealWorld/Favorite - Contains the files implementing the favorite feature
  • app/RealWorld/Filters - Contains the query filters used for filtering api requests
  • app/RealWorld/Follow - Contains the files implementing the follow feature
  • app/RealWorld/Paginate - Contains the pagination class used to paginate the result
  • app/RealWorld/Slug - Contains the files implementing slugs to articles
  • app/RealWorld/Transformers - Contains all the data transformers
  • config - Contains all the application configuration files
  • database/factories - Contains the model factory for all the models
  • database/migrations - Contains all the database migrations
  • database/seeds - Contains the database seeder
  • routes - Contains all the api routes defined in api.php file
  • tests - Contains all the application tests
  • tests/Feature/Api - Contains all the api tests

Environment variables

  • .env - Environment variables can be set in this file

Note : You can quickly set the database information and other variables in this file and have the application fully working.


Testing API

Run the laravel development server

php artisan serve

The api can now be accessed at

http://localhost:8000/api

Request headers

Required Key Value
Yes Content-Type application/json
Yes X-Requested-With XMLHttpRequest
Optional Authorization Token {JWT}

Refer the api specification for more info.


Authentication

This applications uses JSON Web Token (JWT) to handle authentication. The token is passed with each request using the Authorization header with Token scheme. The JWT authentication middleware handles the validation and authentication of the token. Please check the following sources to learn more about JWT.


Cross-Origin Resource Sharing (CORS)

This applications has CORS enabled by default on all API endpoints. The default configuration allows requests from http://localhost:3000 and http://localhost:4200 to help speed up your frontend testing. The CORS allowed origins can be changed by setting them in the config file. Please check the following sources to learn more about CORS.