Skip to content
MARKO DOCS

Your First Application

This guide walks you through building a simple “Hello World” web application with Marko, introducing key concepts along the way.

1. Create the Project

Section titled “1. Create the Project”
Terminal window
composer create-project marko/skeleton hello-marko
cd hello-marko

2. Create a Controller

Section titled “2. Create a Controller”

Controllers handle HTTP requests. Create one using PHP attributes to define routes:

app/foo/src/Controller/GreetingController.php
<?php


declare(strict_types=1);


namespace App\Foo\Controller;


use Marko\Routing\Attribute\Get;
use Marko\Http\Response;
use Marko\Http\ResponseInterface;


class GreetingController
{
    #[Get('/hello/{name}')]
    public function greet(string $name): ResponseInterface
    {
        return new Response(
            body: "Hello, {$name}! Welcome to Marko.",
        );
    }
}

3. Register Your Module

Section titled “3. Register Your Module”

Your app/foo/ directory needs a composer.json to be recognized as a module:

app/foo/composer.json
{
    "name": "app/foo",
    "type": "marko-module",
    "autoload": {
        "psr-4": {
            "App\\Foo\\": "src/"
        }
    },
    "extra": {
        "marko": {
            "module": true
        }
    }
}

Place the controller at app/foo/src/Controller/GreetingController.php.

4. Start and Test

Section titled “4. Start and Test”
Terminal window
marko up

Visit http://localhost:8000/hello/World and you’ll see:

Hello, World! Welcome to Marko.

5. Add a JSON Endpoint

Section titled “5. Add a JSON Endpoint”

Marko makes JSON responses simple:

app/foo/src/Controller/ApiController.php
<?php


declare(strict_types=1);


namespace App\Foo\Controller;


use Marko\Routing\Attribute\Get;
use Marko\Http\JsonResponse;
use Marko\Http\ResponseInterface;


class ApiController
{
    #[Get('/api/hello/{name}')]
    public function greet(string $name): ResponseInterface
    {
        return new JsonResponse(
            data: ['message' => "Hello, {$name}!", 'framework' => 'Marko'],
        );
    }
}

What You’ve Learned

Section titled “What You’ve Learned”
  • Modules are Composer packages with marko.module: true
  • Routes are defined with PHP attributes (#[Get], #[Post], etc.)
  • Controllers are plain classes — no base class inheritance required
  • Marko auto-discovers modules in app/, modules/, and vendor/

Next Steps

Section titled “Next Steps”