Download the PHP package rith-1437/zeroping without Composer

ZeroPing Framework

About ZeroPing

ZeroPing is a lightweight, modern PHP framework built from scratch with a clean model–view–controller (MVC) architecture, a fast dependency-injection container, an expressive ORM, validation, caching, a background queue, a task scheduler, and developer-friendly CLI tooling. It is free, open-source, and created by Rin Nairith.

ZeroPing aims to be approachable for newcomers while remaining powerful enough for production applications — with zero magic, readable source, and no hidden configuration.

Key Features

• Expressive routing with named routes, route groups, prefixes, and middleware.
• Dependency Injection container with automatic resolution and reflection caching.
• Eloquent-style ORM with relationships, accessors/mutators, and pagination.
• Schema builder & migrations for versioned, reversible database changes.
• Validation with a rich rule set and custom rule support.
• Caching with multiple drivers and a per-request memory layer.
• Background queues (sync, database, file) and scheduled commands.
• Security middleware: CSRF protection, encryption, rate limiting, and HTML escaping.
• Blazing-fast CLI (php zero) for scaffolding, migrations, and maintenance.
• Zero external runtime dependencies beyond PHP itself.

What's New in v2.0.0

ZeroPing 2.0 is the Enterprise Framework Foundation — a zero-dependency, fully-tested PHP core with 20 integrated subsystems built from scratch:

• Dependency Injection container with automatic resolution and Service Providers.
• HTTP Kernel with middleware pipeline, API Resources (JSON resources + collections), and a full Response system.
• Validation engine with an extensive rule set and custom rule support.
• Localization (translator, lang/ files, trans() / __() helpers).
• Multi-driver Cache (file, array, database) with a per-request memory layer.
• Session management with multiple drivers.
• File Storage abstraction with local and extensible drivers.
• Testing harness compatible with PHPUnit — HTTP client, database assertions, and fluent TestResponse assertions.
• Benchmark and Profiler for performance measurement.
• Debug Toolbar with framework-collected telemetry.
• Security (hashing, encryption, secure random, CSRF, rate limiting).
• Logging (multi-channel via Monolog-style handlers).
• Error Handling — pretty exception pages in development, clean error views in production.
• Markdown documentation subsystem — app/Core/Docs serves /docs/{page} from resources/docs/.
• Scheduler — cron-based task scheduling with mutex support for overlapping prevention.

All 20 subsystems are fully tested: 375 tests, 901 assertions, 0 failures, and 0 phpcs warnings across the entire codebase.

Requirements

• PHP >= 8.1
• Composer
• MySQL / MariaDB (or another PDO-supported database)

Installation

Option A — Clone from GitHub (recommended)

The app will be available at http://localhost:1437. Run php zero doctor to verify your environment, or php zero install for an interactive wizard.

Option B — Composer (when Packagist is configured)

Start a new project with Composer (requires the package to be registered on Packagist):

Package name: rith-1437/zero-ping — all lowercase, with a hyphen (the GitHub repo is rith-1437/zero-ping).

Option C — Docker (development environment)

A Docker Compose setup is included for local development with PHP 8.3, Nginx, and MySQL:

The app will be available at http://localhost.

For VS Code users, a devcontainer configuration is also provided — reopen the project in the container for a zero-setup development environment.

Documentation

The full documentation lives in the docs/ directory and can be opened directly in a browser, or built into a static site. It covers installation, routing, the container, database, ORM, validation, caching, queues, scheduling, security, testing, deployment, extending the framework, and the CLI reference.

A quick tour of the most common commands:

Quick Start

A new ZeroPing project ships with a small demo website so you can see it running immediately. To add your own page alongside it, follow these three steps.

1. Register a route (add this to the end of config/routes.php):

2. Create a controller (app/Controllers/GreetingController.php):

3. Create a view (views/greeting.php):

Start the server and visit your page:

Project Structure

A freshly created ZeroPing project looks like this:

CLI Usage

ZeroPing includes a batteries-included CLI. The most common commands:

See the CLI Reference for the complete list.

Examples

ZeroPing ships with ready-made starter templates you can scaffold instantly:

A plan for additional example applications is available in docs/EXAMPLES.md.

Community

• 💬 Discussions: ask questions and share ideas at GitHub Discussions.
• 🐞 Issues: report bugs and request features using the issue templates.
• 🔒 Security: report vulnerabilities privately via our security policy.

Contributing

Thank you for considering contributing to ZeroPing! Please read the contribution guide before opening a pull request.

Code of Conduct

To ensure the ZeroPing community stays welcoming to everyone, please review and abide by our Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within ZeroPing, please review our security policy for responsible disclosure instructions. You can report issues privately to Rin Nairith at [email protected].

License

ZeroPing is open-source software licensed under the MIT license.