コアアプリケーション & ブートストラップファクトリ

Slim\ および Slim\Factory\ 名前空間に属する 7 つのコアランタイム・ブートストラップクラス（Slim\App、Slim\Factory\AppFactory、Slim\Factory\ServerRequestCreatorFactory、Slim\CallableResolver、Slim\MiddlewareDispatcher、Slim\ResponseEmitter、Slim\Logger）の完全 API リファレンスです。

from drawlib.canvas import save, setup
from drawlib.diagrams.architecture import ArchitectureDiagram, Node, NodeGroup, PhosphorIcon
from drawlib.styles import Styles

setup(width=148, height=78)

d = ArchitectureDiagram(
    node_style=Styles.Dark,
    node_text_style=Styles.DarkBold.patch(text_size=10.2),
    edge_style=Styles.Dark.patch(line_width=1.4),
    edge_text_style=Styles.Muted.patch(text_size=9.5),
    node_card_style=Styles.Neutral,
)

fac_grp = d.add(
    NodeGroup(
        "Slim\\Factory (静的ブートストラップ)",
        width=40,
        height=68,
        style=Styles.PrimaryNeutral,
        text_style=Styles.DarkBold.patch(text_size=10.5, halign="left", valign="top"),
    ),
    xy=(4, 5),
)
app_fac = fac_grp.add(
    Node(
        "AppFactory\n::create()",
        icon=PhosphorIcon.FACTORY,
        width=32,
        height=17,
        card_style=Styles.Neutral,
    ),
    xy=(20, 46),
)
req_fac = fac_grp.add(
    Node(
        "ServerRequestCreator\nFactory::create()",
        icon=PhosphorIcon.GLOBE,
        width=32,
        height=17,
        card_style=Styles.Neutral,
    ),
    xy=(20, 18),
)

core_grp = d.add(
    NodeGroup(
        "Slim\\ (アプリケーションカーネルと協調クラス)",
        width=92,
        height=68,
        style=Styles.SecondaryNeutral,
        text_style=Styles.DarkBold.patch(text_size=10.5, halign="left", valign="top"),
    ),
    xy=(52, 5),
)
app_node = core_grp.add(
    Node(
        "Slim\\App\n(RouteCollectorProxy)",
        icon=PhosphorIcon.CPU,
        width=32,
        height=17,
        style=Styles.White,
        text_style=Styles.WhiteBold.patch(text_size=10.2),
        card_style=Styles.PrimaryFlat,
    ),
    xy=(21, 46),
)
emitter_node = core_grp.add(
    Node(
        "ResponseEmitter\n::emit(response)",
        icon=PhosphorIcon.BROADCAST,
        width=32,
        height=17,
        card_style=Styles.Neutral,
    ),
    xy=(21, 18),
)
mw_disp = core_grp.add(
    Node(
        "MiddlewareDispatcher\n(LIFO Stack)",
        icon=PhosphorIcon.STACK,
        width=34,
        height=14,
        card_style=Styles.PrimaryNeutral,
    ),
    xy=(69, 52),
)
resolver = core_grp.add(
    Node(
        "CallableResolver\n('Class:method' / DI)",
        icon=PhosphorIcon.PLUGS_CONNECTED,
        width=34,
        height=14,
        card_style=Styles.Neutral,
    ),
    xy=(69, 32),
)
logger = core_grp.add(
    Node(
        "Slim\\Logger\n(PSR-3 error_log)",
        icon=PhosphorIcon.TERMINAL_WINDOW,
        width=34,
        height=14,
        card_style=Styles.Neutral,
    ),
    xy=(69, 12),
)

app_fac.connect(app_node, label="wires")
req_fac.connect(app_node, label="Request")
app_node.connect(mw_disp, label="handle()")
app_node.connect(emitter_node, label="run()")
mw_disp.connect(resolver, label="resolves")
app_node.connect(logger, label="logs")

d.draw(xy=(0, 0))
save()

classSlim\App#

• ソースファイル: Slim/App.php
• 名前空間: Slim
• 継承クラス: Slim\Routing\RouteCollectorProxy（RouteCollectorProxyInterface を実装）
• 実装インターフェース: Psr\Http\Server\RequestHandlerInterface
• ジェネリクス注釈: @template TContainerInterface of (ContainerInterface|null)

Slim\App は Slim 4 アプリケーションの中核カーネルです。RouteCollectorProxy を継承しているため、$app インスタンス上で直接ルーティング定義メソッド（get(), post(), put(), delete(), options(), patch(), any(), map(), group(), redirect()）を呼び出せるほか、PSR-15 の RequestHandlerInterface を実装しているため、外部の PSR-15 ランナーへの組み込みやテストコードからの $app->handle($request) 直接実行が可能です。

PHP クラスシグネチャ (Slim\App)#

namespace Slim;

use Psr\Container\ContainerInterface;
use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Psr\Log\LoggerInterface;
use Slim\Interfaces\CallableResolverInterface;
use Slim\Interfaces\MiddlewareDispatcherInterface;
use Slim\Interfaces\RouteCollectorInterface;
use Slim\Interfaces\RouteResolverInterface;
use Slim\Middleware\BodyParsingMiddleware;
use Slim\Middleware\ErrorMiddleware;
use Slim\Middleware\RoutingMiddleware;
use Slim\Routing\RouteCollectorProxy;

class App extends RouteCollectorProxy implements RequestHandlerInterface
{
    public const VERSION = '4.15.1';

    protected RouteResolverInterface $routeResolver;
    protected MiddlewareDispatcherInterface $middlewareDispatcher;

    public function __construct(
        ResponseFactoryInterface $responseFactory,
        ?ContainerInterface $container = null,
        ?CallableResolverInterface $callableResolver = null,
        ?RouteCollectorInterface $routeCollector = null,
        ?RouteResolverInterface $routeResolver = null,
        ?MiddlewareDispatcherInterface $middlewareDispatcher = null
    );

    public function getRouteResolver(): RouteResolverInterface;
    public function getMiddlewareDispatcher(): MiddlewareDispatcherInterface;
    public function add($middleware): self;
    public function addMiddleware(MiddlewareInterface $middleware): self;
    public function addRoutingMiddleware(): RoutingMiddleware;
    public function addErrorMiddleware(
        bool $displayErrorDetails,
        bool $logErrors,
        bool $logErrorDetails,
        ?LoggerInterface $logger = null
    ): ErrorMiddleware;
    public function addBodyParsingMiddleware(array $bodyParsers = []): BodyParsingMiddleware;
    public function run(?ServerRequestInterface $request = null): void;
    public function handle(ServerRequestInterface $request): ResponseInterface;
}

定数・プロパティ (Slim\App)#

コンストラクタ・メソッド一覧 (Slim\App)#

(親クラスから継承される get(), post(), put(), delete(), options(), patch(), any(), map(), group(), redirect(), getBasePath(), setBasePath(), getResponseFactory(), getCallableResolver(), getContainer(), getRouteCollector() の詳細は Slim\Routing\RouteCollectorProxy を参照してください。)

from drawlib.canvas import save, setup
from drawlib.diagrams.sequence import Participant, PhosphorIcon, SequenceDiagram
from drawlib.styles import Styles

setup(width=144, height=96)

sd = SequenceDiagram(
    node_style=Styles.Dark,
    node_text_style=Styles.DarkBold.patch(text_size=10.0),
    edge_style=Styles.Dark.patch(line_width=1.4),
    edge_text_style=Styles.Dark.patch(text_size=9.5),
    node_card_style=Styles.Neutral,
    col_width=34.0,
    step_y=6.5,
)

p_client = sd.add(Participant("index.php", icon=PhosphorIcon.FILE_CODE, width=24, card_style=Styles.PrimaryNeutral))
p_app = sd.add(
    Participant(
        "Slim\\App",
        icon=PhosphorIcon.CPU,
        width=24,
        style=Styles.White,
        text_style=Styles.WhiteBold.patch(text_size=10.0),
        card_style=Styles.PrimaryFlat,
    )
)
p_mw = sd.add(Participant("MiddlewareDispatcher", icon=PhosphorIcon.STACK, width=28, card_style=Styles.SecondaryNeutral))
p_emit = sd.add(Participant("ResponseEmitter", icon=PhosphorIcon.BROADCAST, width=26, card_style=Styles.Neutral))

p_client.request(p_app, "1. run(request = null)")
p_app.request(p_app, "2. createServerRequestFromGlobals()")
p_app.request(p_mw, "3. handle(ServerRequestInterface)")
p_mw.reply(p_app, "4. ResponseInterface (LIFO + RouteRunner)")
p_app.request(p_app, "5. If HEAD -> withBody(emptyStream)")
p_app.request(p_emit, "6. emit(response): headers, status, body")
p_emit.reply(p_client, "7. Stream HTTP Response to SAPI")

sd.draw(xy=(72, 48), align="center")
save()

使用例 (Slim\App)#

<?php

declare(strict_types=1);

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Factory\AppFactory;

$app = AppFactory::create();

// 1. JSON / form / XML リクエストボディの自動パースミドルウェア
$app->addBodyParsingMiddleware();

// 2. ルーティングミドルウェアの明示配置（RouteContext を参照するミドルウェアより内側に配置）
$app->addRoutingMiddleware();

// 3. エラーハンドリングミドルウェア（最後に追加＝LIFO で最も外側の層として実行）
$errorMiddleware = $app->addErrorMiddleware(true, true, true);

$app->get('/health', function (Request $request, Response $response): Response {
    $payload = json_encode(['status' => 'ok', 'slim' => $this::VERSION], JSON_THROW_ON_ERROR);
    $response->getBody()->write($payload);
    return $response->withHeader('Content-Type', 'application/json');
});

$app->run();

classSlim\Factory\AppFactory#

• ソースファイル: Slim/Factory/AppFactory.php
• 名前空間: Slim\Factory

AppFactory は、ResponseFactoryInterface を手動でインスタンス化することなく Slim\App を構築できる静的ビルダクラスです。AppFactory::create() または AppFactory::createFromContainer($container) を呼び出すと、静的プロパティ・PSR-11 コンテナ・Psr17FactoryProvider の優先順位リストから利用可能な PSR-17 実装を自動検出し、slim/http がインストールされている場合は Slim\Http\Factory\DecoratedResponseFactory で自動装飾します。

PHP クラスシグネチャ (Slim\Factory\AppFactory)#

namespace Slim\Factory;

use Psr\Container\ContainerInterface;
use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Message\StreamFactoryInterface;
use RuntimeException;
use Slim\App;
use Slim\Interfaces\CallableResolverInterface;
use Slim\Interfaces\MiddlewareDispatcherInterface;
use Slim\Interfaces\Psr17FactoryProviderInterface;
use Slim\Interfaces\RouteCollectorInterface;
use Slim\Interfaces\RouteResolverInterface;

class AppFactory
{
    protected static ?Psr17FactoryProviderInterface $psr17FactoryProvider = null;
    protected static ?ResponseFactoryInterface $responseFactory = null;
    protected static ?StreamFactoryInterface $streamFactory = null;
    protected static ?ContainerInterface $container = null;
    protected static ?CallableResolverInterface $callableResolver = null;
    protected static ?RouteCollectorInterface $routeCollector = null;
    protected static ?RouteResolverInterface $routeResolver = null;
    protected static ?MiddlewareDispatcherInterface $middlewareDispatcher = null;
    protected static bool $slimHttpDecoratorsAutomaticDetectionEnabled = true;

    public static function create(
        ?ResponseFactoryInterface $responseFactory = null,
        ?ContainerInterface $container = null,
        ?CallableResolverInterface $callableResolver = null,
        ?RouteCollectorInterface $routeCollector = null,
        ?RouteResolverInterface $routeResolver = null,
        ?MiddlewareDispatcherInterface $middlewareDispatcher = null
    ): App;

    public static function createFromContainer(ContainerInterface $container): App;
    public static function determineResponseFactory(): ResponseFactoryInterface;

    protected static function attemptResponseFactoryDecoration(
        ResponseFactoryInterface $responseFactory,
        StreamFactoryInterface $streamFactory
    ): ResponseFactoryInterface;

    public static function setPsr17FactoryProvider(Psr17FactoryProviderInterface $psr17FactoryProvider): void;
    public static function setResponseFactory(ResponseFactoryInterface $responseFactory): void;
    public static function setStreamFactory(StreamFactoryInterface $streamFactory): void;
    public static function setContainer(ContainerInterface $container): void;
    public static function setCallableResolver(CallableResolverInterface $callableResolver): void;
    public static function setRouteCollector(RouteCollectorInterface $routeCollector): void;
    public static function setRouteResolver(RouteResolverInterface $routeResolver): void;
    public static function setMiddlewareDispatcher(MiddlewareDispatcherInterface $middlewareDispatcher): void;
    public static function setSlimHttpDecoratorsAutomaticDetection(bool $enabled): void;
}

静的メソッド一覧 (Slim\Factory\AppFactory)#

使用例 (Slim\Factory\AppFactory)#

<?php

declare(strict_types=1);

use DI\Container;
use Slim\Factory\AppFactory;

// パターン A: 静的セッターで DI コンテナを設定してから create() を呼び出す
$container = new Container();
AppFactory::setContainer($container);
AppFactory::setSlimHttpDecoratorsAutomaticDetection(false);
$app = AppFactory::create();

// パターン B: コンテナ内のインターフェース定義から App を一括構築する
$appFromDi = AppFactory::createFromContainer($container);

classSlim\Factory\ServerRequestCreatorFactory#

• ソースファイル: Slim/Factory/ServerRequestCreatorFactory.php
• 名前空間: Slim\Factory

ServerRequestCreatorFactory は、PHP のスーパーグローバル変数から PSR-7 ServerRequestInterface を生成する ServerRequestCreatorInterface を構築する静的ファクトリです。App::run() にリクエストオブジェクトが渡されなかった際に内部で呼び出され、Psr17FactoryProvider から利用可能なベンダー実装を検出し、slim/http が存在する場合は SlimHttpServerRequestCreator で装飾します。

PHP クラスシグネチャ (Slim\Factory\ServerRequestCreatorFactory)#

namespace Slim\Factory;

use RuntimeException;
use Slim\Interfaces\Psr17FactoryProviderInterface;
use Slim\Interfaces\ServerRequestCreatorInterface;

class ServerRequestCreatorFactory
{
    protected static ?Psr17FactoryProviderInterface $psr17FactoryProvider = null;
    protected static ?ServerRequestCreatorInterface $serverRequestCreator = null;
    protected static bool $slimHttpDecoratorsAutomaticDetectionEnabled = true;

    public static function create(): ServerRequestCreatorInterface;
    public static function determineServerRequestCreator(): ServerRequestCreatorInterface;

    protected static function attemptServerRequestCreatorDecoration(
        ServerRequestCreatorInterface $serverRequestCreator
    ): ServerRequestCreatorInterface;

    public static function setPsr17FactoryProvider(Psr17FactoryProviderInterface $psr17FactoryProvider): void;
    public static function setServerRequestCreator(ServerRequestCreatorInterface $serverRequestCreator): void;
    public static function setSlimHttpDecoratorsAutomaticDetection(bool $enabled): void;
}

静的メソッド一覧 (Slim\Factory\ServerRequestCreatorFactory)#

使用例 (Slim\Factory\ServerRequestCreatorFactory)#

<?php

declare(strict_types=1);

use Slim\Factory\AppFactory;
use Slim\Factory\ServerRequestCreatorFactory;

// スーパーグローバルから PSR-7 ServerRequest を手動生成して handle() に渡す
$creator = ServerRequestCreatorFactory::create();
$request = $creator->createServerRequestFromGlobals();

$app = AppFactory::create();
$response = $app->handle($request);

classSlim\CallableResolver#

• ソースファイル: Slim/CallableResolver.php
• 名前空間: Slim
• 修飾子: final class
• 実装インターフェース: Slim\Interfaces\AdvancedCallableResolverInterface（CallableResolverInterface を継承）
• ジェネリクス注釈: @template TContainerInterface of (ContainerInterface|null)

CallableResolver は、ルートやミドルウェアに指定された多様な Callable 表現を実行可能な PHP callable に解決するクラスです。

1. 標準の PHP callable（Closure、関数名、Invokable オブジェクト、[$object, 'method']）。
2. [ClassName::class, 'method'] 形式の配列（内部で 'ClassName:method' へ正規化）。
3. Slim 独自のコロン記法 'ClassName:method'（正規表現 CallableResolver::$callablePattern で解析）。
4. PSR-11 コンテナにサービス ID が登録されていれば $this->container->get($class) から取得し、未登録であれば new $class($this->container) でインスタンス化。
5. メソッド省略時の既定メソッド補完：resolveRoute() は RequestHandlerInterface に対して 'handle'、resolveMiddleware() は MiddlewareInterface に対して 'process'、resolve() は '__invoke' を補完。
6. クロージャのバインド：$this->container が存在し解決結果が Closure の場合、$callable->bindTo($this->container) によりクロージャ内の $this をコンテナへバインド。

PHP クラスシグネチャ (Slim\CallableResolver)#

namespace Slim;

use Psr\Container\ContainerInterface;
use Slim\Interfaces\AdvancedCallableResolverInterface;

final class CallableResolver implements AdvancedCallableResolverInterface
{
    public static string $callablePattern = '!^([^\:]+)\:([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)$!';

    private ?ContainerInterface $container;

    public function __construct(?ContainerInterface $container = null);
    public function resolve($toResolve): callable;
    public function resolveRoute($toResolve): callable;
    public function resolveMiddleware($toResolve): callable;
}

プロパティ・メソッド一覧 (Slim\CallableResolver)#

使用例 (Slim\CallableResolver)#

<?php

declare(strict_types=1);

use Slim\CallableResolver;

$resolver = new CallableResolver($container);

// 'Class:method' 記法、[Class::class, 'method'] 配列、PSR-15 ハンドラをすべて callable に解決
$routeCallable = $resolver->resolveRoute('App\Action\UserListAction:index');
$handlerCallable = $resolver->resolveRoute(\App\Action\SingleActionHandler::class); // -> [$instance, 'handle']
$mwCallable = $resolver->resolveMiddleware(\App\Middleware\AuthMiddleware::class); // -> [$instance, 'process']

classSlim\MiddlewareDispatcher#

• ソースファイル: Slim/MiddlewareDispatcher.php
• 名前空間: Slim
• 実装インターフェース: Slim\Interfaces\MiddlewareDispatcherInterface（Psr\Http\Server\RequestHandlerInterface を継承）
• ジェネリクス注釈: @template TContainerInterface of (ContainerInterface|null)

MiddlewareDispatcher は、Slim 4 の同心円 LIFO（Last-In, First-Out：後入れ先出し） ミドルウェアスタックを実装します。中心の RequestHandlerInterface $kernel（アプリケーション全体では RouteRunner、個別ルートでは Route）を起点として、add(), addMiddleware(), addDeferred(), addCallable() が呼ばれるたびに現在の $this->tip を $next として包む匿名 RequestHandlerInterface で $this->tip を更新します。

PHP クラスシグネチャ (Slim\MiddlewareDispatcher)#

namespace Slim;

use Psr\Container\ContainerInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Slim\Interfaces\CallableResolverInterface;
use Slim\Interfaces\MiddlewareDispatcherInterface;

class MiddlewareDispatcher implements MiddlewareDispatcherInterface
{
    protected RequestHandlerInterface $tip;
    protected ?CallableResolverInterface $callableResolver;
    protected ?ContainerInterface $container;

    public function __construct(
        RequestHandlerInterface $kernel,
        ?CallableResolverInterface $callableResolver = null,
        ?ContainerInterface $container = null
    );

    public function seedMiddlewareStack(RequestHandlerInterface $kernel): void;
    public function handle(ServerRequestInterface $request): ResponseInterface;
    public function add($middleware): MiddlewareDispatcherInterface;
    public function addMiddleware(MiddlewareInterface $middleware): MiddlewareDispatcherInterface;
    public function addDeferred(string $middleware): self;
    public function addCallable(callable $middleware): self;
}

コンストラクタ・メソッド一覧 (Slim\MiddlewareDispatcher)#

使用例 (Slim\MiddlewareDispatcher)#

<?php

declare(strict_types=1);

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Psr\Http\Server\RequestHandlerInterface as RequestHandler;

// LIFO 順序: 後から追加した OuterAuthMiddleware が先に実行される
$app->add(function (Request $request, RequestHandler $handler): Response {
    $response = $handler->handle($request->withAttribute('inner', true));
    return $response->withHeader('X-Inner-Middleware', '1');
});

$app->add('App\Middleware\OuterAuthMiddleware'); // handle() 実行時に遅延解決

classSlim\ResponseEmitter#

• ソースファイル: Slim/ResponseEmitter.php
• 名前空間: Slim

ResponseEmitter は、PSR-7 ResponseInterface を PHP SAPI の標準出力へ送出するクラスです。実運用上の HTTP エッジケースに対応する 3 つの重要な保護機構を備えています。

1. 複数 Set-Cookie ヘッダの保護: emitHeaders() では通常ヘッダは初回のみ置換（$first = true）しますが、strtolower($name) !== 'set-cookie' の判定により Set-Cookie ヘッダは常に上書きせず追記送出します。
2. ヘッダ送出後のステータス行設定: PHP の header('Location: ...') がステータスコードを勝手に 302 へ書き換える挙動（Issue #1730）を防ぐため、emitHeaders() の後に emitStatusLine() を実行します。
3. 空レスポンス判定とチャンク送出: isResponseEmpty() により 204, 205, 304 または空ストリーム時はボディ送出をスキップし、emitBody() では $responseChunkSize（既定 4096 バイト）単位でストリームを読み出し、connection_status() !== CONNECTION_NORMAL となった時点で安全に中断します。

PHP クラスシグネチャ (Slim\ResponseEmitter)#

namespace Slim;

use Psr\Http\Message\ResponseInterface;

class ResponseEmitter
{
    private int $responseChunkSize;

    public function __construct(int $responseChunkSize = 4096);
    public function emit(ResponseInterface $response): void;
    public function isResponseEmpty(ResponseInterface $response): bool;
}

コンストラクタ・メソッド一覧 (Slim\ResponseEmitter)#

使用例 (Slim\ResponseEmitter)#

<?php

declare(strict_types=1);

use Slim\Factory\AppFactory;
use Slim\Factory\ServerRequestCreatorFactory;
use Slim\ResponseEmitter;

$app = AppFactory::create();
$request = ServerRequestCreatorFactory::create()->createServerRequestFromGlobals();
$response = $app->handle($request);

// 8 KB チャンクでレスポンスを送出
$emitter = new ResponseEmitter(8192);
$emitter->emit($response);

classSlim\Logger#

• ソースファイル: Slim/Logger.php
• 名前空間: Slim
• 継承クラス: Psr\Log\AbstractLogger（Psr\Log\LoggerInterface を実装）

Slim\Logger は、App::addErrorMiddleware() や ErrorMiddleware に外部の Psr\Log\LoggerInterface が渡されなかった場合に ErrorHandler がデフォルトで使用する軽量な PSR-3 ロガー実装です。Psr\Log\AbstractLogger から全ログレベルメソッド（emergency(), alert(), critical(), error(), warning(), notice(), info(), debug()）を継承し、すべてのメッセージを error_log((string) $message) へ出力します。

PHP クラスシグネチャ (Slim\Logger)#

namespace Slim;

use Psr\Log\AbstractLogger;
use Psr\Log\InvalidArgumentException;
use Stringable;

class Logger extends AbstractLogger
{
    /**
     * @param mixed             $level
     * @param string|Stringable $message
     * @param array<mixed>      $context
     *
     * @throws InvalidArgumentException
     */
    public function log($level, $message, array $context = []): void;
}

メソッド一覧 (Slim\Logger)#

使用例 (Slim\Logger)#

<?php

declare(strict_types=1);

use Slim\Logger;

$logger = new Logger();
$logger->error('Unhandled exception in checkout pipeline');