The Framework for
Content Applications

• GET, POST, PUT, DELETE, PATCH methods
• Named routes with programmatic URL generation
• Required, optional, and wildcard parameters
• Per-route and global middleware pipelines

$router->get('/posts/{slug}', [PostController::class, 'show'], 'posts.show');
$router->post('/contact', [ContactController::class, 'submit']);

// Optional parameters
$router->get('/archive/{year?}', function (Request $request, ?string $year = null) {
    return "Archive for " . ($year ?? date('Y'));
});

// Wildcard — captures everything including slashes
$router->get('/docs/{path*}', [DocsController::class, 'render']);

• Core services manually wired for maximum performance
• Autowiring available as a pragmatic fallback
• No static proxies or facades
• Standard injection patterns

class PageController
{
    public function __construct(
        private PageService $pages,
        private CacheInterface $cache,
    ) {}

    public function show(Request $req, string $slug): Response
    {
        $page = $this->cache->remember(
            "page:{$slug}", 3600,
            fn() => $this->pages->findBySlug($slug)
        );

        return view('pages.show', ['page' => $page]);
    }
}

• Chainable query API with prepared statements
• Joins, subqueries, and aggregates
• find(), first(), pluck(), paginate() helpers
• Automatic query caching via cache driver

$posts = $db->table('posts')
    ->where('status', 'published')
    ->where('published_at', '<=', now())
    ->orderBy('published_at', 'desc')
    ->limit(10)
    ->get();

// Shorthand lookups
$post = $db->table('posts')->find(42);
$titles = $db->table('posts')->pluck('title');

• Self-contained packages with routes, views, migrations
• Version constraints and dependency resolution
• Conflict detection and load-order management
• module.json manifest for declarative config

{
    "name": "velvetcms/blog",
    "version": "1.0.0",
    "requires": {
        "velvetcms/core": "^1.0"
    },
    "providers": ["VelvetCMS\\Blog\\BlogModule"]
}

• Familiar template syntax with @directives
• Layout inheritance and section blocks
• Namespaced views for module isolation
• Global data sharing via share()

// Render a view with data
return view('posts.show', ['post' => $post]);

// Namespaced module views
return view('blog::posts.index');

// Share data with all views
$view->share('siteName', 'My Site');

• Fluent API: hourly(), dailyAt(), everyMinute()
• Schedule commands or inline closures
• Overlap prevention and run-on-one-server
• Output logging and failure notifications

$schedule->command('sitemap:generate')->dailyAt('03:00');
$schedule->command('cache:prune')->hourly();

$schedule->call(function () {
    $this->analytics->aggregate();
})->everyMinute()->withoutOverlapping();

• Three drivers: APCu, File, Redis
• Query result caching with automatic invalidation
• Route and compiled view caching
• remember() pattern for lazy population

$cache->set('key', $value, 3600);
$value = $cache->get('key');

// Lazy population — only computes if not cached
$stats = $cache->remember('dashboard:stats', 900, function () {
    return $this->analytics->computeStats();
});

• Frontmatter extraction (YAML metadata)
• GFM tables, task lists, strikethrough
• Pluggable driver architecture
• Syntax highlighting for code fences

---
title: "Getting Started"
author: "Anvyr"
tags: [guide, tutorial]
---

# Welcome to Core

Build something **great** with:

- [x] Routing
- [x] Query builder
- [ ] Your imagination

• Fluent rule definitions
• Works in any context: HTTP, CLI, API
• Custom rules and error messages
• Request-level validation shorthand

$v = Validator::make($data, [
    'title'  => 'required|string|max:200',
    'email'  => 'required|email',
    'status' => 'in:draft,published,archived',
]);

if ($v->fails()) {
    $errors = $v->errors();
}

• Blueprint API for table definitions
• Up/down migrations with rollback
• Index, foreign key, and constraint support
• SQLite, MySQL, PostgreSQL drivers

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title', 200);
    $table->string('slug')->unique();
    $table->text('content');
    $table->enum('status', ['draft', 'published'])->default('draft');
    $table->timestamps();
});

• Host-based, path-based, or custom resolvers
• Per-tenant databases, storage, and config
• Single config switch to enable
• Tenant-aware paths and URL generation

// config/tenancy.php
return [
    'enabled'  => true,
    'resolver' => 'host',  // 'host', 'path', or custom class
    'isolate'  => ['database', 'storage', 'cache'],
];

Every dependency is injected. Every side-effect is explicit. When something breaks, Ctrl+Click takes you directly to the source — no facade resolution, no service container magic, no hidden boot sequence.