Loading repository data…
Loading repository data…
someline / repository
Someline Starter is a PHP framework for quick building Web Apps and Restful APIs, with modern PHP design pattern foundation.
Tested and used in production by Someline Inc.
[![Latest Version on Packagist][ico-version]][link-packagist] ![Software License][ico-license]
Someline Starter is a PHP framework for quick building Web Apps and Restful APIs, with modern design pattern foundation.
It is built on top of popular Laravel 5.8 framework, Vue.js 2.6, Restful API, Repository Design, OAuth2, JWT, Unit Tests, isolated front-end and back-end layer.
Quick web application starter without the need to build from scratch using Laravel.
Isolated front-end and back-end layer using Restful API.
Introducing modern design pattern, which have a better foundation when starting, for PHP projects.
Frontend with Vue.js and displaying data via Restful API
Email: libern@someline.com
Password: Abc12345
Watch the video tutorial from below.
YouTube: https://youtu.be/6_lxJNX0Qe0
Someline Starter is suitable for Restful API oriented projects.
The Restful APIs as a backend layer which provide simple unified interfaces for frontend: Web and Mobile apps.
It utilized Laravel Passport to authenticate protected resources.
It also provides Unit Tests for API testing and framework testing.
It is shipped with Angulr Theme and features in every part that you can easily reference.
It is fully utilised Repository Design pattern.
Framework
Foundation
Core
Authentication
Theme
Angulr theme with Bootstrap and jQuery support. For Demo: Angular version and HTML version.
Please buy a license if you use this in your project.
Frontend
Make sure you have already installed PHP 7.1 and composer.
You can get started either option A or B:
Under working folder, run the command:
composer create-project --prefer-dist someline/someline-starter someline-starter
Change https://github.com/username/repository-name.git to your own git repository address.
cd someline-starter
git init
git add .
git commit -m 'Initial commit'
git remote add origin https://github.com/username/repository-name.git
git push -u origin master
Clone this project to your working folder and open the directory:
git clone https://github.com/someline/someline-starter
Change https://github.com/username/repository-name.git to your own git repository address.
cd someline-starter
rm -rf .git
git init
git add .
git commit -m 'Initial commit'
git remote add origin https://github.com/username/repository-name.git
git push -u origin master
Open someline-starter folder (Optional, run only when you are not inside the project root folder)
cd someline-starter
All these commands should be executed under the root of someline-starter project
Install composer dependencies
composer install
Install npm dependencies using Yarn dependency management (suggested)
Note: This command should be outside homestead environment. Also, you can still use npm install if you want.
yarn install
Install bower dependencies
bower install
Set-up Laravel, after these commands, please change .env file for your own environment settings
sudo cp .env.example .env
sudo chmod -R 777 storage bootstrap/cache
php artisan key:generate
You need to create a Database e.g. someline_starter with Encoding utf8mb4 and Collation utf8mb4_unicode_ci.
MySQL Query:
CREATE DATABASE `someline_starter` DEFAULT CHARACTER SET = `utf8mb4` DEFAULT COLLATE = `utf8mb4_unicode_ci`;
Change database config in .env file to the match the database that your just created.
After having database configuration setup, you can now do migrations and seeding.
php artisan migrate
php artisan db:seed
Install Laravel Passport with encryption keys to generate secure access tokens.
php artisan passport:install
When deploy in server:
sudo chown www-data:www-data storage/oauth-*.key
sudo chmod 600 storage/oauth-*.key
Until this point, you should be able to visit the home page.
For example, if you have set the domain: http://someline-starter.sl/.
Just visit: http://someline-starter.sl/
It should prompt you for login, use:
libern@someline.com
Abc12345
You are free to change the seeding account information from the file: database/seeds/UsersTableSeeder.php
You are done. Yeah!
Explore and start to build on top of it.
You will need to know, read and understand fowllowing before you can start build on top of these.
We recommend use PHPStorm IDE to build and develop your projects.
The default namespace for app/ folder is Someline.
It is NOT recommended to change the namespace, if you are not familiar with namespace of Someline Starter as the Someline namespace is used heavily within whole project.
However, you can still change it if you know how what you are doing, because some namespaces required manually changing.
To change namespace to your preference:
php artisan app:namespace YourApp
In order to utilize all features provided by Someline Starter, you should extended the Class from BaseClass (if there has one), e.g. BasePresenter, BaseController, etc.
All models are located under app/Models/ folder.
User Model under folder app/Models/Foundation/ is created by default with primary key user_id, you should not change this class heavily because it is used almost everywhere within whole project. You can use global function auth_user() to access currently logged in user.
Every model should extend Someline/Models/BaseModel which has a observer Someline/Observers/BaseModelObserver that you can utilize all model events within the Model, e.g. onCreating, onCreated, onUpdating, onDeleting, etc.
When creating new model, you should do it using command to auto generate related Repository classes.
php artisan starter:entity Post
All Web related files are located under app/Http/ folder.
Web Routes are defined in file routes/web.php
Web Controllers are defined in folder app/Http/Controllers/
All API related files are located under app/Api/ folder.
API Routes are defined in file routes/api.php
API Controllers are defined in folder app/Api/Controllers/
When you create APIs, you need to test them before you can use it. You should test all APIs using Unit Tests provided or create new Unit Tests. Not recommended to test using Browser or Postman, etc.
All repository related files are located under app/ with specific types as parent folders.
Repositories: app/Repositories/
Repositories Eloquent: app/Repositories/Eloquent/
Repositories Interface: app/Repositories/Interfaces/
Repositories Criteria: app/Repositories/Criteria/
Presenters: app/Presenters/
Transformers: app/Transformers/
Validators: app/Validators/
Angulr Styles and Scripts: resources/assets/angulr/
Angulr with Blade views: resources/views/angulr/
Vuejs: resources/assets/js/
Less styles: resources/assets/less/app.less
Sass styles: resources/assets/sass/app.scss
When made changes in scripts, styles, you will need to run the command.
In development, run:
yarn run dev
In development and watching assets for changes, run:
yarn run watch
In production, run:
yarn run production
When you changed theme files, run:
yarn run theme
Note:
You may need to change the local service configs under dev environment from config/rest-client.php to fit your local development configurations.
Also change the value of API_TEST_CLIENT_SECRET in .env file to the secret value of Password Grant Client record in oauth_clients table.
Unit Tests: tests/
API Unit Tests: tests/Api/
View all requests and request information from file storage/clockwork.sqlite
OAuth HTTP URL: http://someline-starter.sl/console/oauth
Log Viewer HTTP URL: http://someline-starter.sl/console/logs
Directly changing from database or not follow migrations is strongly NOT recommended.
Create a migration file (Auto generated when use php artisan starter:entity), under folder database/migrations/
Add essential columns to migration file (Auto generated when use php artisan starter:entity):
You are recommended to use tablename_id format as primary incremental key, for example, for table posts, you need to use post_id, and when this become a foreign key, you should keep the same name in other table post_id.
$table->increments('post_id');
``