amphp / http-server-static-content
Static content request handler for Amp's HTTP server.
Fund package maintenance!
amphp
Installs: 28 230
Dependents: 16
Suggesters: 0
Security: 0
Stars: 22
Watchers: 7
Forks: 12
Open Issues: 1
Requires
- php: >=8.1
- amphp/amp: ^3
- amphp/byte-stream: ^2
- amphp/cache: ^2
- amphp/file: ^3
- amphp/http: ^2
- amphp/http-server: ^3
- amphp/pipeline: ^1
- revolt/event-loop: ^1
Requires (Dev)
- amphp/http-server-router: ^2
- amphp/log: ^2
- amphp/php-cs-fixer-config: ^2
- amphp/phpunit-util: ^3
- danielmiessler/sec-lists: 2022.4
- phpunit/phpunit: ^9
- psalm/phar: ^5.6
This package is auto-updated.
Last update: 2024-10-23 09:58:27 UTC
README
AMPHP is a collection of event-driven libraries for PHP designed with fibers and concurrency in mind. This package provides an HTTP server plugin to serve static files like HTML, CSS, JavaScript, and images effortlessly.
Installation
This package can be installed as a Composer dependency.
composer require amphp/http-server-static-content
Usage
This package provides two RequestHandler
implementations:
DocumentRoot
: Serves all files within a directory.StaticResource
: Serves a single specific file.
The example below combines static file serving and request routing to demonstrate how they work well together:
<?php use Amp\Http\Server\DefaultErrorHandler; use Amp\Http\Server\RequestHandler\ClosureRequestHandler; use Amp\Http\Server\Response; use Amp\Http\Server\SocketHttpServer; use Amp\Http\Server\StaticContent\DocumentRoot; use Amp\Http\Status; $router = new Amp\Http\Server\Router; // $server is an instance of HttpServer and $errorHandler an instance of ErrorHandler $router->setFallback(new DocumentRoot($server, $errorHandler, __DIR__ . '/public')); $router->addRoute('GET', '/', new ClosureRequestHandler(function () { return new Response(Status::OK, ['content-type' => 'text/plain'], 'Hello, world!'); })); $server->start($router, new DefaultErrorHandler());
A full example is found in examples/server.php
.
Contributing
Please read our rules for details on our code of conduct, and the process for submitting pull requests to us.
Security
If you discover any security related issues, please use the private security issue reporter instead of using the public issue tracker.
License
The MIT License (MIT). Please see LICENSE for more information.