These are the docs for Divergence 3.3.0. Start with a model, give it a controller, and build your application from there. The framework includes an ActiveRecord ORM, MySQL/PostgreSQL/SQLite support, indexed collections, statistics, Twig responses, and media handling.

If this is your first project, start with Getting Started. If you're here for the data layer, read ORM, Collections, and Math. You can use collections and Math without a database.

The 3.3 source requires PHP 8.4 or newer. These pages describe the implementation, including places where you need to supply application policy or configuration. They do not assume the starter files are a finished website.

• Getting Started

  • Server Prerequisites
  • Bootstrap a New Project
  • How to Bootstrap Manually (Advanced)
  • Establish Your Classes Directory
  • Configure Database Access
  • Take Over Control From The Framework
  • Configuring nginx or apache2 Servers

• Architectural Concepts

  • Request Respond Emit
  • Boot Flow
  • Path Stack Routing
  • Response Builders
  • Endpoint Based Controllers
  • Data Layer

• Command Line Tool

  • Installation
  • Initializing a Project
  • Testing Your Database Config
  • Change Your Database Config
  • Tool Usage Reference

• Agentic MVP Guide

  • Rules For The Agent
  • Minimum Structure
  • Web Setup
  • SQLite MVP Setup
  • MySQL MVP Setup
  • PostgreSQL MVP Setup
  • CLI Setup
  • Minimum JSON-To-DB Example

• Project Structure

  • Load Order
  • Folder Structure
  • The App Class
  • Configs
  • Development & Production
  • Database Labels
  • Error Handling

• Database

  • Connection Configurations
  • Choosing the Connection
  • Queries
  • Transactions
  • Schema Creation and Portability

• ORM

  • Model Architecture
  • Making a Basic Model
  • Create, Update, and Delete
  • Getter Layer and Factory Runtime
  • Versioning
  • Relationships
  • Relationships Reference
  • Supported Field Types
  • ORM Typing Explanation
  • Canary Model - An Example Utilizing Every Field Type
  • Validation
  • Event Binding
  • Advanced Techniques

• Collections

  • Making a Collection
  • Indexing and Finding
  • Adding, Removing, and Changing Records
  • ORM Collections

• Math

  • Method Reference
  • Percentiles Aren't Always Medians
  • Variance, Standard Deviation, and Relationships
  • Histograms
  • Frequency and Mode
  • Rankings and Outliers
  • Moving Averages and Rolling Windows
  • Accounting With Integer Cents

• Controllers

  • Intro to Tree Routing
  • RequestHandler
  • Your Own Controllers
  • RecordsRequestHandler
    • Building an API
    • Permissions
    • Security
    • JSON API Reference
      • Browse (Read Many)
      • One Record (Read One)
      • Edit One Record
      • Create One Record
      • Delete One Record
      • Create or Edit Multiple Records
      • Delete Multiple Records
    • MediaRequestHandler

• Media

  • Server Setup
  • Creating Media
  • HTTP Routes
  • Thumbnails and Variants
  • Streaming

• Views

  • Responding with a Template
  • Template Lookup Rules

• Security

  • User Model
  • Session Model
  • Authentication
  • Logged-In State
  • Binding Permissions
  • Practical Minimum

• Developing

  • Get the Source Code
  • Unit Testing
  • How Mock Data is Made
  • Static Analysis
  • Style Guide

• Addendum

  • About