PHP download

Download the PHP package serjoscha87/php-request-mapper without Composer

On this page you can find all versions of the php package serjoscha87/php-request-mapper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download serjoscha87/php-request-mapper
More information about serjoscha87/php-request-mapper
Files in serjoscha87/php-request-mapper

Vendor serjoscha87
Package php-request-mapper
Short Description auto router / mapper to do the heavy lifting for mapping requests to local fs files
License MIT
Homepage https://github.com/serjoscha87/php-request-mapper

Keywords php auto request mapping auto-router auto request to file mapping

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of serjoscha87/php-request-mapper

Informations about the package php-request-mapper

PHP request-mapper / auto-router / request-to-file-resolver for pretty URLs

[]() []() []()

DOC MOSTLY REMOVED (because it was written for an older approach) - I'M CURRENTLY REWORKING IT <

Implementation examples / tests:

Perhaps those examples render the complete README unnecessary.

https://github.com/serjoscha87/php-request-mapper/tree/tests

Purpose

Ever though that it can not be that hard to reflect pretty-url requets to files on your server's file-system? Well - trying it you will quickly face edge cases that will convince you of the opposite. This requets-mapper does the heavy lifting of reflecting pretty-url request to files on the local filesystem of the server while serving you a configurable abstraction layer. It can handle 404 requests out of the box so you do not have to concern about it.

The lib

Basically renders the need of a php-router for manual route-bindings obsolete
Can simply be dropped in any project to easily add pretty URLs that are automatically reflected to the filesystem

I primarily wrote this for using it within a framework for more or less static websites (not apps) I wrote some time ago. But perhaps this lib can be used beyond its actual purpose.

Installation

composer require serjoscha87/php-request-mapper

.htaccess

For Apache Webservers:

the all known 'wordpress' rewrite rule which rewrites all requests to things that do not physically exist to index.php:

Nginx rewrites requests to the index.php by default - no extra rules needed.

Requirements

PHP8+ (because the lib makes use of named arguments and array unpacking)

Simple usage Example

filesystem:

(of course the level of dir-nesting is not limited by the request-mapper)

Examples for better understanding what the request mapper does for you

considering the filesys structure given above (see "Simple usage Example"):

Request to: /test -> will deliver the content of pages/test.php
Request to: /quxx -> will deliver the content of pages/404.php (because there is no quxx.php in the pages dir)
Request to: / -> will deliver the content of pages/home.php
Request to: /home -> the requestmapper will tell you that a redirect to / is required (through CurrentRequest::needsRedirect() - you can use CurrentRequest::getRedirectUri() to get the redirect target)
Request to: /foobar/foobar -> the requestmapper will tell you that a redirect to /foobar is required (see above)
Request to: /foobar -> will deliver the content of pages/foobar/foobar.php
Request to: /foobar/detail/something -> will deliver the content of pages/foobar/detail.php and will pass everything after /detail to the php file
Request to: /foobar/abc -> like seen before ... nothing special. Will deliver the content pages/foobar/abc.php

misc

This lib also works perfectly fine with great template engines / implementations like BladeOne

All versions of php-request-mapper with dependencies

PHP Build Version

Package Version

Version 3.0 Release 10. Jul 2024
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of php-request-mapper from vendor serjoscha87

Requires php Version >=8.0

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package serjoscha87/php-request-mapper contains the following files

Loading the files please wait ....