Ginkgo PHP Framework Overview, System Requirements, Directory Structure, and v0.1.2 Changelog

ginkgo is a free open‑source lightweight PHP development framework evolved from several Baigo open‑source PHP systems, designed for simplicity and ease of use, released under the Apache2 license, and supports Composer.

It follows the MVC (Model‑View‑Controller) pattern, with relatively independent modules that simplify system upgrades.

ginkgo 的环境要求如下

PHP >= 5.3.0

PDO PHP Extension

GD PHP Extension

MBstring PHP Extension

cURL PHP Extension

目录结构

project 应用部署目录
+-- app                   应用目录（可设置）
|  +-- classes            类库目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- config             配置目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- ctrl               控制器目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- lang               语言目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- model              数据模型目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- tpl                模板目录
|  |  +-- module1         模块1（示例）
|  |  |  +-- default      default 模板（示例）
|  |  |  +-- test         test 模板（示例）
|  |  |
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- validate           验证器目录
|  |  +-- module1         模块1（示例）
|  |  +-- module2         模块2（示例）
|  |  +--  ...            更多模块
|  |
|  +-- common.php         公共文件
|
+-- ginkgo                框架系统目录
|  +-- lang               语言包目录
|  +-- core               框架内核目录
|  +-- tpl                系统模板目录
|  +-- base.php           框架基本引导文件
|  +-- boot.php           框架引导文件
|  +-- const.php          常量定义文件
|  +-- convention.php     默认配置文件
|  +-- CHANGELOG.md       更新日志
|  +-- LICENSE.txt        授权说明文件
|  +-- SPECIFICATION.md   开发规范
|  +-- README.md          README 文件
|
+-- extend                扩展目录（可定义）
|  +-- plugin             插件目录
|  +--  ...               更多类库
|
+-- public                web 部署目录（公开访问目录）
|  +-- static             静态资源存放目录（css、js、image）
|  +-- index.php          入口文件
|  +-- .htaccess          用于 apache 的重写
|
+-- runtime               运行时目录（可写、可设置）
+-- vendor                第三方类库目录（Composer）
+-- composer.json         composer 定义文件

版本更新 v0.1.2

Improved database debugging and SQL statement logging.

Enhanced error debugging functionality.

Fixed issue where $request could not be used in templates.

Added support for ginkgo\Ubbcode class.

Fixed parameter order bug in ginkgo\db\connect\Mysql related to the where method.

Improved ginkgo\Config load method to check file existence before throwing errors.

Enhanced ginkgo\App configuration loading to automatically load config files matching controller names.

Added getRegex method to ginkgo\Func for obtaining regex match results.

Extended arrayFilter in ginkgo\Func with a second parameter to optionally remove entries equal to FALSE.

Fixed path definition issue in ginkgo\response\Redirect remember method.

Fixed argument ignoring bug in ginkgo\Route build method.

Resolved captcha ID specification problem in ginkgo\Validate class.

Added ginkgo\Auth login authentication class for unified management of authentication information.

Optimized syntax and comments of several classes.

Improved input filtering rules.

Fixed occasional issues caused by case‑insensitive replacement rules in some classes.

Added constants in ./const.php for capacity calculations.