php-psr

This PHP extension provides the interfaces from the PSR standards as established by the PHP-FIG group. You can use interfaces provided by this extension in another extension easily - see this example.

Interfaces

PSR	Reference	Tested against
PSR-3	psr/log *	monolog
PSR-6	psr/cache	psx-cache, laminas-cache
PSR-7	psr/http-message	guzzle/psr7
PSR-11	psr/container	league/container
PSR-13	psr/link	php-fig/link-util
PSR-14	psr/event-dispatcher	tukio
PSR-15	psr/http-server-handler	equip/dispatch
PSR-15	psr/http-server-middleware	middleware/request-handler
PSR-16	psr/simple-cache	psx-cache, laminas-cache
PSR-17	psr/http-factory	http-interop/http-factory-guzzle
PSR-18	psr/http-client	ricardofiorani/guzzle-psr18-adapter

Installation

Linux / macOS

Prerequisite packages are:

PHP development headers and tools
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.

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:

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:

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 install psr

or by downloading a DLL from PECL or windows.php.net and placing it in the appropriate directory.

Nix / NixOS

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

with a custom version of PHP:

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

or, in a .nix file:

(import <nixpkgs> {}).callPackage (import (fetchTarball {
  url = https://github.com/jbboehr/php-psr/archive/v1.0.0.tar.gz;
  sha256 = "12237b392rz224r4d8p6pwnldpl2bfrvpcim5947avjd49sn8ss4";
})) {}

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).

{
    "name": "sample/app",
    "require": {
        "ext-psr": "*"
    },
    "provide": {
        "psr/log": "^1",
        "psr/cache": "^1",
        "psr/http-message": "^1",
        "psr/container": "^1",
        "psr/link": "^1",
        "psr/event-dispatcher": "^1",
        "psr/http-server-handler": "^1",
        "psr/http-server-middleware": "^1",
        "psr/simple-cache": "^1",
        "psr/http-factory": "^1",
        "psr/http-client": "^1"
    },
}

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

Credits

@sergeyklay - Appveyor and documentation improvements
@flyinghail - PSR-14, PSR-15, PSR-17, and PSR-18 support
@Jan-E - Original appveyor template
All Contributors

License

This project is open source software licensed under the Simplified BSD License. See the LICENSE.md file for more information.

godhelpjun / php-psr