Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jbboehr/php-psr

PHP extension providing the accepted PSR interfaces
https://github.com/jbboehr/php-psr

c deus-vult php php-extension php-extensions php-fig php8 psr

Last synced: 4 days ago
JSON representation

PHP extension providing the accepted PSR interfaces

Host: GitHub
URL: https://github.com/jbboehr/php-psr
Owner: jbboehr
License: other
Created: 2015-05-03T00:33:02.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-10-07T11:59:36.000Z (3 months ago)
Last Synced: 2024-12-16T07:04:39.372Z (11 days ago)
Topics: c, deus-vult, php, php-extension, php-extensions, php-fig, php8, psr
Language: C
Homepage:
Size: 658 KB
Stars: 232
Watchers: 20
Forks: 32
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md

Awesome Lists containing this project

README

        
# php-psr

[![GitHub Build Status](https://github.com/jbboehr/php-psr/workflows/ci/badge.svg)](https://github.com/jbboehr/php-psr/actions?query=workflow%3Aci)

[![GitHub Windows Build Status](https://github.com/jbboehr/php-psr/workflows/windows/badge.svg)](https://github.com/jbboehr/php-psr/actions?query=workflow%3Awindows)

[![Appveyor Build Status][:badge-appveyor:]][:build-appveyor:]

[![Coverage Status][:badge-coveralls:]][:build-coveralls:]

[![License][:badge-license:]][:ext-license:]

This PHP extension provides the interfaces from the [PSR][:psr-fig:] standards as established by the [PHP-FIG][:php-fig:] group.

You can use interfaces provided by this extension in another extension easily - see this [example][:example:].

As of v1.2 of the extension, classes are defined in the `PsrExt` namespace and aliased into the `Psr` namespace.

## Interfaces

| PSR | Reference | 

| --- | --- |

| [PSR-3] | [psr/log] [*](#psrlogunimpl) | 

| [PSR-6] | [psr/cache] | 

| [PSR-7] | [psr/http-message] | 

| [PSR-11] | [psr/container] | 

| [PSR-13] | [psr/link] | 

| [PSR-14] | [psr/event-dispatcher] | 

| [PSR-15] | [psr/http-server-handler] | 

| [PSR-15] | [psr/http-server-middleware] | 

| [PSR-16] | [psr/simple-cache] | 

| [PSR-17] | [psr/http-factory] | 

| [PSR-18] | [psr/http-client] | 

## Installation

### Linux / macOS

Prerequisite packages are:

- PHP development headers and tools, `php` >= 7.3

- `gcc` >= 4.4 | `clang` >= 3.x | `vc` >= 11

- GNU `make` >= 3.81

- `automake`

- `autoconf`

You will need the PHP development headers. If PHP was manually installed, these should be available by default. Otherwise, you will need to fetch them from a repository.

```bash

git clone https://github.com/jbboehr/php-psr.git

cd php-psr

phpize

./configure

make

make test

sudo make install

```

If you have specific PHP versions running:

```bash

git clone https://github.com/jbboehr/php-psr.git

cd php-psr

/usr/local/bin/phpize

./configure --with-php-config=/usr/local/bin/php-config

make

make test

sudo make install

```

Add the extension to your *php.ini*:

```ini

echo extension=psr.so | tee -a /path/to/your/php.ini

```

Finally, _restart the web server_.

### PECL / Windows

You may also be able to install this extension via [PECL][:pecl-psr:]:

```bash

pecl install psr

```

or by downloading a DLL from [PECL][:pecl-psr:] or [windows.php.net][:windows-psr:] and placing it in the appropriate directory.

### Nix / NixOS

```bash

nix-env -i -f https://github.com/jbboehr/php-psr/archive/master.tar.gz

```

with a custom version of PHP:

```bash

nix-env -i -f https://github.com/jbboehr/php-psr/archive/master.tar.gz --arg php '(import  {}).php71'

```

or, in a `.nix` file:

```nix

(import  {}).callPackage (import (fetchTarball {

  url = https://github.com/jbboehr/php-psr/archive/v1.2.0.tar.gz;

  sha256 = "1c4jc09d46ac43kkckil8l76is973czwp0g6vhpnv5105l7z3zgi";

})) {}

```

### Using with composer

In your project, you can prevent the installation of the unnecessary composer packages provided by this extension by adding the following to your `composer.json`. You will need to make sure the extension is installed and enabled in your PHP configuration. You may also want to consider leaving them installed to provide stubs to your IDE. This configuration is not suitable for a library published to packagist.

Note: `LoggerInterfaceTest` and `TestLogger` from `psr/log` are not implemented. If you use these classes, you should keep `psr/log` installed ([discussion](https://github.com/jbboehr/php-psr/issues/57)).

```json

{

    "name": "sample/app",

    "require": {

        "ext-psr": "*"

    },

    "provide": {

        "psr/log": "1.0.0",

        "psr/cache": "1.0.0",

        "psr/http-message": "1.0.0",

        "psr/container": "1.1.1",

        "psr/link": "1.0.0",

        "psr/event-dispatcher": "1.0.0",

        "psr/http-server-handler": "1.0.0",

        "psr/http-server-middleware": "1.0.0",

        "psr/simple-cache": "1.0.0",

        "psr/http-factory": "1.0.0",

        "psr/http-client": "1.0.0"

    },

}

```

This will use this PHP extension instead of downloading from packagist.

## Credits

* [@sergeyklay][:github-sergeyklay:] - Appveyor and documentation improvements

* [@flyinghail][:github-flyinghail:] - PSR-14, PSR-15, PSR-17, and PSR-18 support

* [@Jan-E][:github-jan-e:] - Original appveyor template

* [All Contributors](https://github.com/jbboehr/php-psr/graphs/contributors)

## License

This project is open source software licensed under the Simplified BSD License.

See the [LICENSE.md][:ext-license:] file for more information.

PSR Interfaces: Copyright (c) 2012-present [PHP Framework Interoperability Group][:php-fig:].

[:psr-fig:]: https://www.php-fig.org/psr

[:php-fig:]: https://www.php-fig.org

[:pecl-psr:]: https://pecl.php.net/package/psr

[:badge-appveyor:]: https://ci.appveyor.com/api/projects/status/x1ymkqggy1mkl0ux/branch/master?svg=true

[:badge-coveralls:]: https://coveralls.io/repos/jbboehr/php-psr/badge.svg?branch=master&service=github

[:badge-license:]: https://img.shields.io/badge/license-BSD-brightgreen.svg

[:build-appveyor:]: https://ci.appveyor.com/project/jbboehr/php-psr/branch/master

[:build-coveralls:]: https://coveralls.io/github/jbboehr/php-psr?branch=master

[:ext-license:]: https://github.com/jbboehr/php-psr/blob/master/LICENSE.md

[:example:]: https://github.com/jbboehr/php-handlebars/blob/v0.7.1/impl.c#L213-L215

[:windows-psr:]: http://windows.php.net/downloads/pecl/releases/psr/

[PSR-3]: http://www.php-fig.org/psr/psr-3

[PSR-6]: https://www.php-fig.org/psr/psr-6

[PSR-7]: https://www.php-fig.org/psr/psr-7

[PSR-11]: https://www.php-fig.org/psr/psr-11

[PSR-13]: https://www.php-fig.org/psr/psr-13

[PSR-14]: http://www.php-fig.org/psr/psr-14

[PSR-15]: http://www.php-fig.org/psr/psr-15

[PSR-16]: https://www.php-fig.org/psr/psr-16

[PSR-17]: https://www.php-fig.org/psr/psr-17

[PSR-18]: https://www.php-fig.org/psr/psr-18

[psr/log]: https://github.com/php-fig/log

[psr/cache]: https://github.com/php-fig/cache

[psr/http-message]: https://github.com/php-fig/http-message

[psr/container]: https://github.com/php-fig/container

[psr/link]: https://github.com/php-fig/link

[psr/simple-cache]: https://github.com/php-fig/simple-cache

[psr/http-server-handler]: https://github.com/php-fig/http-server-handler

[psr/http-server-middleware]: https://github.com/php-fig/http-server-middleware

[psr/http-factory]: https://github.com/php-fig/http-factory

[psr/http-client]: https://github.com/php-fig/http-client

[psr/event-dispatcher]: https://github.com/php-fig/event-dispatcher

[equip/dispatch]: https://github.com/equip/dispatch

[middlewares/request-handler]: https://github.com/middlewares/request-handler

[http-interop/http-factory-guzzle]: https://github.com/http-interop/http-factory-guzzle

[ricardofiorani/guzzle-psr18-adapter]: https://github.com/ricardofiorani/guzzle-psr18-adapter

[monolog/monolog]: https://github.com/Seldaek/monolog

[psx/cache]: https://github.com/apioo/psx-cache

[psx/dependency]: https://github.com/apioo/psx-dependency

[php-fig/link-util]: https://github.com/php-fig/link-util

[crell/tukio]: https://github.com/Crell/Tukio.git

[php-fig/event-dispatcher-util]: https://github.com/php-fig/event-dispatcher-util

[php-fig/cache-util]: https://github.com/php-fig/cache-util

[laminas/laminas-diactoros]: https://github.com/laminas/laminas-diactoros

[php-fig/event-dispatcher-util]: https://github.com/php-fig/event-dispatcher-util

[:github-sergeyklay:]: https://github.com/sergeyklay

[:github-jan-e:]: https://github.com/Jan-E

[:github-flyinghail:]: https://github.com/flyinghail