projek-xyz/ci-startapp

Codeigniter 3 Application Starter Kit

Fund package maintenance!
Ko Fi

Installs: 22

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 2

Open Issues: 1

Type:project

dev-master 2020-10-19 17:13 UTC

This package is auto-updated.

Last update: 2021-09-19 19:56:37 UTC


README

Build Status Gittip Donate PayPal Donate

CodeIgniter-based Project Starter Kit

NOTE: This project is only used for my personal needs, but feel free to use it as yours.

Key Features

  1. Testable provided by Fernando Piancastelli
  2. HMVC provided by Jens Segers
  3. Better CLI Interaction
  4. Soon..

Prerequisites

  • PHP 5.5.x or newer.
  • HTTP Server, e.g. NginX or Apache either.
  • MySQL Server 5.x or newer for main database.
  • Redis Server for cache database.

Installation

I've make this project available to install via Composer with following command:

$ composer create-project -s dev projek-xyz/ci-startapp my-app

now enter my-app directory you just create then copy and rename env.txt file to .env under app directory.

$ cp app/env.txt app/.env

then edit contents of app/.env file as you wish. When everything is done, let's start the server.

$ php -S 0.0.0.0:8888 -t public public/index.php

Now, you should open http://localhost:8888 in your favorite web browser.

NOTE: Make sure your Redis server already running.

Directory and File Structures

  • app: Previously it is application directory defined with APPPATH constant. Inside it still remain the same as default CI APPPATH but without some unused directories, which are cache, hooks and third_party.
  • asset: Containts source of static assets (sass, js and images).
  • asset/data: Containts migration files.
  • public: This is the webroot of your application.
  • tests: Containts all tests units for your application.
  • creasi: This is the command line interface for your application. You could use it to install, migrate database and so on.

Testing

Currently this project only use PHPUnit as testing framework, another framework like PHPSpec, Behat etc will be implemented soon. The PHPUnit configuration is located inside tests directory, so you could run the tests with following command.

$ phpunit -c tests/phpunit.xml

NOTE: I only provide dummy tests, so you could create and use your own 😁

Credits

  1. CodeIgniter and their contributors

Lisence

MIT © Fery Wardiyanto. Please see License File for more information.