Download the PHP package lawrence72/koala-framework without Composer

Koala Framework

A lightweight PHP framework focusing on simplicity and flexibility. It provides a robust foundation for building web applications with features like dependency injection, routing, database abstraction, and middleware support.

Table of Contents

• Introduction
• Getting Started
• Core Concepts
• Components
• Usage Guide

Getting Started

Installation

Basic Setup

1. Create an entry point (public/index.php):

2. Create a configuration file (config.php):

Core Concepts

Application Structure

The framework follows a modular structure with clear separation of concerns:

• Controllers: Handle HTTP requests
• Logic: Business logic layer
• Middleware: Request/Response filters
• Config: Application configuration
• Database: Data access layer
• Router: URL routing
• Container: Dependency injection

Dependency Injection

The framework uses a service container for dependency management:

Routing

Routes can be defined with groups and middleware:

Components

Database

Supports multiple database drivers:

• MySQL
• PostgreSQL
• SQLite
• SQL Server

Data Retrieval Methods

• fetchAll(string $sql, array $params = []): Fetch multiple rows
• fetchRow(string $sql, array $params = []): Fetch a single row
• fetchField(string $sql, array $params = []): Fetch single field from first row

Data Modification

• runQuery(string $sql, array $params = []): Execute any query (INSERT, UPDATE, DELETE, etc.)

Examples:

Request Handling

GET Parameters

• getQueryParams(): Get all GET parameters as array
• getQueryParam($key, $default = null): Get specific GET parameter by key

POST Data

• getPostParams(): Get all POST data as array
• getPostParam($key, $default = null): Get specific POST parameter by key

JSON Data

• getJsonParams(): Get all JSON data as array
• getJsonParam($key, $default = null): Get specific JSON parameter by key

Example Usage:

Utility Classes

Session Management

Cookie Management

Data Sanitization

The sanitizer handles:

• String trimming
• HTML special characters
• Allowed HTML tags
• Non-printable characters removal
• Nested arrays and objects
• Custom character encoding

Usage Examples

Creating a Controller

Creating Business Logic

Implementing Middleware