Download the PHP package tourze/psr15-static-file-request-handler without Composer

PSR-15 Static File Request Handler

中文

A PSR-15 compatible request handler for serving static files efficiently in PHP applications. Supports cache headers, range requests, directory index, and MIME type detection.

Features

• PSR-15 compatible static file request handler
• Supports directory index (index.html, index.htm)
• MIME type auto-detection using league/mime-type-detection
• HTTP cache support (ETag, Last-Modified, 304 Not Modified)
• Range requests (partial content, 206)
• Prevents serving PHP files for security
• Easy integration with any PSR-15 middleware stack

Installation

Install via Composer:

Dependencies

Requirements:

• PHP >= 8.1
• Composer

Dependencies:

• psr/http-message - PSR-7 HTTP message interfaces
• psr/http-server-handler - PSR-15 HTTP handlers
• league/mime-type-detection - MIME type detection
• nyholm/psr7 - PSR-7 implementation
• symfony/filesystem - File system operations

Quick Start

Example: Handling Range Requests

Documentation

Public API

• Constructor: StaticFileRequestHandler::__construct(string $publicPath, ?Filesystem $filesystem = null)
• Handler method: handle(ServerRequestInterface $request): ResponseInterface

Response Codes

• 200 OK: File found and served successfully
• 206 Partial Content: Range request served successfully
• 304 Not Modified: File not modified (cache hit)
• 404 Not Found: File does not exist
• 416 Range Not Satisfiable: Invalid range request
• 500 Internal Server Error: File read error

Configuration

• publicPath: The root directory for static files
• Optionally pass a Symfony Filesystem instance

Advanced Usage

Custom Filesystem Integration

Middleware Integration

Cache Headers

The handler automatically sets cache headers:

• ETag for cache validation
• Last-Modified for conditional requests
• Cache-Control: public, max-age=86400 for browser caching

Range Request Support

Supports HTTP range requests for:

• Large file downloads
• Video streaming
• Progressive loading

Directory Index

Automatically serves index files:

• index.html (preferred)
• index.htm (fallback)

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request

Coding Style: PSR-12

Testing:

License

MIT License. See LICENSE for details.

Changelog

See Releases for version history and upgrade notes.