Tick PHP is a lightweight, convention-over-configuration PHP framework designed for speed and simplicity. It brings the best of modern development practices—like Auto-Discovery, Dependency Injection, and JWT Authentication—to native PHP without the bloat.

Created by Alvian Zachry Faturrahman.
🌐 Website: https://alvianzf.id

• Auto-Discovery Routing: No route files. Your Controller methods define your API.
• Dependency Injection: Built-in Container auto-wires your Controllers, Services, and Repositories.
• Database Agnostic:
  • SQL ORM: Fluent API using PDO (MySQL, SQLite, Postgres).
  • NoSQL ODM: File-based or MongoDB support via Document class.
• Central Configuration: Simple config/ system.
• Zero-Dependency JWT: Native, secure HS256 Token Authentication.
• Auto Documentation: Generates swagger.json and Markdown docs automatically.
• Powerful CLI: Generate resources, run server, and build docs with tick.

1. Clone the repository:

   git clone https://github.com/alvianzf/tick-php-framework.git
   cd tick-php-framework

2. Install dependencies:

   composer install
   # OR
   composer dump-autoload

3. Start the server:

   php tick serve

   Your API is now running at http://localhost:8080.

The tick tool is your best friend.

You don't define routes manually. Tick scans your app/ folder.

Structure:

app/
  Users/
    UsersController.php

Use constructor injection to manage dependencies. The Container handles the rest.

use App\Users\UsersService;

class UsersController {
    protected $service;

    // Automatic Injection
    public function __construct(UsersService $service) {
        $this->service = $service;
    }
}

Tick PHP supports multiple database connections out of the box.

Edit config/database.php to configure your connections.

• SQL: MySQL, PostgreSQL, SQLite (via PDODriver).
• NoSQL: MongoDB (via MongoDriver), JSON Files (via JsonDriver).

To switch the default connection:

// config/database.php
'default' => 'mysql',

For relational databases.

1. Define a Model:

   namespace App\Users;
   use Tick\Database\Model;
   
   class Users extends Model {
       protected $table = 'users';
       // Optional: Override connection for this specific model
       // protected $connection = 'pgsql'; 
   }

2. Use it:

   // Create
   Users::create(['name' => 'John', 'email' => 'john@doe.com']);

For document storage.

1. MongoDB Setup:

   composer require mongodb/mongodb

   Then configure the mongodb connection in config/database.php.

2. Define a Document:

   use Tick\Database\Document;
   
   class Log extends Document {
       protected $collection = 'logs';
       // Optional: Use MongoDB instead of JSON
       protected $connection = 'mongodb'; 
   }

1. Generate Auth Module:

   php tick g jwt

2. Protect Routes: Use the AuthMiddleware in your controller.

   use Tick\Middleware\AuthMiddleware;
   
   public function secret($req, $res) {
       (new AuthMiddleware())->handle($req, $res);
       $res->json(['user' => $req->user]);
   }

Never write docs manually again.

• Swagger: php tick g swagger -> Imports into Postman/Swagger UI.
• Markdown: php tick g docs -> Readable API_DOCS.md for GitHub.

This project is open-sourced software licensed under the MIT license.